public inbox for [email protected]  
help / color / mirror / Atom feed
From: =?iso-2022-jp?B?TWF0c3VtdXJhLCBSeW8vGyRCPj5CPBsoQiAbJEJOTBsoQg==?= <[email protected]>
To: Fujii Masao <[email protected]>
Cc: PostgreSQL-development <[email protected]>
Subject: Re: [PATCH] Docs: clarify default values of EXPLAIN BUFFERS and SERIALIZE
Date: Tue, 17 Mar 2026 10:26:23 +0000
Message-ID: <TYRPR01MB134577510E2A2EB3947E821BEE841A@TYRPR01MB13457.jpnprd01.prod.outlook.com> (raw)
In-Reply-To: <CAHGQGwHEHX8n_SPK2fy8FdVtEJsAtQBZypsBiucPcAAaNYqEog@mail.gmail.com>
References: <TYRPR01MB13457D31085CB5B246DBBA1AFE845A@TYRPR01MB13457.jpnprd01.prod.outlook.com>
	<CAHGQGwFpmEg2WgjgLLNbDBimmZ23krS2Q4FHR=0NJU2CZxvF_Q@mail.gmail.com>
	<TYRPR01MB134578C74066239A8281B9308E840A@TYRPR01MB13457.jpnprd01.prod.outlook.com>
	<CAHGQGwHEHX8n_SPK2fy8FdVtEJsAtQBZypsBiucPcAAaNYqEog@mail.gmail.com>

On Mon, Mar 16, 2026 at 10:30:00 +0000, Fujii Masao <[email protected]> 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.

Best Regards
Ryo Matsumura


Attachments:

  [application/octet-stream] v3-0001-Docs-clarify-default-values-in-EXPLAIN-documentat.patch (1.1K, 3-v3-0001-Docs-clarify-default-values-in-EXPLAIN-documentat.patch)
  download | inline diff:
From db26274d6ee4b8bb123f1a874ec1a495dd1dee7e Mon Sep 17 00:00:00 2001
From: Ryo Matsumura <[email protected]>
Date: Tue, 17 Mar 2026 19:16:09 +0900
Subject: [PATCH v3] Docs: clarify default values in EXPLAIN documentation.

---
 doc/src/sgml/ref/explain.sgml | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/src/sgml/ref/explain.sgml b/doc/src/sgml/ref/explain.sgml
index 7dee77fd366..5055dde67c7 100644
--- a/doc/src/sgml/ref/explain.sgml
+++ b/doc/src/sgml/ref/explain.sgml
@@ -201,8 +201,10 @@ ROLLBACK;
       query processing.
       The number of blocks shown for an
       upper-level node includes those used by all its child nodes.  In text
-      format, only non-zero values are printed.  Buffers information is
-      automatically included when <literal>ANALYZE</literal> is used.
+      format, only non-zero values are printed.
+      When ANALYZE is used, this parameter defaults to <literal>TRUE</literal>
+      and buffer usage information is included.
+      Otherwise, it defaults to <literal>FALSE</literal>.
      </para>
     </listitem>
    </varlistentry>
-- 
2.47.3



view thread (8+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: [PATCH] Docs: clarify default values of EXPLAIN BUFFERS and SERIALIZE
  In-Reply-To: <TYRPR01MB134577510E2A2EB3947E821BEE841A@TYRPR01MB13457.jpnprd01.prod.outlook.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox