Re: doc: Clarify ANALYZE VERBOSE output - Mailing list pgsql-docs

From Fujii Masao
Subject Re: doc: Clarify ANALYZE VERBOSE output
Date
Msg-id CAHGQGwE2dC5aNBgV5AtpMMdZNpkGn1PAa9o=whi8_Wb3m3ruAA@mail.gmail.com
Whole thread
In response to Re: doc: Clarify ANALYZE VERBOSE output  (Maciek Sakrejda <m.sakrejda@gmail.com>)
Responses Re: doc: Clarify ANALYZE VERBOSE output
List pgsql-docs
On Mon, Apr 6, 2026 at 3:10 AM Maciek Sakrejda <m.sakrejda@gmail.com> wrote:
>
> It makes sense to align these, but I think the existing VACUUM wording
> is not great. What do you think about something like the attached?
> Basically, I changed both option descriptions to just be
>
>   Prints detailed progress for each table at <literal>INFO</literal> level.
>
> I think the idea of _progress_ is important to communicate here. The
> word "report" suggests more detailed information, that comes in a
> batch after the action is completed.

Referring to it only as "progress" seems like a step backward, doesn't it?
The VERBOSE option reports per-table activity details (e.g., pages to scan,
buffer usage), not just progress.

Since these details are shown for each table, they can also serve as progress
indicators, but they're more than that.

If that understanding is correct, the existing term "vacuum activity report"
seems more appropriate to me. Thought?

Regards,


--
Fujii Masao



pgsql-docs by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: issue in the doc
Next
From: "David G. Johnston"
Date:
Subject: Re: doc: Clarify ANALYZE VERBOSE output