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

From Shinya Kato
Subject Re: doc: Clarify ANALYZE VERBOSE output
Date
Msg-id CAOzEurS7aNO=TnZztwnxJdLgmNnmotwcocxVR2s4qLrZ66ZkxQ@mail.gmail.com
Whole thread
In response to Re: doc: Clarify ANALYZE VERBOSE output  ("David G. Johnston" <david.g.johnston@gmail.com>)
Responses Re: doc: Clarify ANALYZE VERBOSE output
List 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

pgsql-docs by date:

Previous
From: Dapeng Wang
Date:
Subject: doc: add examples section to earthdistance documentation
Next
From: Fujii Masao
Date:
Subject: Clarify log_parameter_max_length docs regarding log_min_duration_statement vs log_duration