Re: --sync-method isn't documented to take an argument

From: Robert Haas <robertmhaas(at)gmail(dot)com>
To: Daniel Gustafsson <daniel(at)yesql(dot)se>
Cc: PostgreSQL Hackers <pgsql-hackers(at)postgresql(dot)org>, Nathan Bossart <nathandbossart(at)gmail(dot)com>
Subject: Re: --sync-method isn't documented to take an argument
Date: 2023-10-04 13:22:14
Message-ID: CA+TgmobiftxwkdnLByjX5muZv_8xZ-P5kAsdNCGAKYUFMGW3uw@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Wed, Oct 4, 2023 at 9:15 AM Daniel Gustafsson <daniel(at)yesql(dot)se> wrote:
> > On 4 Oct 2023, at 15:08, Robert Haas <robertmhaas(at)gmail(dot)com> wrote:
> > This one should be something like this:
> >
> > <term><option>--sync-method=<replaceable>method</replaceable></option></term>
>
> Shouldn't it be <replaceable class="parameter">method</replaceable> ?

Hmm, I think you're probably right. But look at this:

<term><option>-S <replaceable>slotname</replaceable></option></term>
<term><option>--slot=<replaceable
class="parameter">slotname</replaceable></option></term>

But then in the very same file:

<term><option>-r <replaceable
class="parameter">rate</replaceable></option></term>
<term><option>--max-rate=<replaceable
class="parameter">rate</replaceable></option></term>

It doesn't look to me like we're entirely consistent about this. I
also found this in vacuumlo.sgml, and there seem to be various other
examples:

<term><option>-U <replaceable>username</replaceable></option></term>

--
Robert Haas
EDB: http://www.enterprisedb.com

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Amit Langote 2023-10-04 13:26:47 Re: remaining sql/json patches
Previous Message Robert Haas 2023-10-04 13:17:48 Re: [DOCS] HOT - correct claim about indexes not referencing old line pointers