MIME-Version: 1.0
References: 
 <CAOzEurTpMTUEW8kHu-zKB0EBtuPfpvyoJ--8pxKe87p24BGrpg@mail.gmail.com>
 <CAOtHd0AY4LuM+-JqFyzs4mPHG8yeAwfP5yr2EZg21RVO0442BA@mail.gmail.com>
 <CAHGQGwE2dC5aNBgV5AtpMMdZNpkGn1PAa9o=whi8_Wb3m3ruAA@mail.gmail.com>
 <CAKFQuwZUSetJvoXewwofTNP5dLfhg7S31NNJhZ=G+ZbOOCZ=ug@mail.gmail.com>
In-Reply-To: 
 <CAKFQuwZUSetJvoXewwofTNP5dLfhg7S31NNJhZ=G+ZbOOCZ=ug@mail.gmail.com>
From: Shinya Kato <shinya11.kato@gmail.com>
Date: Wed, 8 Apr 2026 10:49:24 +0900
Message-ID: 
 <CAOzEurS7aNO=TnZztwnxJdLgmNnmotwcocxVR2s4qLrZ66ZkxQ@mail.gmail.com>
Subject: Re: doc: Clarify ANALYZE VERBOSE output
To: "David G. Johnston" <david.g.johnston@gmail.com>
Cc: Fujii Masao <masao.fujii@gmail.com>, maciek@sakrejda.org,
	pgsql-docs@lists.postgresql.org
Content-Type: multipart/alternative; boundary="000000000000357259064ee9390b"
Archived-At: 
 <https://www.postgresql.org/message-id/CAOzEurS7aNO%3DTnZztwnxJdLgmNnmotwcocxVR2s4qLrZ66ZkxQ%40mail.gmail.com>
Precedence: bulk

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

On Mon, Apr 6, 2026, 14:17 David G. Johnston <david.g.johnston@gmail.com>
wrote:

>
> How about something like:
> =E2=80=9CEnables sending an INFO message to the client (and server log) a=
s each
> table is processed.  This message contains: etc=E2=80=A6=E2=80=9D
>
> And then let=E2=80=99s 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 =E2=80=9Creport=E2=80=9D i=
s not good; but
> not sure why we are being vague so suggest we just go all-in on specifici=
ty.
>

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.

=E2=80=8BI believe the current "Outputs" section is intentionally kept simp=
le to
minimize maintenance overhead. While expanding it might be a worthwhile
follow-up, it probably deserves its own dedicated discussion.

--
Shinya Kato

>

--000000000000357259064ee9390b
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"auto"><br><br><div class=3D"gmail_quote gmail_quote_container" =
dir=3D"auto"><div dir=3D"ltr" class=3D"gmail_attr">On Mon, Apr 6, 2026, 14:=
17 David G. Johnston &lt;<a href=3D"mailto:david.g.johnston@gmail.com">davi=
d.g.johnston@gmail.com</a>&gt; wrote:</div><blockquote class=3D"gmail_quote=
" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><=
div><br></div><div>How about something like:</div><div>=E2=80=9CEnables sen=
ding an INFO message to the client (and server log) as each table is proces=
sed.=C2=A0 This message contains: etc=E2=80=A6=E2=80=9D</div><div><br></div=
><div>And then let=E2=80=99s tell the user what info they are getting and w=
hat it means (where necessary).</div><div><br></div><div>I concur being spe=
cific about when these messages arrive, and IMO where, should be specified.=
=C2=A0 But losing the detail of =E2=80=9Creport=E2=80=9D is not good; but n=
ot sure why we are being vague so suggest we just go all-in on specificity.=
</div></blockquote></div><div dir=3D"auto"><br></div><div dir=3D"auto">Than=
k you for the suggestion. I&#39;d prefer to keep this patch focused; since =
the verbose output of both commands is subject to change, listing every ind=
ividual field in the documentation would require frequent updates.</div><di=
v dir=3D"auto"><br></div><div dir=3D"auto">=E2=80=8BI believe the current &=
quot;Outputs&quot; section is intentionally kept simple to minimize mainten=
ance overhead. While expanding it might be a worthwhile follow-up, it proba=
bly deserves its own dedicated discussion.</div><div dir=3D"auto"><br></div=
><div dir=3D"auto">--</div><div dir=3D"auto">Shinya Kato</div><div class=3D=
"gmail_quote gmail_quote_container" dir=3D"auto"><blockquote class=3D"gmail=
_quote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:=
1ex">
</blockquote></div></div>

--000000000000357259064ee9390b--