relnotes: clarify pg_basebackup compression options

Also, a few wording improvements

Reported-by: Justin Pryzby
Discussion: https://postgr.es/m/20220719181307.GG12702@telsasoft.com

Backpatch-through: 15 only

diff --git a/doc/src/sgml/release-15.sgml b/doc/src/sgml/release-15.sgml
index dfa3c74535d6d3f57b3288760e9a73c4e85dd7c2..1cf6375ed1d3076ff3e29036d35bb2b1f5c92f34 100644 (file)
--- a/doc/src/sgml/release-15.sgml
+++ b/doc/src/sgml/release-15.sgml
@@ -544,8 +544,8 @@ Author: Tom Lane <tgl@sss.pgh.pa.us>
 
      <para>
       The default is now that custom scan providers are assumed to not
-      support projections;  those that do need to be updated for this
-      release.
+      support projections;  those that do will need to be updated for
+      this release.
      </para>
     </listitem>
 
@@ -2495,30 +2495,21 @@ Author: Robert Haas <rhaas@postgresql.org>
 2022-02-11 [751b8d23b] pg_basebackup: Allow client-side LZ4 (de)compression.
 Author: Robert Haas <rhaas@postgresql.org>
 2022-03-08 [7cf085f07] Add support for zstd base backup compression.
+Author: Robert Haas <rhaas@postgresql.org>
+2022-01-24 [0ad803291] Server-side gzip compression.
 -->
 
      <listitem>
       <para>
-       Allow <application>pg_basebackup</application> to do LZ4 and
-       Zstandard server-side compression on base backup files (Dipesh
-       Pandit, Jeevan Ladhe)
+       Allow <application>pg_basebackup</application> to do server-side
+       gzip, LZ4, and Zstandard compression and client-side LZ4 and
+       Zstandard compression of base backup files (Dipesh Pandit,
+       Jeevan Ladhe)
       </para>
-     </listitem>
-
-<!--
-Author: Michael Paquier <michael@paquier.xyz>
-2022-01-21 [5c649fe15] Extend the options of pg_basebackup to control compressi
-Author: Robert Haas <rhaas@postgresql.org>
-2022-01-24 [0ad803291] Server-side gzip compression.
-Author: Robert Haas <rhaas@postgresql.org>
-2022-01-25 [e1f860f13] Tidy up a few cosmetic issues related to pg_basebackup.
--->
 
-     <listitem>
       <para>
-       Allow <application>pg_basebackup</application>'s
-       <option>--compress</option> option to control the compression
-       method and options (Michael Paquier, Robert Haas)
+       Client-side <literal>gzip</literal> compression was already
+       supported.
       </para>
      </listitem>
 
@@ -2540,6 +2531,24 @@ Author: Robert Haas <rhaas@postgresql.org>
       </para>
      </listitem>
 
+<!--
+Author: Michael Paquier <michael@paquier.xyz>
+2022-01-21 [5c649fe15] Extend the options of pg_basebackup to control compressi
+Author: Robert Haas <rhaas@postgresql.org>
+2022-01-24 [0ad803291] Server-side gzip compression.
+Author: Robert Haas <rhaas@postgresql.org>
+2022-01-25 [e1f860f13] Tidy up a few cosmetic issues related to pg_basebackup.
+-->
+
+     <listitem>
+      <para>
+       Allow <application>pg_basebackup</application>'s
+       <option>--compress</option> option to control the compression
+       location (server or client), compression method, and compression
+       options (Michael Paquier, Robert Haas)
+      </para>
+     </listitem>
+
 <!--
 Author: Michael Paquier <michael@paquier.xyz>
 2021-11-05 [babbbb595] Add support for LZ4 compression in pg_receivewal