postgres.git / summary / log / commit / refs

commit    43dc21f76fff67c481b1d208f9ee81a28972a158
Author:   Peter Eisentraut <peter@eisentraut.org>
Date:     Wed May 06 08:40:45 2026 +0000

    Document deprecated --wal-directory option for pg_verifybackup
    
    Commit b3cf461b3cf renamed --wal-directory to --wal-path but retained
    the former as a silent alias.  Per project policy, all options,
    including deprecated ones, should be documented to assist users
    transitioning between versions.
    
    This patch restores --wal-directory to the documentation and --help
    output.
    
    Author: Amul Sul <sulamul@gmail.com>
    Discussion: https://www.postgresql.org/message-id/flat/E1w3fZp-000gje-31%40gemulon.postgresql.org


 doc/src/sgml/ref/pg_verifybackup.sgml     | 1 +
 src/bin/pg_verifybackup/pg_verifybackup.c | 1 +
 2 files changed, 2 insertions(+)

diff --git a/doc/src/sgml/ref/pg_verifybackup.sgml b/doc/src/sgml/ref/pg_verifybackup.sgml
index 1695cfe91c8..045516464a4 100644
--- a/doc/src/sgml/ref/pg_verifybackup.sgml
+++ b/doc/src/sgml/ref/pg_verifybackup.sgml
@@ -259,6 +259,7 @@ PostgreSQL documentation
      <varlistentry>
       <term><option>-w <replaceable class="parameter">path</replaceable></option></term>
       <term><option>--wal-path=<replaceable class="parameter">path</replaceable></option></term>
+      <term><option>--wal-directory=<replaceable class="parameter">path</replaceable></option> (deprecated)</term>
       <listitem>
        <para>
         Try to parse WAL files stored in the specified directory or tar
diff --git a/src/bin/pg_verifybackup/pg_verifybackup.c b/src/bin/pg_verifybackup/pg_verifybackup.c
index b60ab8739d5..bb4fb97219e 100644
--- a/src/bin/pg_verifybackup/pg_verifybackup.c
+++ b/src/bin/pg_verifybackup/pg_verifybackup.c
@@ -1399,6 +1399,7 @@ usage(void)
 	printf(_("  -q, --quiet                 do not print any output, except for errors\n"));
 	printf(_("  -s, --skip-checksums        skip checksum verification\n"));
 	printf(_("  -w, --wal-path=PATH         use specified path for WAL files\n"));
+	printf(_("      --wal-directory=PATH    (same as --wal-path, deprecated)\n"));
 	printf(_("  -V, --version               output version information, then exit\n"));
 	printf(_("  -?, --help                  show this help, then exit\n"));
 	printf(_("\nReport bugs to <%s>.\n"), PACKAGE_BUGREPORT);


[parent: a0a0c0c20ec5]