public inbox for [email protected]  
help / color / mirror / Atom feed
pgsql: doc: Clarify CHECKPOINT handling of unlogged buffers
2+ messages / 2 participants
[nested] [flat]

* pgsql: doc: Clarify CHECKPOINT handling of unlogged buffers
@ 2026-05-25 10:22  Daniel Gustafsson <[email protected]>
  0 siblings, 1 reply; 2+ messages in thread

From: Daniel Gustafsson @ 2026-05-25 10:22 UTC (permalink / raw)
  To: [email protected]

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(-)



^ permalink  raw  reply  [nested|flat] 2+ messages in thread

* Re: pgsql: doc: Clarify CHECKPOINT handling of unlogged buffers
@ 2026-05-26 14:53  Thom Brown <[email protected]>
  parent: Daniel Gustafsson <[email protected]>
  0 siblings, 0 replies; 2+ messages in thread

From: Thom Brown @ 2026-05-26 14:53 UTC (permalink / raw)
  To: Daniel Gustafsson <[email protected]>; +Cc: [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






^ permalink  raw  reply  [nested|flat] 2+ messages in thread


end of thread, other threads:[~2026-05-26 14:53 UTC | newest]

Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2026-05-25 10:22 pgsql: doc: Clarify CHECKPOINT handling of unlogged buffers Daniel Gustafsson <[email protected]>
2026-05-26 14:53 ` Thom Brown <[email protected]>

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