On Wed, Aug 31, 2022 at 11:38:33AM +0200, Peter Eisentraut wrote:
> On 30.08.22 22:42, Bruce Momjian wrote:
> > Good question --- the full text is:
> > 
> >       <listitem>
> >        <para>
> >         Record and check the collation of each <link
> >         linkend="sql-createdatabase">database</link> (Peter Eisentraut)
> >        </para>
> > 
> >        <para>
> >         This is designed to detect collation
> >         mismatches to avoid data corruption.  Function
> >         <function>pg_database_collation_actual_version()</function>
> >         reports the underlying operating system collation version, and
> >         <command>ALTER DATABASE ...  REFRESH</command> sets the database
> >         to match the operating system collation version.  DETAILS?
> >        </para>
> >       </listitem>
> > 
> > I just can't figure out what the user needs to understand about this,
> > and I understand very little of it.
> 
> We already had this feature for (schema-level) collations, now we have it on
> the level of the database collation.

Okay, I figured out the interplay between OS collation version support,
collation libraries, and collation levels.  Here is an updated patch for
the release notes.

-- 
  Bruce Momjian  <br...@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Indecision is a decision.  Inaction is an action.  Mark Batterson

diff --git a/doc/src/sgml/release-15.sgml b/doc/src/sgml/release-15.sgml
index e3ab13e53c..dca4550c03 100644
--- a/doc/src/sgml/release-15.sgml
+++ b/doc/src/sgml/release-15.sgml
@@ -578,17 +578,17 @@ Author: Peter Eisentraut <pe...@eisentraut.org>
 
      <listitem>
       <para>
-       Record and check the collation of each <link
+       Record and check the collation version of each <link
        linkend="sql-createdatabase">database</link> (Peter Eisentraut)
       </para>
 
       <para>
-       This is designed to detect collation
+       This is designed to detect collation version
        mismatches to avoid data corruption.  Function
        <function>pg_database_collation_actual_version()</function>
        reports the underlying operating system collation version, and
        <command>ALTER DATABASE ...  REFRESH</command> sets the database
-       to match the operating system collation version.  DETAILS?
+       to match the operating system collation version.
       </para>
      </listitem>
 
@@ -605,9 +605,11 @@ Author: Peter Eisentraut <pe...@eisentraut.org>
       </para>
 
       <para>
-       Previously, <acronym>ICU</acronym> collations could only be
-       specified in <link linkend="sql-createcollation"><command>CREATE
-       COLLATION</command></link> and used with the
+       Previously, only <application>libc</application>-based
+       collations could be set at the cluster and database levels.
+       <acronym>ICU</acronym> collations were previously limited
+       to <link linkend="sql-createcollation"><command>CREATE
+       COLLATION</command></link> and referenced by the
        <literal>COLLATE</literal> clause.
       </para>
      </listitem>

Reply via email to