Commit 1bf946bd authored by Thomas Munro's avatar Thomas Munro

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
parent 40972336
......@@ -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.
</para>
<para>
When using Windows collations, version information is only available for
collations defined with BCP 47 language tags such as
<literal>en-US</literal>. Currently, <command>initdb</command> selects
a default locale using a traditional Windows language and country
string such as <literal>English_United States.1252</literal>. The
<literal>--lc-collate</literal> option can be used to provide an explicit
locale name in BCP 47 format.
</para>
</note>
</sect2>
</sect1>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment