From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Tue, 23 Jan 2018 17:41:35 +0000 (-0500)
Subject: Documentation fix: pg_ctl no longer makes connection attempts.
X-Git-Tag: REL_10_2~37
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=5ca17d655f96fd442b6857f26f5660f541d93c38;p=postgresql

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
---

diff --git a/doc/src/sgml/ref/pg_ctl-ref.sgml b/doc/src/sgml/ref/pg_ctl-ref.sgml
index 12fa011c4e..59b04f7274 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>