"standby switchover": improve replication connection check

Previously repmgr would first check that a replication can be made
from the demotion candidate to the promotion candidate, however it's
preferable to sanity-check the number of available walsenders first,
to provide a more useful error message.

doc/appendix-release-notes.sgml

@@ -21,6 +21,22 @@
     <para>
     </para>
 
+   <sect2>
+      <title>repmgr enhancements</title>
+      <para>
+        <itemizedlist>
+
+          <listitem>
+            <para>
+              <command><link linkend="repmgr-standby-switchover">repmgr standby switchover</link></command>:
+              improve detection of free walsenders. (GitHub #495).
+            </para>
+          </listitem>
+
+        </itemizedlist>
+      </para>
+   </sect2>
+
     <sect2>
       <title>repmgr enhancements</title>
       <para>

doc/switchover.sgml

@@ -60,6 +60,13 @@
     &repmgr; being able to shut down the current primary server quickly and cleanly.
    </para>
 
+   <para>
+     Ensure that the promotion candidate has sufficient free walsenders available
+     (PostgreSQL configuration item <varname>max_wal_senders</varname>), and if replication
+     slots are in use, at least one free slot is available for the demotion candidate (
+     PostgreSQL configuration item <varname>max_replication_slots</varname>).
+   </para>
+
    <para>
      Ensure that a passwordless SSH connection is possible from the promotion candidate
      (standby) to the demotion candidate (current primary). If <literal>--siblings-follow</literal>