MIME-Version: 1.0
References: 
 <CAOzEurTpMTUEW8kHu-zKB0EBtuPfpvyoJ--8pxKe87p24BGrpg@mail.gmail.com>
 <CAOtHd0AY4LuM+-JqFyzs4mPHG8yeAwfP5yr2EZg21RVO0442BA@mail.gmail.com>
In-Reply-To: 
 <CAOtHd0AY4LuM+-JqFyzs4mPHG8yeAwfP5yr2EZg21RVO0442BA@mail.gmail.com>
From: Fujii Masao <masao.fujii@gmail.com>
Date: Mon, 6 Apr 2026 13:51:29 +0900
Message-ID: 
 <CAHGQGwE2dC5aNBgV5AtpMMdZNpkGn1PAa9o=whi8_Wb3m3ruAA@mail.gmail.com>
Subject: Re: doc: Clarify ANALYZE VERBOSE output
To: maciek@sakrejda.org
Cc: Shinya Kato <shinya11.kato@gmail.com>, pgsql-docs@lists.postgresql.org
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Archived-At: 
 <https://www.postgresql.org/message-id/CAHGQGwE2dC5aNBgV5AtpMMdZNpkGn1PAa9o%3Dwhi8_Wb3m3ruAA%40mail.gmail.com>
Precedence: bulk

On Mon, Apr 6, 2026 at 3:10=E2=80=AFAM Maciek Sakrejda <m.sakrejda@gmail.co=
m> wrote:
>
> 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> leve=
l.
>
> 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.

Referring to it only as "progress" seems like a step backward, doesn't it?
The VERBOSE option reports per-table activity details (e.g., pages to scan,
buffer usage), not just progress.

Since these details are shown for each table, they can also serve as progre=
ss
indicators, but they're more than that.

If that understanding is correct, the existing term "vacuum activity report=
"
seems more appropriate to me. Thought?

Regards,


--=20
Fujii Masao