public inbox for [email protected]  

help / color / mirror / Atom feed

From: Fujii Masao <[email protected]>
To: Ryo Matsumura (Fujitsu) <[email protected]>
Cc: PostgreSQL-development <[email protected]>
Subject: Re: [PATCH] Docs: clarify default values of EXPLAIN BUFFERS and SERIALIZE
Date: Fri, 13 Mar 2026 23:38:57 +0900
Message-ID: <CAHGQGwFpmEg2WgjgLLNbDBimmZ23krS2Q4FHR=0NJU2CZxvF_Q@mail.gmail.com> (raw)
In-Reply-To: <TYRPR01MB13457D31085CB5B246DBBA1AFE845A@TYRPR01MB13457.jpnprd01.prod.outlook.com>
References: <TYRPR01MB13457D31085CB5B246DBBA1AFE845A@TYRPR01MB13457.jpnprd01.prod.outlook.com>

On Fri, Mar 13, 2026 at 5:38 PM Ryo Matsumura (Fujitsu)
<[email protected]> wrote:
>
> Hi Hackers,
>
> It looks like the EXPLAIN documentation is missing an explanation of the default values for the BUFFERS and SERIALIZE options.
> I've attached a patch that adds this information.
> While the documentation currently notes that these options are implicitly enabled when ANALYZE is specified, the default values of the parameters themselves do not appear to be documented.

+1 to adding a description of the default value.


       format, only non-zero values are printed.  Buffers information is
       automatically included when <literal>ANALYZE</literal> is used.
+      It defaults to <literal>FALSE</literal>.

How about clarifying the default depending on whether ANALYZE is used?
For example:

        When ANALYZE is used, this parameter defaults to TRUE and buffer usage
        information is included. Otherwise, it defaults to FALSE.


       argument, <literal>TEXT</literal> is assumed.
+      It defaults to <literal>FALSE</literal>.

Does SERIALIZE actually accept FALSE?

Regards,

-- 
Fujii Masao

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: <CAHGQGwFpmEg2WgjgLLNbDBimmZ23krS2Q4FHR=0NJU2CZxvF_Q@mail.gmail.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