public inbox for [email protected]
help / color / mirror / Atom feedFrom: Shinya Kato <[email protected]>
To: Fujii Masao <[email protected]>
Cc: solai v <[email protected]>
Cc: [email protected]
Cc: surya poondla <[email protected]>
Cc: [email protected]
Subject: Re: doc: Clarify ANALYZE VERBOSE output
Date: Fri, 10 Jul 2026 17:24:51 +0900
Message-ID: <CAOzEurSVe1isqOUbHp3AayQqC_KbRkayo1hQopPpG47HTA_weQ@mail.gmail.com> (raw)
In-Reply-To: <CAHGQGwGrhW=_aEmyfosuByc6zVfzJjmrBaPc=aUqHEv0WA+b_Q@mail.gmail.com>
References: <CAOzEurTpMTUEW8kHu-zKB0EBtuPfpvyoJ--8pxKe87p24BGrpg@mail.gmail.com>
<CAOVWO5ov8_JR5Tj2J6cXPZF9cPM3P4w3yhVM9=NeiDMqY3t_PA@mail.gmail.com>
<CAOtHd0CEvKrPnOx6_nv--R5sRwg47QqbrQG6P_2D0QQwxO9rcg@mail.gmail.com>
<CAOzEurTyYgcPFAJGp5=BF9gObqgs8neQOvWo0g+txJMA8deYyw@mail.gmail.com>
<CAF0whuck9AqLeS=kZCpRBEWmRBhw17gVPkwkk6nKruZdyrcKDA@mail.gmail.com>
<CAHGQGwGrhW=_aEmyfosuByc6zVfzJjmrBaPc=aUqHEv0WA+b_Q@mail.gmail.com>
On Fri, Jul 3, 2026 at 7:19 PM Fujii Masao <[email protected]> wrote:
> - 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.
>
> I'm not keen on "Sends ..." here. The fact that INFO messages are
> sent to the client is already implied by the message level itself, so
> mentioning the destination in these option descriptions seems
> unnecessary.
>
> I'd vote something like:
>
> ANALYZE:
> Prints detailed information about analyzing each table at INFO level.
>
> VACUUM:
> Prints detailed information about vacuuming each table at INFO level.
Agreed. I've updated the patch.
--
Best regards,
Shinya Kato
NTT OSS Center
Attachments:
[application/octet-stream] v3-0001-doc-Clarify-VERBOSE-output-for-ANALYZE-and-VACUUM.patch (2.2K, ../CAOzEurSVe1isqOUbHp3AayQqC_KbRkayo1hQopPpG47HTA_weQ@mail.gmail.com/2-v3-0001-doc-Clarify-VERBOSE-output-for-ANALYZE-and-VACUUM.patch)
download | inline diff:
From 8ea5528d83d43d6fabedffd0636e9f481c079a0f Mon Sep 17 00:00:00 2001
From: Shinya Kato <[email protected]>
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 <[email protected]>
Reviewed-by: Maciek Sakrejda <[email protected]>
Reviewed-by: Fujii Masao <[email protected]>
Reviewed-by: David G. Johnston <[email protected]>
Reviewed-by: Surya Poondla <[email protected]>
Reviewed-by: Yushu Chen <[email protected]>
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
view thread (17+ messages)
reply
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: [email protected]
Cc: [email protected], [email protected], [email protected], [email protected], [email protected], [email protected]
Subject: Re: doc: Clarify ANALYZE VERBOSE output
In-Reply-To: <CAOzEurSVe1isqOUbHp3AayQqC_KbRkayo1hQopPpG47HTA_weQ@mail.gmail.com>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox