Thread

1. 66.6. Database Page Layout

   The Post Office <noreply@postgresql.org> — 2026-07-08T10:43:12Z

   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?
   
   
   
   
   

2. Re: 66.6. Database Page Layout

   Daniel Gustafsson <daniel@yesql.se> — 2026-07-09T21:58:55Z

   > 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
   
   

3. Re: 66.6. Database Page Layout

   Laurenz Albe <laurenz.albe@cybertec.at> — 2026-07-10T06:33:37Z

   On Thu, 2026-07-09 at 23:58 +0200, Daniel Gustafsson wrote:
   > 
   > 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.
   
   That patch looks good to me.
   
   Yours,
   Laurenz Albe