MIME-Version: 1.0
References: 
 <CAOzEurTpMTUEW8kHu-zKB0EBtuPfpvyoJ--8pxKe87p24BGrpg@mail.gmail.com>
 <CAOVWO5ov8_JR5Tj2J6cXPZF9cPM3P4w3yhVM9=NeiDMqY3t_PA@mail.gmail.com>
 <CAOtHd0CEvKrPnOx6_nv--R5sRwg47QqbrQG6P_2D0QQwxO9rcg@mail.gmail.com>
In-Reply-To: 
 <CAOtHd0CEvKrPnOx6_nv--R5sRwg47QqbrQG6P_2D0QQwxO9rcg@mail.gmail.com>
From: Shinya Kato <shinya11.kato@gmail.com>
Date: Thu, 14 May 2026 21:14:27 +0900
Message-ID: 
 <CAOzEurTyYgcPFAJGp5=BF9gObqgs8neQOvWo0g+txJMA8deYyw@mail.gmail.com>
Subject: Re: doc: Clarify ANALYZE VERBOSE output
To: maciek@sakrejda.org
Cc: surya poondla <suryapoondla4@gmail.com>, pgsql-docs@lists.postgresql.org
Content-Type: multipart/mixed; boundary="000000000000db07d30651c60b90"
Archived-At: 
 <https://www.postgresql.org/message-id/CAOzEurTyYgcPFAJGp5%3DBF9gObqgs8neQOvWo0g%2BtxJMA8deYyw%40mail.gmail.com>
Precedence: bulk

--000000000000db07d30651c60b90
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Tue, May 12, 2026 at 5:15=E2=80=AFAM Maciek Sakrejda <m.sakrejda@gmail.c=
om> wrote:
>
> On Tue, May 5, 2026 at 4:26=E2=80=AFPM 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 pr=
ocessed."
> >
> > I feel with the above message we balance, the server's perspective ("se=
nds" rather than "prints"), and conveys timing ("after each table is proces=
sed").
>
> I agree with the analysis, and I think the proposed wording works well.
>
> > This same phrasing could work for both VACUUM and ANALYZE VERBOSE, keep=
ing them consistent.
>
> +1 for consistency.

Sorry for the delayed response, and thank you for the feedback. I
agree with the points raised, so I have updated the patch accordingly.

--=20
Best regards,
Shinya Kato
NTT OSS Center

--000000000000db07d30651c60b90
Content-Type: application/octet-stream;
	name="v2-0001-doc-Clarify-VERBOSE-output-for-ANALYZE-and-VACUUM.patch"
Content-Disposition: attachment;
	filename="v2-0001-doc-Clarify-VERBOSE-output-for-ANALYZE-and-VACUUM.patch"
Content-Transfer-Encoding: base64
Content-ID: <f_mp5gaenf0>
X-Attachment-Id: f_mp5gaenf0

