From 158008c5c5179e3e1b57413759222a2c642b44bb Mon Sep 17 00:00:00 2001
From: Ian Barwick <ian@2ndquadrant.com>
Date: Fri, 18 Sep 2020 11:29:07 +0900
Subject: [PATCH] doc: update release notes

---
 HISTORY                        | 17 +++++++--
 doc/appendix-release-notes.xml | 66 +++++++++++++++++++++++++++++++++-
 2 files changed, 79 insertions(+), 4 deletions(-)

diff --git a/HISTORY b/HISTORY
index 10d6b98b..71cb4e71 100644
--- a/HISTORY
+++ b/HISTORY
@@ -1,10 +1,21 @@
 5.2.0   2020-??-??
+        general: add support for PostgreSQL 13 (Ian)
+        general: remove support for PostgreSQL 9.3 (Ian)
+        config: add support for file inclusion directives (Ian)
+        repmgr: add option --verify-backup to "standby clone" (Ian)
+        repmgr: add option --db-connection to "node check" (Ian)
+        repmgr: report database connection error if the --optformat option was
+          provided to "node check" (Ian)
+        repmgr: improve "node rejoin" checks (Ian)
+        repmgr: improve output formatting for cluster matrix/crosscheck (Ian)
         repmgr: improve database connection failure error checking on the
           demotion candidate during "standby switchover" (Ian)
-        repmgr: add option --verify-backup to "standby clone" (Ian)
+        repmgr: fix issue with tablespace mapping when cloning from Barman;
+          GitHub #650 (Ian)
         repmgrd: add additional optional parameters to "failover_validation command"
           (spaskalev; GitHub #651)
-        general: remove support for PostgreSQL 9.3 (Ian)
+        repmgrd: ensure primary connection is reset if same as upstream;
+          GitHub #633 (Ian)
 
 5.1.0   2020-04-13
         repmgr: remove BDR 2.x support
@@ -17,7 +28,7 @@
           "standby clone" (Ian)
         repmgr: add --upstream option to "node check"
         repmgr: report error code on follow/rejoin failure due to non-available
-          replication slot (Ian)
+0          replication slot (Ian)
         repmgr: ensure "node rejoin" checks for available replication slots (Ian)
         repmgr: improve "standby switchover" completion checks (Ian)
         repmgr: add replication configuration file ownership check to
diff --git a/doc/appendix-release-notes.xml b/doc/appendix-release-notes.xml
index 975dd34d..0d92d61f 100644
--- a/doc/appendix-release-notes.xml
+++ b/doc/appendix-release-notes.xml
@@ -33,6 +33,12 @@
       <title>General improvements</title>
       <para>
         <itemizedlist>
+          <listitem>
+            <para>
+              Configuration: support <command>include</command>, <command>include_dir</command> and
+              <command>include_if_exists</command> directives.
+            </para>
+          </listitem>
           <listitem>
             <para>
               <link linkend="repmgr-standby-switchover"><command>repmgr standby switchover</command></link>:
@@ -46,6 +52,38 @@
               of the respective sanity check.
             </para>
           </listitem>
+          <listitem>
+            <para>
+              <link linkend="repmgr-cluster-crosscheck">repmgr cluster crosscheck</link> /
+              <link linkend="repmgr-cluster-matrix">repmgr cluster matrix</link>:
+              improve text mode output format, in particular so that node identifiers of arbitrary length are
+              displayed correctly.
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              <link linkend="repmgr-standby-clone">repmgr standby clone</link>: new option
+              <option>--verify-backup</option> to run PostgreSQL's
+              <ulink url="https://www.postgresql.org/docs/13/app-pgverifybackup.html">pg_verifybackup</ulink>
+              utility after cloning a standby to verify the integrity of the copied data
+              (PostgreSQL 13 and later).
+            </para>
+          </listitem>
+
+          <listitem>
+            <para>
+              <link linkend="repmgr-node-check">repmgr node check</link>:
+              option <option>--db-connection</option> added to check if &repmgr; can connect to the database on the
+              local node.
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              <link linkend="repmgr-node-check">repmgr node check</link>:
+              report database connection error if the <option>--optformat</option> was provided.
+            </para>
+          </listitem>
+
         </itemizedlist>
       </para>
     </sect2>
@@ -74,13 +112,39 @@
                   <simpara><literal>%t</literal>: total number of nodes</simpara>
                 </listitem>
               </itemizedlist>
-
             </para>
           </listitem>
         </itemizedlist>
       </para>
     </sect2>
 
+    <sect2>
+      <title>Bug fixes</title>
+      <para>
+       <itemizedlist>
+          <listitem>
+            <para>
+              <link linkend="repmgr-standby-clone">repmgr standby clone</link>:
+              fix issue with cloning from Barman where the tablespace mapping file was
+              not flushed to disk before attempting to retrieve files from Barman. GitHub #650.
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              <link linkend="repmgr-node-rejoin">repmgr node rejoin</link>:
+              ensure that when verifying a standby node has attached to its upstream, the
+              node has started streaming before confirming the success of the rejoin operation.
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              &repmgrd;: ensure primary connection is reset if same as upstream. GitHub #633.
+            </para>
+          </listitem>
+       </itemizedlist>
+      </para>
+    </sect2>
+
   </sect1>
 
   <sect1 id="release-5.1.0">