Re: [PATCH] Docs: clarify default values of EXPLAIN BUFFERS and SERIALIZE - Mailing list pgsql-hackers

From Fujii Masao
Subject Re: [PATCH] Docs: clarify default values of EXPLAIN BUFFERS and SERIALIZE
Date
Msg-id CAHGQGwFW984Jsx52tNgOn7tpa7OEkqoA90O2HdzOMs7mBEmGUQ@mail.gmail.com
Whole thread Raw
In response to Re: [PATCH] Docs: clarify default values of EXPLAIN BUFFERS and SERIALIZE  (Matsumura, Ryo/松村 量 <matsumura.ryo@fujitsu.com>)
Responses Re: [PATCH] Docs: clarify default values of EXPLAIN BUFFERS and SERIALIZE
List pgsql-hackers
On Tue, Mar 17, 2026 at 7:26 PM Matsumura, Ryo/松村 量
<matsumura.ryo@fujitsu.com> wrote:
>
> On Mon, Mar 16, 2026 at 10:30:00 +0000, Fujii Masao <masao.fujii@gmail.com> wrote:
> > Isn't the existing description "In text format, only non-zero values
> > are printed." sufficient?
>
> This description is sufficient. It was a careless mistake on my part. Sorry about that.
>
> I’ve attached a revised patch.

Thanks for updating the patch!

Since the docs already state that buffer usage is automatically included
when ANALYZE is used, the focus here seems to be clarifying the behavior
of BUFFERS without ANALYZE. From that perspective, it might be better to
explicitly describe what happens when BUFFERS is TRUE without ANALYZE.

I've updated the patch accordingly. Patch attached. Thought?

Regards,

--
Fujii Masao

Attachment

pgsql-hackers by date:

Previous
From: Andrew Dunstan
Date:
Subject: Re: finish TODOs in to_json_is_immutable, to_jsonb_is_immutable also add tests on it
Next
From: Jacob Champion
Date:
Subject: Re: Improve OAuth discovery logging