RnJvbSA3MWI0ODc4OTE4YWJmODkxNWM3Y2JmZWEyNGI5MDY2OGE3OTNjNjFlIE1vbiBTZXAgMTcg
MDA6MDA6MDAgMjAwMQpGcm9tOiBTaGlueWEgS2F0byA8c2hpbnlhMTEua2F0b0BnbWFpbC5jb20+
CkRhdGU6IFRodSwgMTQgTWF5IDIwMjYgMjE6MTI6MDQgKzA5MDAKU3ViamVjdDogW1BBVENIIHYy
XSBkb2M6IENsYXJpZnkgVkVSQk9TRSBvdXRwdXQgZm9yIEFOQUxZWkUgYW5kIFZBQ1VVTQoKQU5B
TFlaRSBWRVJCT1NFIGVtaXRzIGEgZGV0YWlsZWQgcGVyLXRhYmxlIElORk8gbGV2ZWwgcmVwb3J0
LCBsaWtlClZBQ1VVTSBWRVJCT1NFLiAgUmV3b3JkIGJvdGggb3B0aW9uIGRlc2NyaXB0aW9ucyB0
byBjb252ZXkgdGhlCnNlcnZlcidzIHBlcnNwZWN0aXZlICgic2VuZHMiIHJhdGhlciB0aGFuICJw
cmludHMiKSBhbmQgdG8gY2xhcmlmeQp0aGUgdGltaW5nIG9mIHRoZSBvdXRwdXQuICBVc2UgaWRl
bnRpY2FsIHdvcmRpbmcgZm9yIHRoZSB0d28gY29tbWFuZHMKZm9yIGNvbnNpc3RlbmN5LgoKQXV0
aG9yOiBTaGlueWEgS2F0byA8c2hpbnlhMTEua2F0b0BnbWFpbC5jb20+ClJldmlld2VkLWJ5OiBN
YWNpZWsgU2FrcmVqZGEgPG0uc2FrcmVqZGFAZ21haWwuY29tPgpSZXZpZXdlZC1ieTogRnVqaWkg
TWFzYW8gPG1hc2FvLmZ1amlpQGdtYWlsLmNvbT4KUmV2aWV3ZWQtYnk6IERhdmlkIEcuIEpvaG5z
dG9uIDxkYXZpZC5nLmpvaG5zdG9uQGdtYWlsLmNvbT4KUmV2aWV3ZWQtYnk6IFN1cnlhIFBvb25k
bGEgPHN1cnlhcG9vbmRsYTRAZ21haWwuY29tPgpSZXZpZXdlZC1ieTogWXVzaHUgQ2hlbiA8Z2Vu
dGN5c0BnbWFpbC5jb20+CkRpc2N1c3Npb246IGh0dHBzOi8vcG9zdGdyLmVzL20vQ0FPekV1clRw
TVRVRVc4a0h1LXpLQjBFQnR1UGZwdnlvSi0tOHB4S2U4N3AyNEJHcnBnQG1haWwuZ21haWwuY29t
Ci0tLQogZG9jL3NyYy9zZ21sL3JlZi9hbmFseXplLnNnbWwgfCAzICsrLQogZG9jL3NyYy9zZ21s
L3JlZi92YWN1dW0uc2dtbCAgfCA0ICsrLS0KIDIgZmlsZXMgY2hhbmdlZCwgNCBpbnNlcnRpb25z
KCspLCAzIGRlbGV0aW9ucygtKQoKZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9yZWYvYW5hbHl6
ZS5zZ21sIGIvZG9jL3NyYy9zZ21sL3JlZi9hbmFseXplLnNnbWwKaW5kZXggZWM4MWYwMGZlY2Yu
LmFlZTdhNGY1NjBkIDEwMDY0NAotLS0gYS9kb2Mvc3JjL3NnbWwvcmVmL2FuYWx5emUuc2dtbAor
KysgYi9kb2Mvc3JjL3NnbWwvcmVmL2FuYWx5emUuc2dtbApAQCAtNjUsNyArNjUsOCBAQCBBTkFM
WVpFIFsgKCA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+b3B0aW9uPC9yZXBsYWNlYWJs
ZT4gWywgLi4uXSApIF0gWyA8cgogICAgIDx0ZXJtPjxsaXRlcmFsPlZFUkJPU0U8L2xpdGVyYWw+
PC90ZXJtPgogICAgIDxsaXN0aXRlbT4KICAgICAgPHBhcmE+Ci0gICAgICBFbmFibGVzIGRpc3Bs
YXkgb2YgcHJvZ3Jlc3MgbWVzc2FnZXMgYXQgPGxpdGVyYWw+SU5GTzwvbGl0ZXJhbD4gbGV2ZWwu
CisgICAgICBTZW5kcyBhIGRldGFpbGVkIDxsaXRlcmFsPklORk88L2xpdGVyYWw+IG1lc3NhZ2Ug
dG8gdGhlIGNsaWVudAorICAgICAgZm9yIGVhY2ggdGFibGUgYXMgaXQgaXMgcHJvY2Vzc2VkLgog
ICAgICA8L3BhcmE+CiAgICAgPC9saXN0aXRlbT4KICAgIDwvdmFybGlzdGVudHJ5PgpkaWZmIC0t
Z2l0IGEvZG9jL3NyYy9zZ21sL3JlZi92YWN1dW0uc2dtbCBiL2RvYy9zcmMvc2dtbC9yZWYvdmFj
dXVtLnNnbWwKaW5kZXggYmQ1ZGNhZjg2YTUuLjA2ZjY0ZjM4MjdmIDEwMDY0NAotLS0gYS9kb2Mv
c3JjL3NnbWwvcmVmL3ZhY3V1bS5zZ21sCisrKyBiL2RvYy9zcmMvc2dtbC9yZWYvdmFjdXVtLnNn
bWwKQEAgLTEyOSw4ICsxMjksOCBAQCBWQUNVVU0gWyAoIDxyZXBsYWNlYWJsZSBjbGFzcz0icGFy
YW1ldGVyIj5vcHRpb248L3JlcGxhY2VhYmxlPiBbLCAuLi5dICkgXSBbIDxyZQogICAgIDx0ZXJt
PjxsaXRlcmFsPlZFUkJPU0U8L2xpdGVyYWw+PC90ZXJtPgogICAgIDxsaXN0aXRlbT4KICAgICAg
PHBhcmE+Ci0gICAgICBQcmludHMgYSBkZXRhaWxlZCB2YWN1dW0gYWN0aXZpdHkgcmVwb3J0IGZv
ciBlYWNoIHRhYmxlCi0gICAgICBhdCA8bGl0ZXJhbD5JTkZPPC9saXRlcmFsPiBsZXZlbC4KKyAg
ICAgIFNlbmRzIGEgZGV0YWlsZWQgPGxpdGVyYWw+SU5GTzwvbGl0ZXJhbD4gbWVzc2FnZSB0byB0
aGUgY2xpZW50CisgICAgICBmb3IgZWFjaCB0YWJsZSBhcyBpdCBpcyBwcm9jZXNzZWQuCiAgICAg
IDwvcGFyYT4KICAgICA8L2xpc3RpdGVtPgogICAgPC92YXJsaXN0ZW50cnk+Ci0tIAoyLjQ3LjMK
Cg==
--000000000000db07d30651c60b90--