sharpetronics/PostgreSQL
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-06-01 00:01:20 -04:00
Code Issues Projects Releases Wiki Activity

Doc: minor improvements for collation-related man pages.

Browse Source
This commit is contained in:
Tom Lane 2017-06-25 12:27:04 -04:00
parent ddb5fdc068
commit de0c60b7d3
2 changed files with 9 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
doc/src/sgml/ref/alter_collation.sgml
View File

@ -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
<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

4
doc/src/sgml/ref/create_collation.sgml
View File

@ -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>