From: Tom Lane <tgl@sss.pgh.pa.us>
To: "David G. Johnston" <david.g.johnston@gmail.com>
cc: konkove@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Corresponding documentation page does not mention about `spread`
 mode
In-reply-to: 
 <CAKFQuwYpVAVL5XGR3sVCBz=cY+kgxe=fva3Y025xveeUjPC5dg@mail.gmail.com>
References: 
 <169636111937.3727338.16345514511660975834@wrigleys.postgresql.org>
 <CAKFQuwYpVAVL5XGR3sVCBz=cY+kgxe=fva3Y025xveeUjPC5dg@mail.gmail.com>
Comments: In-reply-to "David G. Johnston" <david.g.johnston@gmail.com>
	message dated "Tue, 03 Oct 2023 14:56:13 -0700"
MIME-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Content-ID: <2465734.1696373077.1@sss.pgh.pa.us>
Content-Transfer-Encoding: quoted-printable
Date: Tue, 03 Oct 2023 18:44:37 -0400
Message-ID: <2465735.1696373077@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/2465735.1696373077%40sss.pgh.pa.us>
Precedence: bulk

"David G. Johnston" <david.g.johnston@gmail.com> writes:
> On Tue, Oct 3, 2023 at 2:48=E2=80=AFPM PG Doc comments form <noreply@pos=
tgresql.org>
> wrote:
>> But mentioned section 26.3.3 does not describe `spread` mode:

> It does, though it is phrased in terms of "fast =3D> false" meaning "spr=
ead"
> whereas "fast =3D> true" means "immediate".
> But since the CLI wanted a label instead of true/false it had to call th=
e
> default "not fast" mode something and it chose "spread".
> Not saying this couldn't be made more clear/better but it is accurate an=
d
> complete.

Perhaps a parenthetical remark like "(pg_basebackup refers to this as
'spread' mode)" would help?

			regards, tom lane