Rework documentation of pg_promote

This clarifies the behavior of how the "wait" flag works, which is
something that the previous version of the documentation failed to do.

Author: Ian Barwick
Discussion: https://postgr.es/m/cbd38450-2295-10a1-1f73-591a692ae0b0@2ndquadrant.com

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index edeb3fd07bd98d3fd48602b9dfe9ce5521c93fc7..d730261742379e92dd8872aa4bd659d97bdabf73 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -19278,14 +19278,16 @@ postgres=# SELECT * FROM pg_walfile_name_offset(pg_stop_backup());
         
        boolean
        
-        Promotes a physical standby server.  Returns true
-        if promotion is successful and false otherwise.
-        With wait set to true, the
-        default, the function waits until promotion is completed or
-        wait_seconds seconds have passed, otherwise the
-        function returns immediately after sending the promotion signal to the
-        postmaster.  This function is restricted to superusers by default, but
-        other users can be granted EXECUTE to run the function.
+        Promotes a physical standby server.  With wait
+        set to true (the default), the function waits until
+        promotion is completed or wait_seconds seconds
+        have passed, and returns true if promotion is
+        successful and false otherwise.
+        If wait is set to false, the
+        function returns true immediately after sending
+        SIGUSR1 to the postmaster to trigger the promotion.
+        This function is restricted to superusers by default, but other users
+        can be granted EXECUTE to run the function.