doc: document "node_rejoin_timeout" for switchover operations

doc/repmgr-daemon-start.sgml

@@ -70,6 +70,7 @@
       </varlistentry>
 
       <varlistentry>
+        <term><option>-w</option></term>
         <term><option>--wait</option></term>
         <listitem>
           <para>

doc/repmgr-daemon-stop.sgml

@@ -78,7 +78,8 @@
       </varlistentry>
 
       <varlistentry>
-        <term><option>-w/--wait</option></term>
+        <term><option>-w</option></term>
+        <term><option>--wait</option></term>
         <listitem>
           <para>
             Wait for the specified number of seconds to confirm that <application>repmgrd</application>

doc/repmgr-standby-switchover.sgml

@@ -146,6 +146,7 @@
 
 
      <varlistentry>
+
         <term><option>--siblings-follow</option></term>
         <listitem>
           <para>
@@ -163,27 +164,57 @@
     <para>
      Note that following parameters in <filename>repmgr.conf</filename> are relevant to the
      switchover operation:
-     <itemizedlist spacing="compact" mark="bullet">
+    </para>
 
-       <listitem>
-         <simpara>
-           <literal>replication_lag_critical</literal>:
-           if replication lag (in seconds) on the standby exceeds this value, the
-           switchover will be aborted (unless the <literal>-F/--force</literal> option
-           is provided)
-         </simpara>
-       </listitem>
+    <variablelist>
 
-       <listitem>
-         <simpara>
-           <literal>shutdown_check_timeout</literal>: maximum number of seconds to wait for the
-           demotion candidate (current primary) to shut down, before aborting the switchover.
-         </simpara>
-         <simpara>
-           Note that this parameter is set on the node where <command>repmgr standby switchover</command>
-           is executed (promotion candidate); setting it on the demotion candidate (former primary) will
-           have no effect.
-         </simpara>
+      <varlistentry>
+        <indexterm>
+          <primary>x</primary>
+          <secondary>with &quot;repmgr standby switchover &quot;</secondary>
+        </indexterm>
+
+        <term><option></option></term>
+        <listitem>
+          <para>
+         </para>
+        </listitem>
+      </varlistentry>
+
+
+      <varlistentry>
+        <indexterm>
+          <primary>replication_lag_critical</primary>
+          <secondary>with &quot;repmgr standby switchover &quot;</secondary>
+        </indexterm>
+
+        <term><option>replication_lag_critical</option></term>
+        <listitem>
+          <para>
+            If replication lag (in seconds) on the standby exceeds this value, the
+            switchover will be aborted (unless the <literal>-F/--force</literal> option
+            is provided)
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <indexterm>
+          <primary>shutdown_check_timeout</primary>
+          <secondary>with &quot;repmgr standby switchover &quot;</secondary>
+        </indexterm>
+
+        <term><option>shutdown_check_timeout</option></term>
+        <listitem>
+          <para>
+            maximum number of seconds to wait for the
+            demotion candidate (current primary) to shut down, before aborting the switchover.
+          </para>
+          <para>
+            Note that this parameter is set on the node where <command>repmgr standby switchover</command>
+            is executed (promotion candidate); setting it on the demotion candidate (former primary) will
+            have no effect.
+          </para>
          <note>
            <para>
              In versions prior to <link linkend="release-4.2">&repmgr; 4.2</link>, <command>repmgr standby switchover</command> would
@@ -191,18 +222,56 @@
              to determine the timeout for demotion candidate shutdown.
            </para>
          </note>
-       </listitem>
+        </listitem>
+      </varlistentry>
 
-       <listitem>
-         <simpara>
-           <literal>standby_reconnect_timeout</literal>:
-           maximum number of seconds to attempt to wait for the demotion candidate (former primary)
+     <varlistentry>
+        <indexterm>
+          <primary>standby_reconnect_timeout</primary>
+          <secondary>with &quot;repmgr standby switchover &quot;</secondary>
+        </indexterm>
+
+        <term><option>standby_reconnect_timeout</option></term>
+        <listitem>
+          <para>
+            maximum number of seconds to attempt to wait for the demotion candidate (former primary)
            to reconnect to the promoted primary (default: 60 seconds)
-         </simpara>
-       </listitem>
+          </para>
+          <para>
+            Note that this parameter is set on the node where <command>repmgr standby switchover</command>
+            is executed (promotion candidate); setting it on the demotion candidate (former primary) will
+            have no effect.
+          </para>
+        </listitem>
+      </varlistentry>
+
+
+     <varlistentry>
+        <indexterm>
+          <primary>node_rejoin_timeout</primary>
+          <secondary>with &quot;repmgr standby switchover &quot;</secondary>
+        </indexterm>
+
+        <term><option>node_rejoin_timeout</option></term>
+        <listitem>
+          <para>
+            maximum number of seconds to attempt to wait for the demotion candidate (former primary)
+            to reconnect to the promoted primary (default: 60 seconds)
+          </para>
+          <para>
+            Note that this parameter is set on the the demotion candidate (former primary);
+            setting it on the node where <command>repmgr standby switchover</command> is
+            executed will have no effect.
+          </para>
+          <para>
+            However, this value <emphasis>must</emphasis> be less than <option>standby_reconnect_timeout</option> on the
+            promotion candidate (node where <command>repmgr standby switchover</command> is executed).
+          </para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
 
-     </itemizedlist>
-    </para>
   </refsect1>