agora inbox for pgsql-committers@postgresql.org
help / color / mirror / Atom feedpgsql: Rename the WAIT FOR command to WAIT in the documentation
2+ messages / 1 participants
[nested] [flat]
* pgsql: Rename the WAIT FOR command to WAIT in the documentation
@ 2026-09-14 11:49 Alexander Korotkov <akorotkov@postgresql.org>
0 siblings, 0 replies; 2+ messages in thread
From: Alexander Korotkov @ 2026-09-14 11:49 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
Rename the WAIT FOR command to WAIT in the documentation
The command tag is WAIT, but the reference page called the command
"WAIT FOR" in its title, index entry, psql help name and throughout its
prose, and so did the error messages. FOR is a noise word that makes the
grammar read like English, exactly as INTO does for INSERT and FROM does
for DELETE; neither of those is part of the command's name. Settle on
WAIT everywhere the command is named, and keep WAIT FOR LSN wherever the
syntax itself is being shown.
Rename the reference page's id and file name to match, following
cb2c696b1dd: v19 is not released, so the URL is not yet baked into a
supported version, and every other page's id matches its title.
Reported-by: Masahiko Sawada sawada.mshk@gmail.com
Author: Xuneng Zhou xunengzhou@gmail.com
Reviewed-by: Alexander Korotkov aekorotkov@gmail.com
Discussion: https://postgr.es/m/CAD21AoBdtiPTbm7T_aNeDON9JpFG9g%3DJDUP4WU-Y8t8_xqvR5Q%40mail.gmail.com
Backpatch-through: 19
Branch
------
master
Details
-------
https://git.postgresql.org/pg/commitdiff/a23ab4862cfebb9aba58f713854b7d5e42d5f947
Modified Files
--------------
doc/src/sgml/high-availability.sgml | 2 +-
doc/src/sgml/ref/allfiles.sgml | 2 +-
doc/src/sgml/ref/{wait_for.sgml => wait.sgml} | 30 +++++++++++++--------------
doc/src/sgml/reference.sgml | 2 +-
src/backend/commands/wait.c | 8 +++----
src/test/recovery/t/049_wait_for_lsn.pl | 9 ++++----
6 files changed, 26 insertions(+), 27 deletions(-)
^ permalink raw reply [nested|flat] 2+ messages in thread
* pgsql: Rename the WAIT FOR command to WAIT in the documentation
@ 2026-09-14 11:50 Alexander Korotkov <akorotkov@postgresql.org>
0 siblings, 0 replies; 2+ messages in thread
From: Alexander Korotkov @ 2026-09-14 11:50 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
Rename the WAIT FOR command to WAIT in the documentation
The command tag is WAIT, but the reference page called the command
"WAIT FOR" in its title, index entry, psql help name and throughout its
prose, and so did the error messages. FOR is a noise word that makes the
grammar read like English, exactly as INTO does for INSERT and FROM does
for DELETE; neither of those is part of the command's name. Settle on
WAIT everywhere the command is named, and keep WAIT FOR LSN wherever the
syntax itself is being shown.
Rename the reference page's id and file name to match, following
cb2c696b1dd: v19 is not released, so the URL is not yet baked into a
supported version, and every other page's id matches its title.
Reported-by: Masahiko Sawada sawada.mshk@gmail.com
Author: Xuneng Zhou xunengzhou@gmail.com
Reviewed-by: Alexander Korotkov aekorotkov@gmail.com
Discussion: https://postgr.es/m/CAD21AoBdtiPTbm7T_aNeDON9JpFG9g%3DJDUP4WU-Y8t8_xqvR5Q%40mail.gmail.com
Backpatch-through: 19
Branch
------
REL_19_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/1a562a2661b30e72f37bdf8500fac01c347114ac
Modified Files
--------------
doc/src/sgml/high-availability.sgml | 2 +-
doc/src/sgml/ref/allfiles.sgml | 2 +-
doc/src/sgml/ref/{wait_for.sgml => wait.sgml} | 30 +++++++++++++--------------
doc/src/sgml/reference.sgml | 2 +-
doc/src/sgml/release-19.sgml | 4 ++--
src/backend/commands/wait.c | 8 +++----
src/test/recovery/t/049_wait_for_lsn.pl | 9 ++++----
7 files changed, 28 insertions(+), 29 deletions(-)
^ permalink raw reply [nested|flat] 2+ messages in thread
end of thread, other threads:[~2026-09-14 11:50 UTC | newest]
Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2026-09-14 11:49 pgsql: Rename the WAIT FOR command to WAIT in the documentation Alexander Korotkov <akorotkov@postgresql.org>
2026-09-14 11:50 pgsql: Rename the WAIT FOR command to WAIT in the documentation Alexander Korotkov <akorotkov@postgresql.org>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox