Re: Trivial doc fix in logicaldecoding.sgml - Mailing list pgsql-hackers

From Shulgin, Oleksandr
Subject Re: Trivial doc fix in logicaldecoding.sgml
Date
Msg-id CACACo5RRUv_Zb1u5FkRoSdLt9r0j0xM=GKQ1o+w6dzkHWDN5qg@mail.gmail.com
Whole thread Raw
In response to Re: Trivial doc fix in logicaldecoding.sgml  (Craig Ringer <craig@2ndquadrant.com>)
Responses Re: Trivial doc fix in logicaldecoding.sgml  (Fujii Masao <masao.fujii@gmail.com>)
List pgsql-hackers
On Thu, Jan 28, 2016 at 9:42 AM, Craig Ringer <craig@2ndquadrant.com> wrote:
>
>
> On 28 January 2016 at 16:36, Shulgin, Oleksandr <oleksandr.shulgin@zalando.de> wrote:
>>
>> On Thu, Jan 28, 2016 at 5:55 AM, Fujii Masao <masao.fujii@gmail.com> wrote:
>>>
>>>
>>> We should change also START_REPLICATION SLOT syntax document as follows?
>>>
>>> -      <para><literal>START_REPLICATION SLOT
>>> <replaceable>slot_name</replaceable> LOGICAL
>>> <replaceable>options</replaceable></literal></para>
>>> +      <para><literal>START_REPLICATION SLOT
>>> <replaceable>slot_name</replaceable> LOGICAL
>>> <replaceable>XXX/XXX</replaceable>
>>> (<replaceable>options</replaceable>)</literal></para>
>>
>>
>> If a committer would thinks so, I don't object.  Though this one is rather a detail for which the reader is already referred to protocol-replication, while my fix was about a factual error.
>>
>
> I think it should be changed. I've already had people confused by this.
>
> Either that or remove the synopsis entirely, changing it to
>
>     START_REPLICATION SLOT ....
>
> and linking to the protocol docs. Which might be better.

I think it still makes sense to keep the LOGICAL, but hide the rest of the details behind that ellipsis, so:

  START_REPLICATION SLOT slot_name LOGICAL ...

Updated patch attached.

--
Alex

Attachment

pgsql-hackers by date:

Previous
From: Pavel Stehule
Date:
Subject: Re: [PATCH] better systemd integration
Next
From: Pavel Stehule
Date:
Subject: Re: [PATCH] better systemd integration