Re: 66.6. Database Page Layout - Mailing list pgsql-docs

From Daniel Gustafsson
Subject Re: 66.6. Database Page Layout
Date
Msg-id 24B34848-3557-48E0-B601-A5BA4FC4E057@yesql.se
Whole thread
Responses Re: 66.6. Database Page Layout
List pgsql-docs
> On 8 Jul 2026, at 12:43, PG Doc comments form <noreply@postgresql.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

pgsql-docs by date:

Previous
From: Daniel Gustafsson
Date:
Subject: Re: Fix data checksum progress reporting docs
Next
From: Fujii Masao
Date:
Subject: Re: Fix data checksum progress reporting docs