diff --git a/doc/src/sgml/ref/alter_collation.sgml b/doc/src/sgml/ref/alter_collation.sgml
index 71cf4de802a..30e8c756a12 100644
--- a/doc/src/sgml/ref/alter_collation.sgml
+++ b/doc/src/sgml/ref/alter_collation.sgml
@@ -92,7 +92,7 @@ ALTER COLLATION name SET SCHEMA new_sche
REFRESH VERSION
- Updated the collation version.
+ Update the collation's version.
See below.
@@ -107,16 +107,16 @@ ALTER COLLATION name SET SCHEMA new_sche
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:
-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.
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 pg_upgrade to upgrade to server binaries linked
diff --git a/doc/src/sgml/ref/create_collation.sgml b/doc/src/sgml/ref/create_collation.sgml
index 47de9a09b69..2d3e050545c 100644
--- a/doc/src/sgml/ref/create_collation.sgml
+++ b/doc/src/sgml/ref/create_collation.sgml
@@ -122,7 +122,9 @@ CREATE COLLATION [ IF NOT EXISTS ] name FROM
Specifies the provider to use for locale services associated with this
collation. Possible values
- are: icu,ICU>> libc.
+ are: icu,ICU>>
+ libc.
+ libc is the default.
The available choices depend on the operating system and build options.