diff --git a/doc/repmgr-standby-follow.sgml b/doc/repmgr-standby-follow.sgml
index d464361b..34b67c70 100644
--- a/doc/repmgr-standby-follow.sgml
+++ b/doc/repmgr-standby-follow.sgml
@@ -30,6 +30,7 @@
       To re-add an inactive node to the replication cluster, see
       <xref linkend="repmgr-node-rejoin">
     </para>
+
   </refsect1>
 
   <refsect1>
@@ -74,7 +75,10 @@
         <term><option>--wait</option></term>
         <listitem>
           <para>
-            Wait for a primary to appear.
+            Wait for a primary to appear. &repmgr; will wait for up to
+            <varname>primary_follow_timeout</varname> seconds
+            (default: 60 seconds) to verify that the standby is following the new primary.
+            This value can be defined in <filename>repmgr.conf</filename>.
           </para>
         </listitem>
       </varlistentry>
diff --git a/doc/repmgr-standby-promote.sgml b/doc/repmgr-standby-promote.sgml
index 4a80fb42..513a7e73 100644
--- a/doc/repmgr-standby-promote.sgml
+++ b/doc/repmgr-standby-promote.sgml
@@ -29,8 +29,8 @@
     <para>
       Note that &repmgr; will wait for up to <varname>promote_check_timeout</varname> seconds
       (default: 60 seconds) to verify that the standby has been promoted, and will
-      check the promotion every <varname>promote_check_interval</varname> seconds (default: 1 second)
-      (both values can be defined in <filename>repmgr.conf</filename>).
+      check the promotion every <varname>promote_check_interval</varname> seconds (default: 1 second).
+      Both values can be defined in <filename>repmgr.conf</filename>.
     </para>
   </refsect1>