From d4aa4d4ff2da207c4bfd8ffeb0c03dce6a7cab67 Mon Sep 17 00:00:00 2001
From: Amul Sul <sulamul@gmail.com>
Date: Mon, 4 May 2026 16:40:46 +0530
Subject: [PATCH] Document deprecated --wal-directory option for
 pg_verifybackup
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Commit b3cf461b3cf91c586ab94b4dddd6dcd8ff8fec47 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.
---
 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..4809a8b91e6 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);
-- 
2.47.1

