doc: more PG 16 relnote wording improvements

1 files changed, 59 insertions, 50 deletions

diff --git a/doc/src/sgml/release-16.sgml b/doc/src/sgml/release-16.sgml
index b71e77fa533..2bb67e9993d 100644
--- a/doc/src/sgml/release-16.sgml
+++ b/doc/src/sgml/release-16.sgml
@@ -253,7 +253,7 @@ Author: David Rowley <drowley@postgresql.org>
 
 <listitem>
 <para>
-Allow incremental sorts in more cases, including DISTINCT (David Rowley)window
+Allow incremental sorts in more cases, including DISTINCT (David Rowley)
 </para>
 </listitem>
 
@@ -981,7 +981,7 @@ Store server variables in a hash table (Tom Lane)
 </para>
 
 <para>
-This allows faster addition of server variables.
+This allows the faster addition of server variables.
 </para>
 </listitem>
 
@@ -992,7 +992,7 @@ Author: Tom Lane <tgl@sss.pgh.pa.us>
 
 <listitem>
 <para>
-Tighten restrictions on what server variables can be reset (Masahiko Sawada)
+Tighten restrictions on which server variables can be reset (Masahiko Sawada)
 </para>
 
 <para>
@@ -1086,7 +1086,7 @@ Allow the postmaster to terminate children with an abort signal (Tom Lane)
 </para>
 
 <para>
-Abort normally creates a core dump.  This is controlled by send_abort_for_crash and send_abort_for_kill.  postmaster -T now the same as setting send_abort_for_crash.
+Abort normally creates a core dump.  This is controlled by send_abort_for_crash and send_abort_for_kill.  postmaster -T is now the same as setting send_abort_for_crash.
 </para>
 </listitem>
 
@@ -1117,89 +1117,97 @@ The number of reserved slots is set by server variable reserved_connections.
 </listitem>
 
 <!--
-Author: Jeff Davis <jdavis@postgresql.org>
-2023-03-10 [c45dc7ffb] initdb: derive encoding from locale for ICU; similar to 
+Author: Thomas Munro <tmunro@postgresql.org>
+2023-04-08 [d4e71df6d] Add io_direct setting (developer-only).
+Author: Thomas Munro <tmunro@postgresql.org>
+2023-05-15 [319bae9a8] Rename io_direct to debug_io_direct.
 -->
 
 <listitem>
 <para>
-Determine the ICU default locale from the environment (Jeff Davis)
+Add debug_io_direct setting for developer usage (Thomas Munro, Andres Freund, Bharath Rupireddy)
 </para>
 
 <para>
-However, ICU doesn't support the C local so UTF-8 is used in such cases.  Previously the default was always UTF-8.
+While primarily for developers, wal_sync_method=open_sync/open_datasync has been modified to not use direct I/O with wal_level=minimal;  this is now enabled with debug_io_direct=wal.
 </para>
 </listitem>
 
 <!--
-Author: Peter Eisentraut <peter@eisentraut.org>
-2023-03-10 [0d21d4b9b] Add standard collation UNICODE
+Author: Michael Paquier <michael@paquier.xyz>
+2022-12-20 [cca186348] Add pg_dissect_walfile_name()
+Author: Michael Paquier <michael@paquier.xyz>
+2022-12-23 [13e0d7a60] Rename pg_dissect_walfile_name() to pg_split_walfile_nam
 -->
 
 <listitem>
 <para>
-Add predefined collations "unicode" and "ucs_basic" (Peter Eisentraut)
-</para>
-
-<para>
-This only works if ICU support is enabled.
+Add function pg_dissect_walfile_name() to report the segment and timeline values of WAL file names (Bharath Rupireddy)
 </para>
 </listitem>
 
+     </itemizedlist>
+
+    </sect4>
+
+    <sect4 id="release-16-pg-hba">
+     <title><link linkend="auth-pg-hba-conf">pg_hba.conf</link></title>
+
+     <itemizedlist>
+
 <!--
-Author: Peter Eisentraut <peter@eisentraut.org>
-2023-03-08 [30a53b792] Allow tailoring of ICU locales with custom rules
+Author: Michael Paquier <michael@paquier.xyz>
+2022-10-24 [8fea86830] Add support for regexps on database and user entries in
 -->
 
 <listitem>
 <para>
-Allow custom ICU collation rules to be created (Peter Eisentraut)
+Add support for regular expression matching on database and role entries in pg_hba.conf (Bertrand Drouvot)
 </para>
 
 <para>
-This is done using CREATE COLLATION's new new RULES clause, as well as new options for CREATE DATABASE, createdb, and initdb.
+Regular expression patterns are prefixed with a slash.  Database and role names that begin with slashes need to be double-quoted if referenced in pg_hba.conf.
 </para>
 </listitem>
 
 <!--
-Author: Peter Eisentraut <peter@eisentraut.org>
-2023-01-03 [bf03cfd16] Windows support in pg_import_system_collations
+Author: Michael Paquier <michael@paquier.xyz>
+2023-01-20 [efb6f4a4f] Support the same patterns for pg-user in pg_ident.conf a
 -->
 
 <listitem>
 <para>
-Add Windows process the system collations (Jose Santamaria Flecha)
-ADD THIS?
+Improve user-column handling of pg_ident.conf to match pg_hba.conf (Jelte Fennema)
+</para>
+
+<para>
+Specifically, add support for "all", role membership with "+", and regular expressions with a leading slash.  Any user name that matches these patterns must be double-quoted.
 </para>
 </listitem>
 
 <!--
