Re: Missing information on '-X' in section 26.3.6.1.

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
Cc: lukas(dot)langenegger(at)hexabit(dot)ch, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Missing information on '-X' in section 26.3.6.1.
Date: 2024-01-24 09:19:29
Message-ID: 0E92E952-1F69-4646-A649-B6F3EFAACA90@yesql.se
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 23 Jan 2024, at 21:43, David G. Johnston <david(dot)g(dot)johnston(at)gmail(dot)com> wrote:
>
> On Tue, Jan 23, 2024 at 1:30 PM PG Doc comments form <noreply(at)postgresql(dot)org <mailto:noreply(at)postgresql(dot)org>> wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/16/continuous-archiving.html <https://www.postgresql.org/docs/16/continuous-archiving.html>
> Description:
>
> I noticed, that in section 26.3.6.1. it's not specified, what the -X
> parameter should be set to (stream or fetch, or whether it even matters). I
> could continue with trial and error, but it confused me a bit.
>
> The -X parameter is documented to have a default; but since both fetch and stream are documented to give you the same end result it doesn't matter. Of course you cannot specify the none method.

Agreed. Still, it doesn't hurt to spell out what we take for granted but a
newcomer have to figure out in order to make the documentation easy to follow
for new users. Something like the attached would be enough I think.
--
Daniel Gustafsson

Attachment Content-Type Size
pg_basebackup_X.diff application/octet-stream 963 bytes

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message gparc 2024-01-24 10:08:21 Re: SQL command : ALTER DATABASE OWNER TO
Previous Message David G. Johnston 2024-01-23 20:43:13 Re: Missing information on '-X' in section 26.3.6.1.