Re: Corresponding documentation page does not mention about `spread` mode - Mailing list pgsql-docs

From David G. Johnston
Subject Re: Corresponding documentation page does not mention about `spread` mode
Date
Msg-id CAKFQuwYpVAVL5XGR3sVCBz=cY+kgxe=fva3Y025xveeUjPC5dg@mail.gmail.com
Whole thread Raw
In response to Corresponding documentation page does not mention about `spread` mode  (PG Doc comments form <noreply@postgresql.org>)
Responses Re: Corresponding documentation page does not mention about `spread` mode
List pgsql-docs
On Tue, Oct 3, 2023 at 2:48 PM PG Doc comments form <noreply@postgresql.org> wrote:

On [this
page](https://www.postgresql.org/docs/current/app-pgbasebackup.html)
`spread` is mentioned:

-c {fast|spread}
--checkpoint={fast|spread}

    Sets checkpoint mode to fast (immediate) or spread (the default) (see
Section 26.3.3).

But mentioned section 26.3.3 does not describe `spread` mode:
https://www.postgresql.org/docs/current/continuous-archiving.html#BACKUP-LOWLEVEL-BASE-BACKUP


It does, though it is phrased in terms of "fast => false" meaning "spread" whereas "fast => true" means "immediate".

But since the CLI wanted a label instead of true/false it had to call the default "not fast" mode something and it chose "spread".

Not saying this couldn't be made more clear/better but it is accurate and complete.

David J.

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: INT4RANGE Upper bound always includes a higher number
Next
From: Brad White
Date:
Subject: ODBC options