Doc: clarify the default collation behavior of domains.
authorTom Lane <[email protected]>
Tue, 14 Jun 2022 21:47:09 +0000 (17:47 -0400)
committerTom Lane <[email protected]>
Tue, 14 Jun 2022 21:47:09 +0000 (17:47 -0400)
The previous wording was "the underlying data type's default collation
is used", which is wrong or at least misleading.  The domain inherits
the base type's collation behavior, which if "default" actually can
mean that we use some non-default collation obtained from elsewhere.

Per complaint from Jian He.

Discussion: https://postgr.es/m/CACJufxHMR8_4WooDPjjvEdaxB2hQ5a49qthci8fpKP0MKemVRQ@mail.gmail.com

doc/src/sgml/ref/create_domain.sgml

index 81a89249260764eea7634c8124ae71581e91dae8..e4b856d630cdbde604427e76b2234be3cd3efb9f 100644 (file)
@@ -94,7 +94,8 @@ CREATE DOMAIN <replaceable class="parameter">name</replaceable> [ AS ] <replacea
       <listitem>
        <para>
         An optional collation for the domain.  If no collation is
-        specified, the underlying data type's default collation is used.
+        specified, the domain has the same collation behavior as its
+        underlying data type.
         The underlying type must be collatable if <literal>COLLATE</literal>
         is specified.
        </para>