MIME-Version: 1.0
References: 
 <TYRPR01MB13457D31085CB5B246DBBA1AFE845A@TYRPR01MB13457.jpnprd01.prod.outlook.com>
 <CAHGQGwFpmEg2WgjgLLNbDBimmZ23krS2Q4FHR=0NJU2CZxvF_Q@mail.gmail.com>
 <TYRPR01MB134578C74066239A8281B9308E840A@TYRPR01MB13457.jpnprd01.prod.outlook.com>
 <CAHGQGwHEHX8n_SPK2fy8FdVtEJsAtQBZypsBiucPcAAaNYqEog@mail.gmail.com>
 <TYRPR01MB134577510E2A2EB3947E821BEE841A@TYRPR01MB13457.jpnprd01.prod.outlook.com>
In-Reply-To: 
 <TYRPR01MB134577510E2A2EB3947E821BEE841A@TYRPR01MB13457.jpnprd01.prod.outlook.com>
From: Fujii Masao <masao.fujii@gmail.com>
Date: Wed, 18 Mar 2026 00:34:26 +0900
Message-ID: 
 <CAHGQGwFW984Jsx52tNgOn7tpa7OEkqoA90O2HdzOMs7mBEmGUQ@mail.gmail.com>
Subject: Re: [PATCH] Docs: clarify default values of EXPLAIN BUFFERS and
 SERIALIZE
To: =?UTF-8?B?TWF0c3VtdXJhLCBSeW8v5p2+5p2RIOmHjw==?=
 <matsumura.ryo@fujitsu.com>
Cc: PostgreSQL-development <pgsql-hackers@postgresql.org>
Content-Type: multipart/mixed; boundary="000000000000c79d9c064d3a121d"
Archived-At: 
 <https://www.postgresql.org/message-id/CAHGQGwFW984Jsx52tNgOn7tpa7OEkqoA90O2HdzOMs7mBEmGUQ%40mail.gmail.com>
Precedence: bulk

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

On Tue, Mar 17, 2026 at 7:26=E2=80=AFPM Matsumura, Ryo/=E6=9D=BE=E6=9D=91 =
=E9=87=8F
<matsumura.ryo@fujitsu.com> wrote:
>
> On Mon, Mar 16, 2026 at 10:30:00 +0000, Fujii Masao <masao.fujii@gmail.co=
m> 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. Sor=
ry about that.
>
> I=E2=80=99ve 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,

--=20
Fujii Masao

--000000000000c79d9c064d3a121d
Content-Type: application/octet-stream;
	name="v4-0001-doc-Clarify-BUFFERS-behavior-without-ANALYZE-in-E.patch"
Content-Disposition: attachment;
	filename="v4-0001-doc-Clarify-BUFFERS-behavior-without-ANALYZE-in-E.patch"
Content-Transfer-Encoding: base64
Content-ID: <f_mmurwamt0>
X-Attachment-Id: f_mmurwamt0

