Re: [PATCH] Docs: clarify default values of EXPLAIN BUFFERS and SERIALIZE

From: Fujii Masao <masao(dot)fujii(at)gmail(dot)com>
To: Matsumura, Ryo/松村 量 <matsumura(dot)ryo(at)fujitsu(dot)com>
Cc: PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: [PATCH] Docs: clarify default values of EXPLAIN BUFFERS and SERIALIZE
Date: 2026-03-17 15:34:26
Message-ID: CAHGQGwFW984Jsx52tNgOn7tpa7OEkqoA90O2HdzOMs7mBEmGUQ@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Tue, Mar 17, 2026 at 7:26 PM Matsumura, Ryo/松村 量
<matsumura(dot)ryo(at)fujitsu(dot)com> wrote:
>
> On Mon, Mar 16, 2026 at 10:30:00 +0000, Fujii Masao <masao(dot)fujii(at)gmail(dot)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 Content-Type Size
v4-0001-doc-Clarify-BUFFERS-behavior-without-ANALYZE-in-E.patch application/octet-stream 1.5 KB

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Jacob Champion 2026-03-17 15:38:01 Re: Improve OAuth discovery logging
Previous Message Andrew Dunstan 2026-03-17 15:32:02 Re: finish TODOs in to_json_is_immutable, to_jsonb_is_immutable also add tests on it