agora inbox for pgsql-docs@postgresql.org  
help / color / mirror / Atom feed
From: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: afripowered@gmail.com
Subject: Second paragraph a little bit misleading
Date: Tue, 11 Feb 2025 14:00:10 +0000
Message-ID: <173928241056.707.3989867022954178032@wrigleys.postgresql.org> (raw)

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/17/checksums.html
Description:

Hi there,

I think that the first sentence of the second paragraph in this page is a
little bit misleading. The first paragraph states that checksums are not
enabled by default. The first sentence in the second paragraph sounds like
it IS enabled by default when using initdb, but you have to pass -k
explicitly.

As far as I understood, it's a good idea to enable this and that is what the
beginning of the second paragraph means.

Maybe a sentence like "Checksums should normally be enabled when the cluster
is initialized using initdb" instead of "are" - or "It's recommended to
enable Checksums when initializing a cluster using initdb".

regards

Felix


view thread (7+ messages)  latest in thread

Message-ID: <173928241056.707.3989867022954178032@wrigleys.postgresql.org>
Permalink:  ../173928241056.707.3989867022954178032@wrigleys.postgresql.org/
Also on:    postgresql.org/message-id/173928241056.707.3989867022954178032@wrigleys.postgresql.org

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: pgsql-docs@postgresql.org
  Cc: noreply@postgresql.org, pgsql-docs@lists.postgresql.org, afripowered@gmail.com
  Subject: Re: Second paragraph a little bit misleading
  In-Reply-To: <173928241056.707.3989867022954178032@wrigleys.postgresql.org>

* 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