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

From 71b4878918abf8915c7cbfea24b90668a793c61e Mon Sep 17 00:00:00 2001
From: Shinya Kato <shinya11.kato@gmail.com>
Date: Thu, 14 May 2026 21:12:04 +0900
Subject: [PATCH v2] doc: Clarify VERBOSE output for ANALYZE and VACUUM

ANALYZE VERBOSE emits a detailed per-table INFO level report, like
VACUUM VERBOSE.  Reword both option descriptions to convey the
server's perspective ("sends" rather than "prints") and to clarify
the timing of the output.  Use identical wording for the two commands
for consistency.

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..aee7a4f560d 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.
+      Sends a detailed <literal>INFO</literal> message to the client
+      for each table as it is processed.
      </para>
     </listitem>
    </varlistentry>
diff --git a/doc/src/sgml/ref/vacuum.sgml b/doc/src/sgml/ref/vacuum.sgml
index bd5dcaf86a5..06f64f3827f 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.
+      Sends a detailed <literal>INFO</literal> message to the client
+      for each table as it is processed.
      </para>
     </listitem>
    </varlistentry>
-- 
2.47.3