Re: doc: Clarify ANALYZE VERBOSE output

Shinya Kato <shinya11.kato@gmail.com>

From: Shinya Kato <shinya11.kato@gmail.com>
To: "David G. Johnston" <david.g.johnston@gmail.com>
Cc: Fujii Masao <masao.fujii@gmail.com>, maciek@sakrejda.org, pgsql-docs@lists.postgresql.org
Date: 2026-04-08T01:49:24Z
Lists: pgsql-docs
On Mon, Apr 6, 2026, 14:17 David G. Johnston <david.g.johnston@gmail.com>
wrote:

>
> How about something like:
> “Enables sending an INFO message to the client (and server log) as each
> table is processed.  This message contains: etc…”
>
> And then let’s tell the user what info they are getting and what it means
> (where necessary).
>
> I concur being specific about when these messages arrive, and IMO where,
> should be specified.  But losing the detail of “report” is not good; but
> not sure why we are being vague so suggest we just go all-in on specificity.
>

Thank you for the suggestion. I'd prefer to keep this patch focused; since
the verbose output of both commands is subject to change, listing every
individual field in the documentation would require frequent updates.

​I believe the current "Outputs" section is intentionally kept simple to
minimize maintenance overhead. While expanding it might be a worthwhile
follow-up, it probably deserves its own dedicated discussion.

--
Shinya Kato

>