]> granicus.if.org Git - postgresql/commitdiff
Doc: minor improvements for collation-related man pages.
authorTom Lane <tgl@sss.pgh.pa.us>
Sun, 25 Jun 2017 16:27:04 +0000 (12:27 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Sun, 25 Jun 2017 16:27:04 +0000 (12:27 -0400)
doc/src/sgml/ref/alter_collation.sgml
doc/src/sgml/ref/create_collation.sgml

index 71cf4de802ac9e06d6f9241eb42d3f0868ad8004..30e8c756a128e1e01fcdf6d87d6c595a0ac8fe2b 100644 (file)
@@ -92,7 +92,7 @@ ALTER COLLATION <replaceable>name</replaceable> SET SCHEMA <replaceable>new_sche
     <term><literal>REFRESH VERSION</literal></term>
     <listitem>
      <para>
-      Updated the collation version.
+      Update the collation's version.
       See <xref linkend="sql-altercollation-notes"
       endterm="sql-altercollation-notes-title"> below.
      </para>
@@ -107,16 +107,16 @@ ALTER COLLATION <replaceable>name</replaceable> SET SCHEMA <replaceable>new_sche
   <para>
    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
-   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
    a mismatch, for example:
 <screen>
-WARNING:  ICU collator version mismatch
-DETAIL:  The database was created using version 1.2.3.4, the library 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.
+WARNING:  collation "xx-x-icu" has version mismatch
+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 library version.
 </screen>
    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
    in legitimate circumstances, such as when
    using <command>pg_upgrade</command> to upgrade to server binaries linked
index 47de9a09b69edcf383e2197f76e18b654ce6e15c..2d3e050545c7e018a68cba84f4ac6a916d0553b9 100644 (file)
@@ -122,7 +122,9 @@ CREATE COLLATION [ IF NOT EXISTS ] <replaceable>name</replaceable> FROM <replace
       <para>
        Specifies the provider to use for locale services associated with this
        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.
       </para>
      </listitem>