pgsql: Rename the WAIT FOR command to WAIT in the documentation

From: Alexander Korotkov <akorotkov(at)postgresql(dot)org>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Rename the WAIT FOR command to WAIT in the documentation
Date: 2026-09-14 11:50:05
Message-ID: E1x65CH-00000000HNV-2yeh@gemulon.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-committers

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(dot)mshk(at)gmail(dot)com
Author: Xuneng Zhou xunengzhou(at)gmail(dot)com
Reviewed-by: Alexander Korotkov aekorotkov(at)gmail(dot)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(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Daniel Gustafsson 2026-09-14 13:34:14 pgsql: pg_combinebackup: Refuse mixed data checksum states in a backup
Previous Message Alexander Korotkov 2026-09-14 11:49:53 pgsql: Rename the WAIT FOR command to WAIT in the documentation