-Author: Thomas Munro <tmunro@postgresql.org>
-2023-04-08 [d4e71df6d] Add io_direct setting (developer-only).
-Author: Thomas Munro <tmunro@postgresql.org>
-2023-05-15 [319bae9a8] Rename io_direct to debug_io_direct.
+Author: Michael Paquier <michael@paquier.xyz>
+2022-11-24 [a54b658ce] Add support for file inclusions in HBA and ident configu
 -->
 
 <listitem>
 <para>
-Add debug_io_direct setting for developer usage (Thomas Munro, Andres Freund, Bharath Rupireddy)
+Allow include files in pg_hba.conf and pg_ident.conf (Julien Rouhaud)
 </para>
 
 <para>
-While primarily for developers, wal_sync_method=open_sync/open_datasync has been modified to not use direct I/O with wal_level=minimal;  this is now enabled with debug_io_direct=wal.
+These are controlled by "include", "include_if_exists", and "include_dir".  System views pg_hba_file_rules and pg_ident_file_mappings now display the file name.
 </para>
 </listitem>
 
 <!--
 Author: Michael Paquier <michael@paquier.xyz>
-2022-12-20 [cca186348] Add pg_dissect_walfile_name()
-Author: Michael Paquier <michael@paquier.xyz>
-2022-12-23 [13e0d7a60] Rename pg_dissect_walfile_name() to pg_split_walfile_nam
+2022-10-26 [c591300a8] Add rule_number to pg_hba_file_rules and map_number to p
 -->
 
 <listitem>
 <para>
-Add function pg_dissect_walfile_name() to report the segment and timeline values of WAL file names (Bharath Rupireddy)
+Add rule and map numbers to the system view pg_hba_file_rules (Julien Rouhaud)
 </para>
 </listitem>
 
@@ -1207,64 +1215,65 @@ Add function pg_dissect_walfile_name() to report the segment and timeline values
 
     </sect4>
 
-    <sect4 id="release-16-pg-hba">
-     <title><link linkend="auth-pg-hba-conf">pg_hba.conf</link></title>
+    <sect4 id="release-16-localization">
+     <title><link linkend="charset">Localization</link></title>
 
      <itemizedlist>
 
 <!--
-Author: Michael Paquier <michael@paquier.xyz>
-2022-10-24 [8fea86830] Add support for regexps on database and user entries in
+Author: Jeff Davis <jdavis@postgresql.org>
+2023-03-10 [c45dc7ffb] initdb: derive encoding from locale for ICU; similar to
 -->
 
 <listitem>
 <para>
-Add support for regular expression matching on database and role entries in pg_hba.conf (Bertrand Drouvot)
+Determine the ICU default locale from the environment (Jeff Davis)
 </para>
 
 <para>
-Regular expression patterns are prefixed with a slash.  Database and role names that begin with slashes need to be double-quoted if referenced in pg_hba.conf.
+However, ICU doesn't support the C local so UTF-8 is used in such cases.  Previously the default was always UTF-8.
 </para>
 </listitem>
 
 <!--
-Author: Michael Paquier <michael@paquier.xyz>
-2023-01-20 [efb6f4a4f] Support the same patterns for pg-user in pg_ident.conf a
+Author: Peter Eisentraut <peter@eisentraut.org>
+2023-03-10 [0d21d4b9b] Add standard collation UNICODE
 -->
 
 <listitem>
 <para>
-Improve user-column handling of pg_ident.conf to match pg_hba.conf (Jelte Fennema)
+Add predefined collations "unicode" and "ucs_basic" (Peter Eisentraut)
 </para>
 
 <para>
-Specifically, add support for "all", role membership with "+", and regular expressions with a leading slash.  Any user name that matches these patterns must be double-quoted.
+This only works if ICU support is enabled.
 </para>
 </listitem>
 
 <!--
-Author: Michael Paquier <michael@paquier.xyz>
-2022-11-24 [a54b658ce] Add support for file inclusions in HBA and ident configu
+Author: Peter Eisentraut <peter@eisentraut.org>
+2023-03-08 [30a53b792] Allow tailoring of ICU locales with custom rules
 -->
 
 <listitem>
 <para>
-Allow include files in pg_hba.conf and pg_ident.conf (Julien Rouhaud)
+Allow custom ICU collation rules to be created (Peter Eisentraut)
 </para>
 
 <para>
-These are controlled by "include", "include_if_exists", and "include_dir".  System views pg_hba_file_rules and pg_ident_file_mappings now display the file name.
+This is done using CREATE COLLATION's new new RULES clause, as well as new options for CREATE DATABASE, createdb, and initdb.
 </para>
 </listitem>
 
 <!--
-Author: Michael Paquier <michael@paquier.xyz>
-2022-10-26 [c591300a8] Add rule_number to pg_hba_file_rules and map_number to p
+Author: Peter Eisentraut <peter@eisentraut.org>
+2023-01-03 [bf03cfd16] Windows support in pg_import_system_collations
 -->
 
 <listitem>
 <para>
-Add rule and map numbers to the system view pg_hba_file_rules (Julien Rouhaud)
+Add Windows process the system collations (Jose Santamaria Flecha)
+ADD THIS?
 </para>
 </listitem>