public inbox for [email protected]  
help / color / mirror / Atom feed
From: Thom Brown <[email protected]>
To: Daniel Gustafsson <[email protected]>
Cc: [email protected]
Subject: Re: pgsql: doc: Clarify CHECKPOINT handling of unlogged buffers
Date: Tue, 26 May 2026 15:53:34 +0100
Message-ID: <CAA-aLv5pZNZbdhPG2Wu0fzyKCjn9TTzN9QZ=JONPyqZQKhBV=g@mail.gmail.com> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>

On Mon, 25 May 2026 at 11:23, Daniel Gustafsson
<[email protected]> wrote:
>
> doc: Clarify CHECKPOINT handling of unlogged buffers
>
> The CHECKPOINT reference page still described checkpoints as flushing
> all data files, which could be misleading as it depends on the value
> of FLUSH_UNLOGGED option.  Update the description to make it clearer
> that only data files of permanent relations are flushed by default.
>
> Author: Chao Li <[email protected]>
> Reviewed-by: Daniel Gustafsson <[email protected]>
> Discussion: https://postgr.es/m/[email protected]
>
> Branch
> ------
> master
>
> Details
> -------
> https://git.postgresql.org/pg/commitdiff/377cc45194f4f1bd6eb68bd6eb42402e46e326d7
>
> Modified Files
> --------------
> doc/src/sgml/ref/checkpoint.sgml | 6 ++++--
> 1 file changed, 4 insertions(+), 2 deletions(-)

"All data for permanent relations files will be flushed to disk, dirty
buffers of unlogged relations are not flushed unless
<literal>FLUSH_UNLOGGED</literal> is specified."

This doesn't quite read right.

"permanent relations files" should be "permanent relation files"

and the sentence looks like it should end after "flushed to disk",
with "Dirty buffers" being the start of a new sentence.

Regards

Thom






view thread (2+ messages)

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], [email protected]
  Subject: Re: pgsql: doc: Clarify CHECKPOINT handling of unlogged buffers
  In-Reply-To: <CAA-aLv5pZNZbdhPG2Wu0fzyKCjn9TTzN9QZ=JONPyqZQKhBV=g@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