Re: 66.6. Database Page Layout

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: y(dot)saburov(at)gmail(dot)com, PostgreSQL-documentation <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: 66.6. Database Page Layout
Date: 2026-07-09 21:58:55
Message-ID: 24B34848-3557-48E0-B601-A5BA4FC4E057@yesql.se
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 8 Jul 2026, at 12:43, PG Doc comments form <noreply(at)postgresql(dot)org> wrote:
>
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/18/storage-page-layout.html
> Description:
>
>> The second field contains the page checksum if -k are enabled.
>
> -k -- This is enabled by default; use --no-data-checksums to disable
> checksums.
>
> Why does this need to be clarified?

I'm not entirely sure which part you are referring to, but I agree that the
current wording isn't very good.

"The second field contains the page checksum if -k are enabled."

I propose the attached patch which changes the sentence to "The second field
contains the page checksum if data checksums are enabled." with a link to the
Checksums chapter in the documentation instead.

--
Daniel Gustafsson

Attachment Content-Type Size
page_layout_checksums.diff application/octet-stream 783 bytes

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Fujii Masao 2026-07-10 01:13:21 Re: Fix data checksum progress reporting docs
Previous Message Daniel Gustafsson 2026-07-09 08:28:18 Re: Fix data checksum progress reporting docs