From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Sun, 29 Jan 2012 01:54:56 +0000 (-0500)
Subject: Update statement about sorting of character-string data.
X-Git-Tag: REL9_2_BETA1~511
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=17d3233e1bfd9fbe856f032a542f2c595e79ca01;p=postgresql

Update statement about sorting of character-string data.

The sort order is no longer fixed at database creation time, but can be
controlled via COLLATE.  Noted by Thomas Kellerer.
---

diff --git a/doc/src/sgml/ref/select.sgml b/doc/src/sgml/ref/select.sgml
index 39fc6b6d83..01c0104624 100644
--- a/doc/src/sgml/ref/select.sgml
+++ b/doc/src/sgml/ref/select.sgml
@@ -1050,8 +1050,13 @@ SELECT name FROM distributors ORDER BY code;
    </para>
 
    <para>
-    Character-string data is sorted according to the locale-specific
-    collation order that was established when the database was created.
+    Character-string data is sorted according to the collation that applies
+    to the column being sorted.  That can be overridden at need by including
+    a <literal>COLLATE</> clause in the
+    <replaceable class="parameter">expression</replaceable>, for example
+    <literal>ORDER BY mycolumn COLLATE "en_US"</>.
+    For more information see <xref linkend="sql-syntax-collate-exprs"> and
+    <xref linkend="collation">.
    </para>
   </refsect2>