RnJvbSA3N2YxNmE3ZjVmNjM0OGU4MDQxMWIyYjdhNDQyMWIwOTRiZTk1NDM0IE1vbiBTZXAgMTcg
MDA6MDA6MDAgMjAwMQpGcm9tOiBGdWppaSBNYXNhbyA8ZnVqaWlAcG9zdGdyZXNxbC5vcmc+CkRh
dGU6IFR1ZSwgMTcgTWFyIDIwMjYgMjM6MTc6NDkgKzA5MDAKU3ViamVjdDogW1BBVENIIHY0XSBk
b2M6IENsYXJpZnkgQlVGRkVSUyBiZWhhdmlvciB3aXRob3V0IEFOQUxZWkUgaW4gRVhQTEFJTgoK
VGhpcyBjb21taXQgY2xhcmlmaWVzIHRoZSBkb2N1bWVudGF0aW9uIGZvciB0aGUgQlVGRkVSUyBv
cHRpb24gb2YgRVhQTEFJTgpieSBleHBsaWNpdGx5IGRlc2NyaWJpbmcgaXRzIGJlaGF2aW9yIHdo
ZW4gQU5BTFlaRSBpcyBub3Qgc3BlY2lmaWVkLgoKQXV0aG9yOiBSeW8gTWF0c3VtdXJhIDxtYXRz
dW11cmEucnlvQGZ1aml0c3UuY29tPgpSZXZpZXdlZC1ieTogRnVqaWkgTWFzYW8gPG1hc2FvLmZ1
amlpQGdtYWlsLmNvbT4KRGlzY3Vzc2lvbjogaHR0cHM6Ly9wb3N0Z3IuZXMvbS9UWVJQUjAxTUIx
MzQ1N0QzMTA4NUNCNUIyNDZEQkJBMUFGRTg0NUFAVFlSUFIwMU1CMTM0NTcuanBucHJkMDEucHJv
ZC5vdXRsb29rLmNvbQotLS0KIGRvYy9zcmMvc2dtbC9yZWYvZXhwbGFpbi5zZ21sIHwgNSArKysr
LQogMSBmaWxlIGNoYW5nZWQsIDQgaW5zZXJ0aW9ucygrKSwgMSBkZWxldGlvbigtKQoKZGlmZiAt
LWdpdCBhL2RvYy9zcmMvc2dtbC9yZWYvZXhwbGFpbi5zZ21sIGIvZG9jL3NyYy9zZ21sL3JlZi9l
eHBsYWluLnNnbWwKaW5kZXggN2RlZTc3ZmQzNjYuLjViOGI1MjE4MDJlIDEwMDY0NAotLS0gYS9k
b2Mvc3JjL3NnbWwvcmVmL2V4cGxhaW4uc2dtbAorKysgYi9kb2Mvc3JjL3NnbWwvcmVmL2V4cGxh
aW4uc2dtbApAQCAtMjAyLDcgKzIwMiwxMCBAQCBST0xMQkFDSzsKICAgICAgIFRoZSBudW1iZXIg
b2YgYmxvY2tzIHNob3duIGZvciBhbgogICAgICAgdXBwZXItbGV2ZWwgbm9kZSBpbmNsdWRlcyB0
aG9zZSB1c2VkIGJ5IGFsbCBpdHMgY2hpbGQgbm9kZXMuICBJbiB0ZXh0CiAgICAgICBmb3JtYXQs
IG9ubHkgbm9uLXplcm8gdmFsdWVzIGFyZSBwcmludGVkLiAgQnVmZmVycyBpbmZvcm1hdGlvbiBp
cwotICAgICAgYXV0b21hdGljYWxseSBpbmNsdWRlZCB3aGVuIDxsaXRlcmFsPkFOQUxZWkU8L2xp
dGVyYWw+IGlzIHVzZWQuCisgICAgICBpbmNsdWRlZCBieSBkZWZhdWx0IHdoZW4gPGxpdGVyYWw+
QU5BTFlaRTwvbGl0ZXJhbD4gaXMgdXNlZCBidXQKKyAgICAgIG90aGVyd2lzZSBpcyBub3QgaW5j
bHVkZWQgYnkgZGVmYXVsdC4gIFdoZW4gdGhpcyBwYXJhbWV0ZXIgaXMKKyAgICAgIDxsaXRlcmFs
PlRSVUU8L2xpdGVyYWw+IHdpdGhvdXQgPGxpdGVyYWw+QU5BTFlaRTwvbGl0ZXJhbD4sCisgICAg
ICBvbmx5IGJ1ZmZlciB1c2FnZSBkdXJpbmcgdGhlIHF1ZXJ5IHBsYW5uaW5nIHBoYXNlIGlzIHJl
cG9ydGVkLgogICAgICA8L3BhcmE+CiAgICAgPC9saXN0aXRlbT4KICAgIDwvdmFybGlzdGVudHJ5
PgotLSAKMi41MS4yCgo=
--000000000000c79d9c064d3a121d--