From: Bruce Momjian <bruce@momjian.us>
Date: Sat, 2 Jul 2016 15:22:35 +0000 (-0400)
Subject: doc: mention dependency on collation libraries
X-Git-Tag: REL9_2_18~42
X-Git-Url: http://git.postgresql.org/gitweb/?a=commitdiff_plain;h=cfb33bc33a233c77571e007102bc4242e402762a;p=postgresql.git

doc: mention dependency on collation libraries

Document that index storage is dependent on the operating system's
collation library ordering, and any change in that ordering can create
invalid indexes.

Discussion: 20160617154311.GB19359@momjian.us

Backpatch-through: 9.1
---

diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index 1045b398ab0..9f22be9fcd0 100644
--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
@@ -183,6 +183,15 @@ postgres$ <userinput>initdb -D /usr/local/pgsql/data</userinput>
    locale setting.  For details see <xref linkend="multibyte">.
   </para>
 
+  <para>
+   Non<literal>C</> and and non-<literal>POSIX</> locales rely on the
+   operating system's collation library for character set ordering.
+   This controls the ordering of keys stored in indexes.  For this reason,
+   a cluster cannot switch to an incompatible collation library version,
+   either through snapshot restore, binary streaming replication, or
+   <application>pg_upgrade</> run.
+  </para>
+
   <sect2 id="creating-cluster-mount-points">
    <title>Use of Secondary File Systems</title>