From 1bf946bd43e545b86e567588b791311fe4e36a8c Mon Sep 17 00:00:00 2001 From: Thomas Munro Date: Fri, 16 Apr 2021 13:20:58 +1200 Subject: [PATCH] Doc: Document known problem with Windows collation versions. Warn users that locales with traditional Windows NLS names like "English_United States.1252" won't provide version information, and that something like initdb --lc-collate=en-US would be needed to fix that problem for the initial template databases. Discussion: https://postgr.es/m/CA%2BhUKGJ_hk3rU%3D%3Dg2FpAMChb_4i%2BTJacpjjqFsinY-tRM3FBmA%40mail.gmail.com --- doc/src/sgml/charset.sgml | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/src/sgml/charset.sgml b/doc/src/sgml/charset.sgml index 1b00e543a66..1c673cc1103 100644 --- a/doc/src/sgml/charset.sgml +++ b/doc/src/sgml/charset.sgml @@ -985,6 +985,15 @@ CREATE COLLATION ignore_accents (provider = icu, locale = 'und-u-ks-level1-kc-tr approach is imperfect as maintainers are free to back-port newer collation definitions to older C library releases. + + When using Windows collations, version information is only available for + collations defined with BCP 47 language tags such as + en-US. Currently, initdb selects + a default locale using a traditional Windows language and country + string such as English_United States.1252. The + --lc-collate option can be used to provide an explicit + locale name in BCP 47 format. +