MIME-Version: 1.0
References: 
 <CAOzEurTpMTUEW8kHu-zKB0EBtuPfpvyoJ--8pxKe87p24BGrpg@mail.gmail.com>
In-Reply-To: 
 <CAOzEurTpMTUEW8kHu-zKB0EBtuPfpvyoJ--8pxKe87p24BGrpg@mail.gmail.com>
Reply-To: maciek@sakrejda.org
From: Maciek Sakrejda <m.sakrejda@gmail.com>
Date: Sun, 5 Apr 2026 11:08:01 -0700
Message-ID: 
 <CAOtHd0AY4LuM+-JqFyzs4mPHG8yeAwfP5yr2EZg21RVO0442BA@mail.gmail.com>
Subject: Re: doc: Clarify ANALYZE VERBOSE output
To: Shinya Kato <shinya11.kato@gmail.com>
Cc: pgsql-docs@lists.postgresql.org
Content-Type: multipart/mixed; boundary="0000000000007aaad8064eba7592"
Archived-At: 
 <https://www.postgresql.org/message-id/CAOtHd0AY4LuM%2B-JqFyzs4mPHG8yeAwfP5yr2EZg21RVO0442BA%40mail.gmail.com>
Precedence: bulk

--0000000000007aaad8064eba7592
Content-Type: text/plain; charset="UTF-8"

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.

--0000000000007aaad8064eba7592
Content-Type: text/x-patch; charset="US-ASCII";
	name="v1-0001-doc-Clarify-VACUUM-VERBOSE-and-ANALYZE-VERBOSE-outpu.patch"
Content-Disposition: attachment;
	filename="v1-0001-doc-Clarify-VACUUM-VERBOSE-and-ANALYZE-VERBOSE-outpu.patch"
Content-Transfer-Encoding: base64
Content-ID: <f_mnm2n2cd0>
X-Attachment-Id: f_mnm2n2cd0

RnJvbSA3NzUzZmI4NmJiYTliYWVlOGU1OTliNGU0YTZiMmU3MjhlYmQ1Mjc5IE1vbiBTZXAgMTcg
MDA6MDA6MDAgMjAwMQpGcm9tOiBTaGlueWEgS2F0byA8c2hpbnlhMTEua2F0b0BnbWFpbC5jb20+
CkRhdGU6IEZyaSwgMzEgT2N0IDIwMjUgMTY6MDY6NDIgKzA5MDAKU3ViamVjdDogW1BBVENIXSBk
b2M6IENsYXJpZnkgVkFDVVVNIFZFUkJPU0UgYW5kIEFOQUxZWkUgVkVSQk9TRSBvdXRwdXQKClZB
Q1VVTSBWRVJCT1NFIGFuZCBBTkFMWVpFIFZFUkJPU0UgYm90aCBlbWl0IGRldGFpbGVkIHBlci10
YWJsZSBJTkZPCmxldmVsIHByb2dyZXNzLiBUaGUgZG9jdW1lbnRhdGlvbiBjdXJyZW50bHkgY2Fs
bHMgdGhlc2UgInJlcG9ydHMiLCBidXQKY29tbXVuaWNhdGluZyBwcm9ncmVzcyBpcyBhbiBpbXBv
cnRhbnQgZnVuY3Rpb24gb2YgdGhpcyBmZWF0dXJlIGFuZAp0aGUgZG9jdW1lbnRhdGlvbiBzaG91
bGQgcmVmbGVjdCB0aGF0LgotLS0KIGRvYy9zcmMvc2dtbC9yZWYvYW5hbHl6ZS5zZ21sIHwgMiAr
LQogZG9jL3NyYy9zZ21sL3JlZi92YWN1dW0uc2dtbCAgfCAzICstLQogMiBmaWxlcyBjaGFuZ2Vk
LCAyIGluc2VydGlvbnMoKyksIDMgZGVsZXRpb25zKC0pCgpkaWZmIC0tZ2l0IGEvZG9jL3NyYy9z
Z21sL3JlZi9hbmFseXplLnNnbWwgYi9kb2Mvc3JjL3NnbWwvcmVmL2FuYWx5emUuc2dtbAppbmRl
eCBlYzgxZjAwZmVjZi4uZDk5YjRmMmViNmQgMTAwNjQ0Ci0tLSBhL2RvYy9zcmMvc2dtbC9yZWYv
YW5hbHl6ZS5zZ21sCisrKyBiL2RvYy9zcmMvc2dtbC9yZWYvYW5hbHl6ZS5zZ21sCkBAIC02NSw3
ICs2NSw3IEBAIEFOQUxZWkUgWyAoIDxyZXBsYWNlYWJsZSBjbGFzcz0icGFyYW1ldGVyIj5vcHRp
b248L3JlcGxhY2VhYmxlPiBbLCAuLi5dICkgXSBbIDxyCiAgICAgPHRlcm0+PGxpdGVyYWw+VkVS
Qk9TRTwvbGl0ZXJhbD48L3Rlcm0+CiAgICAgPGxpc3RpdGVtPgogICAgICA8cGFyYT4KLSAgICAg
IEVuYWJsZXMgZGlzcGxheSBvZiBwcm9ncmVzcyBtZXNzYWdlcyBhdCA8bGl0ZXJhbD5JTkZPPC9s
aXRlcmFsPiBsZXZlbC4KKyAgICAgIFByaW50cyBkZXRhaWxlZCBwcm9ncmVzcyBmb3IgZWFjaCB0
YWJsZSBhdCA8bGl0ZXJhbD5JTkZPPC9saXRlcmFsPiBsZXZlbC4KICAgICAgPC9wYXJhPgogICAg
IDwvbGlzdGl0ZW0+CiAgICA8L3Zhcmxpc3RlbnRyeT4KZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dt
bC9yZWYvdmFjdXVtLnNnbWwgYi9kb2Mvc3JjL3NnbWwvcmVmL3ZhY3V1bS5zZ21sCmluZGV4IGFj
NWQwODNkNDY4Li45OTRkYTc3N2Q5YSAxMDA2NDQKLS0tIGEvZG9jL3NyYy9zZ21sL3JlZi92YWN1
dW0uc2dtbAorKysgYi9kb2Mvc3JjL3NnbWwvcmVmL3ZhY3V1bS5zZ21sCkBAIC0xMTUsOCArMTE1
LDcgQEAgVkFDVVVNIFsgKCA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+b3B0aW9uPC9y
ZXBsYWNlYWJsZT4gWywgLi4uXSApIF0gWyA8cmUKICAgICA8dGVybT48bGl0ZXJhbD5WRVJCT1NF
PC9saXRlcmFsPjwvdGVybT4KICAgICA8bGlzdGl0ZW0+CiAgICAgIDxwYXJhPgotICAgICAgUHJp
bnRzIGEgZGV0YWlsZWQgdmFjdXVtIGFjdGl2aXR5IHJlcG9ydCBmb3IgZWFjaCB0YWJsZQotICAg
ICAgYXQgPGxpdGVyYWw+SU5GTzwvbGl0ZXJhbD4gbGV2ZWwuCisgICAgICBQcmludHMgZGV0YWls
ZWQgcHJvZ3Jlc3MgZm9yIGVhY2ggdGFibGUgYXQgPGxpdGVyYWw+SU5GTzwvbGl0ZXJhbD4gbGV2
ZWwuCiAgICAgIDwvcGFyYT4KICAgICA8L2xpc3RpdGVtPgogICAgPC92YXJsaXN0ZW50cnk+Ci0t
IAoyLjQzLjAKCg==
--0000000000007aaad8064eba7592--