BUG #15909: Doc for `initdb` on `--data-checksums` says "cannot be changed later", but *can* be in Pg 12.

Started by PG Bug reporting formover 6 years ago4 messagesbugs
Jump to latest
#1PG Bug reporting form
noreply@postgresql.org

The following bug has been logged on the website:

Bug reference: 15909
Logged by: Basil Bourque
Email address: basil.bourque@gmail.com
PostgreSQL version: 12beta2
Operating system: macOS
Description:

The `--data-checksums` option on this page for `initdb`:
https://www.postgresql.org/docs/12/app-initdb.html

…needs to be updated.

Currently says "This option can only be set during initialization, and
cannot be changed later."

But now in Postgres 12, the `pg_checksums` command can enable or disable
checksums on an existing cluster.

See: https://www.postgresql.org/docs/12/app-pgchecksums.html

--Basil Bourque

#2Michael Paquier
michael@paquier.xyz
In reply to: PG Bug reporting form (#1)
Re: BUG #15909: Doc for `initdb` on `--data-checksums` says "cannot be changed later", but *can* be in Pg 12.

On Tue, Jul 16, 2019 at 04:10:52PM +0000, PG Bug reporting form wrote:

But now in Postgres 12, the `pg_checksums` command can enable or disable
checksums on an existing cluster.

My fault here. As it is an initdb option, it is pretty obvious that
it is an initialization-time option. My take is to simply remove the
sentence completely instead of adding an extra reference to
pg_checksums. Thoughts?
--
Michael

#3Daniel Gustafsson
daniel@yesql.se
In reply to: Michael Paquier (#2)
Re: BUG #15909: Doc for `initdb` on `--data-checksums` says "cannot be changed later", but *can* be in Pg 12.

On 17 Jul 2019, at 05:30, Michael Paquier <michael@paquier.xyz> wrote:

On Tue, Jul 16, 2019 at 04:10:52PM +0000, PG Bug reporting form wrote:

But now in Postgres 12, the `pg_checksums` command can enable or disable
checksums on an existing cluster.

My fault here. As it is an initdb option, it is pretty obvious that
it is an initialization-time option. My take is to simply remove the
sentence completely instead of adding an extra reference to
pg_checksums. Thoughts?

Agreed, better to just remove the sentence altogether.

cheers ./daniel

#4Michael Paquier
michael@paquier.xyz
In reply to: Daniel Gustafsson (#3)
Re: BUG #15909: Doc for `initdb` on `--data-checksums` says "cannot be changed later", but *can* be in Pg 12.

On Wed, Jul 17, 2019 at 09:57:56AM +0200, Daniel Gustafsson wrote:

Agreed, better to just remove the sentence altogether.

OK, applied. Thanks for the report.
--
Michael