v3-0001-doc-Clarify-VERBOSE-output-for-ANALYZE-and-VACUUM.patch

From 8ea5528d83d43d6fabedffd0636e9f481c079a0f Mon Sep 17 00:00:00 2001
From: Shinya Kato <shinya11.kato@gmail.com>
Date: Fri, 10 Jul 2026 17:15:44 +0900
Subject: [PATCH v3] doc: Clarify VERBOSE output for ANALYZE and VACUUM

ANALYZE VERBOSE emits detailed per-table information at INFO level,
just like VACUUM VERBOSE, but its option description only mentioned
generic "progress messages".  Reword the ANALYZE description to
describe the actual output, and adjust the VACUUM wording to match, so
the two commands read consistently.

Author: Shinya Kato <shinya11.kato@gmail.com>
Reviewed-by: Maciek Sakrejda <m.sakrejda@gmail.com>
Reviewed-by: Fujii Masao <masao.fujii@gmail.com>
Reviewed-by: David G. Johnston <david.g.johnston@gmail.com>
Reviewed-by: Surya Poondla <suryapoondla4@gmail.com>
Reviewed-by: Yushu Chen <gentcys@gmail.com>
Discussion: https://postgr.es/m/CAOzEurTpMTUEW8kHu-zKB0EBtuPfpvyoJ--8pxKe87p24BGrpg@mail.gmail.com
---
 doc/src/sgml/ref/analyze.sgml | 3 ++-
 doc/src/sgml/ref/vacuum.sgml  | 4 ++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/doc/src/sgml/ref/analyze.sgml b/doc/src/sgml/ref/analyze.sgml
index ec81f00fecf..6869a0ef47c 100644
--- a/doc/src/sgml/ref/analyze.sgml
+++ b/doc/src/sgml/ref/analyze.sgml
@@ -65,7 +65,8 @@ ANALYZE [ ( <replaceable class="parameter">option</replaceable> [, ...] ) ] [ <r
     <term><literal>VERBOSE</literal></term>
     <listitem>
      <para>
-      Enables display of progress messages at <literal>INFO</literal> level.
+      Prints detailed information about analyzing each table at
+      <literal>INFO</literal> level.
      </para>
     </listitem>
    </varlistentry>
diff --git a/doc/src/sgml/ref/vacuum.sgml b/doc/src/sgml/ref/vacuum.sgml
index bd5dcaf86a5..b89e7e32915 100644
--- a/doc/src/sgml/ref/vacuum.sgml
+++ b/doc/src/sgml/ref/vacuum.sgml
@@ -129,8 +129,8 @@ VACUUM [ ( <replaceable class="parameter">option</replaceable> [, ...] ) ] [ <re
     <term><literal>VERBOSE</literal></term>
     <listitem>
      <para>
-      Prints a detailed vacuum activity report for each table
-      at <literal>INFO</literal> level.
+      Prints detailed information about vacuuming each table at
+      <literal>INFO</literal> level.
      </para>
     </listitem>
    </varlistentry>
-- 
2.47.3