doc: Remove buggy ICU collation from documentation
authorPeter Eisentraut
Thu, 10 Sep 2020 13:31:09 +0000 (15:31 +0200)
committerPeter Eisentraut
Thu, 10 Sep 2020 13:36:15 +0000 (15:36 +0200)
We have had multiple reports that point to the
'@colReorder=latn-digit' collation customization being buggy.  We have
reported this to ICU and are waiting for a fix.  In the meantime,
remove references to this from the documentation and replace it by
another reordering example.  Apparently, many users have been picking
up this example specifically from the documentation.

Author: Jehan-Guillaume de Rorthais 
Discussion: https://www.postgresql.org/message-id/flat/153201618542.1404.3611626898935613264%40wrigleys.postgresql.org

doc/src/sgml/charset.sgml

index 4c6fa7087977f488377a5c2efc6c6d1b29d0bc8b..70b45f494ef7ff783bc11b9aca02c5cf542c4495 100644 (file)
@@ -789,11 +789,11 @@ CREATE COLLATION german (provider = libc, locale = 'de_DE');
      
 
      
-      CREATE COLLATION digitslast (provider = icu, locale = 'en-u-kr-latn-digit');
-      CREATE COLLATION digitslast (provider = icu, locale = 'en@colReorder=latn-digit');
+      CREATE COLLATION latinlast (provider = icu, locale = 'en-u-kr-grek-latn');
+      CREATE COLLATION latinlast (provider = icu, locale = 'en@colReorder=grek-latn');
       
        
-        Sort digits after Latin letters.  (The default is digits before letters.)
+        Sort Greek letters before Latin ones.  (The default is Latin before Greek.)
        
       
      
@@ -809,9 +809,9 @@ CREATE COLLATION german (provider = libc, locale = 'de_DE');
       
      
 
-     
-      CREATE COLLATION special (provider = icu, locale = 'en-u-kf-upper-kr-latn-digit');
-      CREATE COLLATION special (provider = icu, locale = 'en@colCaseFirst=upper;colReorder=latn-digit');
+    
+      CREATE COLLATION special (provider = icu, locale = 'en-u-kf-upper-kr-grek-latn');
+      CREATE COLLATION special (provider = icu, locale = 'en@colCaseFirst=upper;colReorder=grek-latn');
       
        
         Combines both of the above options.