Commit de0c60b7 authored by Tom Lane's avatar Tom Lane

Doc: minor improvements for collation-related man pages.

parent ddb5fdc0
...@@ -92,7 +92,7 @@ ALTER COLLATION <replaceable>name</replaceable> SET SCHEMA <replaceable>new_sche ...@@ -92,7 +92,7 @@ ALTER COLLATION <replaceable>name</replaceable> SET SCHEMA <replaceable>new_sche
<term><literal>REFRESH VERSION</literal></term> <term><literal>REFRESH VERSION</literal></term>
<listitem> <listitem>
<para> <para>
Updated the collation version. Update the collation's version.
See <xref linkend="sql-altercollation-notes" See <xref linkend="sql-altercollation-notes"
endterm="sql-altercollation-notes-title"> below. endterm="sql-altercollation-notes-title"> below.
</para> </para>
...@@ -107,16 +107,16 @@ ALTER COLLATION <replaceable>name</replaceable> SET SCHEMA <replaceable>new_sche ...@@ -107,16 +107,16 @@ ALTER COLLATION <replaceable>name</replaceable> SET SCHEMA <replaceable>new_sche
<para> <para>
When using collations provided by the ICU library, the ICU-specific version When using collations provided by the ICU library, the ICU-specific version
of the collator is recorded in the system catalog when the collation object of the collator is recorded in the system catalog when the collation object
is created. When the collation is then used, the current version is is created. When the collation is used, the current version is
checked against the recorded version, and a warning is issued when there is checked against the recorded version, and a warning is issued when there is
a mismatch, for example: a mismatch, for example:
<screen> <screen>
WARNING: ICU collator version mismatch WARNING: collation "xx-x-icu" has version mismatch
DETAIL: The database was created using version 1.2.3.4, the library provides version 2.3.4.5. DETAIL: The collation in the database was created using version 1.2.3.4, but the operating system provides version 2.3.4.5.
HINT: Rebuild all objects affected by this collation and run ALTER COLLATION pg_catalog."xx-x-icu" REFRESH VERSION, or build PostgreSQL with the right version of ICU. HINT: Rebuild all objects affected by this collation and run ALTER COLLATION pg_catalog."xx-x-icu" REFRESH VERSION, or build PostgreSQL with the right library version.
</screen> </screen>
A change in collation definitions can lead to corrupt indexes and other A change in collation definitions can lead to corrupt indexes and other
problems where the database system relies on stored objects having a problems because the database system relies on stored objects having a
certain sort order. Generally, this should be avoided, but it can happen certain sort order. Generally, this should be avoided, but it can happen
in legitimate circumstances, such as when in legitimate circumstances, such as when
using <command>pg_upgrade</command> to upgrade to server binaries linked using <command>pg_upgrade</command> to upgrade to server binaries linked
......
...@@ -122,7 +122,9 @@ CREATE COLLATION [ IF NOT EXISTS ] <replaceable>name</replaceable> FROM <replace ...@@ -122,7 +122,9 @@ CREATE COLLATION [ IF NOT EXISTS ] <replaceable>name</replaceable> FROM <replace
<para> <para>
Specifies the provider to use for locale services associated with this Specifies the provider to use for locale services associated with this
collation. Possible values collation. Possible values
are: <literal>icu</literal>,<indexterm><primary>ICU</></> <literal>libc</literal>. are: <literal>icu</literal>,<indexterm><primary>ICU</></>
<literal>libc</literal>.
<literal>libc</literal> is the default.
The available choices depend on the operating system and build options. The available choices depend on the operating system and build options.
</para> </para>
</listitem> </listitem>
......
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