| 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:49:53 |
| Message-ID: | E1x65C5-00000000HMj-2wZa@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
------
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(-)
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Alexander Korotkov | 2026-09-14 11:50:05 | pgsql: Fix timeout overflow in WAIT FOR LSN |
| Previous Message | Etsuro Fujita | 2026-09-14 10:04:07 | pgsql: postgres_fdw: Disable attribute statistics import from pre-9.1 s |