docs: improve event notification documentation

doc/event-notifications.sgml

@@ -126,6 +126,9 @@
    <listitem>
     <simpara><literal>primary_register</literal></simpara>
    </listitem>
+   <listitem>
+    <simpara><literal>primary_unregister</literal></simpara>
+   </listitem>
    <listitem>
     <simpara><literal>standby_register</literal></simpara>
    </listitem>
@@ -144,6 +147,15 @@
    <listitem>
     <simpara><literal>standby_disconnect_manual</literal></simpara>
    </listitem>
+   <listitem>
+    <simpara><literal>witness_register</literal></simpara>
+   </listitem>
+   <listitem>
+    <simpara><literal>witness_unregister</literal></simpara>
+   </listitem>
+   <listitem>
+    <simpara><literal>node_rejoin</literal></simpara>
+   </listitem>
    <listitem>
     <simpara><literal>repmgrd_start</literal></simpara>
    </listitem>

doc/repmgr-node-rejoin.sgml

@@ -45,6 +45,13 @@
     </para>
   </refsect1>
 
+  <refsect1>
+    <title>Event notifications</title>
+    <para>
+      A <literal>node_rejoin</literal> event notification will be generated.
+    </para>
+  </refsect1>
+
   <refsect1>
     <title>Notes</title>
     <para>
@@ -78,7 +85,8 @@
     </para>
     <note>
       <para>
-        <command>pg_rewind</command> *requires* that either <varname>wal_log_hints</varname> is enabled, or that
+        <command>pg_rewind</command> <emphasis>requires</emphasis> that either
+        <varname>wal_log_hints</varname> is enabled, or that
         data checksums were enabled when the cluster was initialized. See the
         <ulink url="https://www.postgresql.org/docs/current/static/app-pgrewind.html"><command>pg_rewind</command> documentation</ulink> for details.
       </para>

doc/repmgr-primary-register.sgml

@@ -48,4 +48,11 @@
     </note>
   </refsect1>
 
+  <refsect1>
+    <title>Event notifications</title>
+    <para>
+      A <literal>primary_register</literal> event notification will be generated.
+    </para>
+  </refsect1>
+
 </refentry>

doc/repmgr-primary-unregister.sgml

@@ -31,4 +31,12 @@
       <command>repmgr primary unregister</command>/
     </para>
   </refsect1>
+
+  <refsect1>
+    <title>Event notifications</title>
+    <para>
+      A <literal>primary_unregister</literal> event notification will be generated.
+    </para>
+  </refsect1>
+
 </refentry>

doc/repmgr-standby-clone.sgml

@@ -99,5 +99,13 @@
     </simpara>
    </note>
   </refsect1>
+
+  <refsect1>
+    <title>Event notifications</title>
+    <para>
+      A <literal>standby_clone</literal> event notification will be generated.
+    </para>
+  </refsect1>
+
 </refentry>
 

doc/repmgr-standby-follow.sgml

@@ -48,6 +48,13 @@
     </para>
   </refsect1>
 
+  <refsect1>
+    <title>Event notifications</title>
+    <para>
+      A <literal>standby_follow</literal> event notification will be generated.
+    </para>
+  </refsect1>
+
  <refsect1>
     <title>See also</title>
     <para>

doc/repmgr-standby-promote.sgml

@@ -41,4 +41,12 @@
       DETAIL: server "node2" (ID: 2) was successfully promoted to primary</programlisting>
     </para>
   </refsect1>
+
+  <refsect1>
+    <title>Event notifications</title>
+    <para>
+      A <literal>standby_promote</literal> event notification will be generated.
+    </para>
+  </refsect1>
+
 </refentry>

doc/repmgr-standby-register.sgml

@@ -74,4 +74,13 @@
     <literal>-F/--force</literal> option does not result in an incorrectly configured cluster.
    </para>
   </refsect1>
+
+
+  <refsect1>
+    <title>Event notifications</title>
+    <para>
+      A <literal>standby_register</literal> event notification will be generated.
+    </para>
+  </refsect1>
+
 </refentry>

doc/repmgr-standby-switchover.sgml

@@ -40,6 +40,15 @@
     </para>
   </refsect1>
 
+  <refsect1>
+    <title>Event notifications</title>
+    <para>
+      A <literal>standby_promote</literal> event notification will be generated on the new primary,
+      and a <literal>node_rejoin</literal> event notification on the former primary (new standby).
+    </para>
+  </refsect1>
+
+
   <refsect1>
     <title>See also</title>
     <para>

doc/repmgr-standby-unregister.sgml

@@ -42,5 +42,13 @@
         repmgr standby unregister -f /etc/repmgr.conf --node-id=3</programlisting>
     </para>
   </refsect1>
+
+  <refsect1>
+    <title>Event notifications</title>
+    <para>
+      A <literal>standby_unregister</literal> event notification will be generated.
+    </para>
+  </refsect1>
+
 </refentry>
 

doc/repmgr-witness-register.sgml

@@ -49,4 +49,12 @@
     </para>
   </refsect1>
 
+
+  <refsect1>
+    <title>Event notifications</title>
+    <para>
+      A <literal>witness_register</literal> event notification will be generated.
+    </para>
+  </refsect1>
+
 </refentry>

doc/repmgr-witness-unregister.sgml

@@ -61,4 +61,13 @@
       <link linkend="repmgr-witness-register">repmgr witness register --force</link>.
     </para>
   </refsect1>
+
+
+  <refsect1>
+    <title>Event notifications</title>
+    <para>
+      A <literal>witness_unregister</literal> event notification will be generated.
+    </para>
+  </refsect1>
+
 </refentry>