Re: doc: Clarify ANALYZE VERBOSE output
Maciek Sakrejda <m.sakrejda@gmail.com>
From: Maciek Sakrejda <m.sakrejda@gmail.com>
To: surya poondla <suryapoondla4@gmail.com>
Cc: Shinya Kato <shinya11.kato@gmail.com>, pgsql-docs@lists.postgresql.org
Date: 2026-05-11T20:12:55Z
Lists: pgsql-docs
On Tue, May 5, 2026 at 4:26 PM surya poondla <suryapoondla4@gmail.com> wrote:
> On the wording debate: I think David and Maciek are both pointing at
> the same real issue, the description should convey (a) "what kind of
> information" users will see, and (b) "when" they'll see it.
>
> Given that, I'd suggest leaning toward something like:
> "Sends a detailed INFO message to the client for each table as it is processed."
>
> I feel with the above message we balance, the server's perspective ("sends" rather than "prints"), and conveys timing ("after each table is processed").
I agree with the analysis, and I think the proposed wording works well.
> This same phrasing could work for both VACUUM and ANALYZE VERBOSE, keeping them consistent.
+1 for consistency.