The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/devel/static/app-pg-ctl.html
Description:
The docs for --wait still say:
"When waiting for startup, pg_ctl repeatedly attempts to connect to the
server."
I believe it's been changed to examine postmaster.pid instead (thanks
Tom!).