diff --git a/doc/src/sgml/charset.sgml b/doc/src/sgml/charset.sgml index ed84465996..24de689753 100644 --- a/doc/src/sgml/charset.sgml +++ b/doc/src/sgml/charset.sgml @@ -1497,6 +1497,39 @@ SELECT 'x-y' = 'x_y' COLLATE level4; -- false + + Tailoring rules + + The order of individual code points may be changed with tailoring rules, whose syntax is detailed at . + As an example, the following statement sets up a collation named ebcdic with rules to sort US-ASCII characters in the order of the EBCDIC encoding. + +' < '?' +< '`' < ':' < '#' < '@' < \' < '=' < '"' +<*a-r < '~' <*s-z < '^' < '[' < ']' +< '{' <*A-I < '}' <*J-R < '\' <*S-Z <*0-9 +$$); +]]> + +SELECT c FROM (VALUES('a'),('b'),('A'),('B'),('1'),('2'),('!'),('^')) AS x(c) +ORDER BY c COLLATE "ebcdic"; + c +--- + ! + a + b + ^ + A + B + 1 + 2 + + + External References for ICU @@ -1528,6 +1561,11 @@ SELECT 'x-y' = 'x_y' COLLATE level4; -- false + + + Collation customization (tailoring rules) + + diff --git a/doc/src/sgml/ref/create_collation.sgml b/doc/src/sgml/ref/create_collation.sgml index b86a9bbb9c..5003ae7d38 100644 --- a/doc/src/sgml/ref/create_collation.sgml +++ b/doc/src/sgml/ref/create_collation.sgml @@ -165,9 +165,8 @@ CREATE COLLATION [ IF NOT EXISTS ] name FROM Specifies additional collation rules to customize the behavior of the - collation. This is supported for ICU only. See - for details on the syntax. + collation. This is supported for ICU only. + See for details. @@ -261,8 +260,8 @@ CREATE COLLATION german_phonebook (provider = icu, locale = 'de-u-co-phonebk'); V, but is treated as a secondary difference similar to an accent. Rules like this are contained in the locale definitions of some languages. (Of course, if a locale definition already contains the desired - rules, then they don't need to be specified again explicitly.) See the ICU - documentation for further details and examples on the rules syntax. + rules, then they don't need to be specified again explicitly.) See + for further details and examples on the rules syntax. diff --git a/doc/src/sgml/ref/create_database.sgml b/doc/src/sgml/ref/create_database.sgml index b2c8aef1ad..ce7317f81b 100644 --- a/doc/src/sgml/ref/create_database.sgml +++ b/doc/src/sgml/ref/create_database.sgml @@ -232,9 +232,7 @@ CREATE DATABASE name Specifies additional collation rules to customize the behavior of the default collation of this database. This is supported for ICU only. - See - for details on the syntax. + See for details.