Re: doc: Clarify ANALYZE VERBOSE output

From: Maciek Sakrejda <m(dot)sakrejda(at)gmail(dot)com>
To: Shinya Kato <shinya11(dot)kato(at)gmail(dot)com>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: doc: Clarify ANALYZE VERBOSE output
Date: 2026-04-05 18:08:01
Message-ID: CAOtHd0AY4LuM+-JqFyzs4mPHG8yeAwfP5yr2EZg21RVO0442BA@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

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.
Thanks,
Maciek

PS: I changed the patch name because I felt the original name is
misleading with my proposed change, and I left it at v1 because
starting a different name with v2 didn't make sense, but I'm not
trying to take authorship credit: most of the work here was finding
the discrepancy.

Attachment Content-Type Size
v1-0001-doc-Clarify-VACUUM-VERBOSE-and-ANALYZE-VERBOSE-outpu.patch text/x-patch 1.7 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Yousef Mohamed 2026-04-05 22:38:17 issue in the doc
Previous Message David G. Johnston 2026-04-04 16:04:23 Re: The CREATE TABLE documentation groups NOT NULL under table_constraint.