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 - When waiting for startup, pg_ctl repeatedly - attempts to connect to the server. - When waiting for shutdown, pg_ctl waits for - the server to remove its PID file. + When waiting, pg_ctl repeatedly checks the + server's PID file, sleeping for a short amount + of time between checks. Startup is considered complete when + the PID file indicates that the server is ready to + accept connections. Shutdown is considered complete when the server + removes the PID file. pg_ctl returns an exit code based on the success of the startup or shutdown.