postgres.git / summary / log / commit / refs

commit    c9707d9413b171a6f017db1ea7832d797d3abc0d
Author:   Tom Lane <tgl@sss.pgh.pa.us>
Date:     Tue Jan 23 17:41:35 2018 +0000

    Documentation fix: pg_ctl no longer makes connection attempts.
    
    Overlooked in commit f13ea95f9.  Noted by Nick Barnes.
    
    Discussion: https://postgr.es/m/20180123093723.7407.3386@wrigleys.postgresql.org


 doc/src/sgml/ref/pg_ctl-ref.sgml | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/doc/src/sgml/ref/pg_ctl-ref.sgml b/doc/src/sgml/ref/pg_ctl-ref.sgml
index 7eb5dd320c1..0816bc1686c 100644
--- a/doc/src/sgml/ref/pg_ctl-ref.sgml
+++ b/doc/src/sgml/ref/pg_ctl-ref.sgml
@@ -405,10 +405,12 @@ PostgreSQL documentation
        </para>
 
        <para>
-        When waiting for startup, <command>pg_ctl</command> repeatedly
-        attempts to connect to the server.
-        When waiting for shutdown, <command>pg_ctl</command> waits for
-        the server to remove its <acronym>PID</acronym> file.
+        When waiting, <command>pg_ctl</command> repeatedly checks the
+        server's <acronym>PID</acronym> file, sleeping for a short amount
+        of time between checks.  Startup is considered complete when
+        the <acronym>PID</acronym> file indicates that the server is ready to
+        accept connections.  Shutdown is considered complete when the server
+        removes the <acronym>PID</acronym> file.
         <command>pg_ctl</command> returns an exit code based on the
         success of the startup or shutdown.
        </para>


[parent: f9bbd46adbf3]