Re: Corresponding documentation page does not mention about `spread` mode

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: konkove(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Corresponding documentation page does not mention about `spread` mode
Date: 2023-10-03 21:56:13
Message-ID: CAKFQuwYpVAVL5XGR3sVCBz=cY+kgxe=fva3Y025xveeUjPC5dg@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Tue, Oct 3, 2023 at 2:48 PM PG Doc comments form <noreply(at)postgresql(dot)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.

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Brad White 2023-10-03 22:34:01 ODBC options
Previous Message Tom Lane 2023-10-03 20:57:32 Re: INT4RANGE Upper bound always includes a higher number