Re: PG Docs - CREATE SUBSCRIPTION option list order - Mailing list pgsql-hackers

From Tom Lane
Subject Re: PG Docs - CREATE SUBSCRIPTION option list order
Date
Msg-id 2789403.1630781582@sss.pgh.pa.us
Whole thread Raw
In response to Re: PG Docs - CREATE SUBSCRIPTION option list order  (Amit Kapila <amit.kapila16@gmail.com>)
Responses Re: PG Docs - CREATE SUBSCRIPTION option list order  (Amit Kapila <amit.kapila16@gmail.com>)
List pgsql-hackers
Amit Kapila <amit.kapila16@gmail.com> writes:
> On Mon, Apr 19, 2021 at 10:32 AM Peter Smith <smithpb2250@gmail.com> wrote:
>> Yes, if there were dozens of list items then I would agree that they
>> should be grouped somehow. But there aren't.

> I think this list is going to grow in the future as we enhance this
> subsystem. For example, the pending 2PC patch will add another
> parameter to this list.

Well, we've got nine now; growing to ten wouldn't be a lot.  However,
I think that grouping the options would be helpful because the existing
presentation seems extremely confusing.  In particular, I think it might
help to separate the options that only determine what happens during
CREATE SUBSCRIPTION from those that control how replication behaves later.
(Are the latter set the same ones that are shared with ALTER
SUBSCRIPTION?)

Also, I think a lot of these descriptions desperately need copy-editing.
The grammar is shoddy and the markup is inconsistent.

            regards, tom lane



pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: [PATCH] Add tab-complete for backslash commands
Next
From: Tom Lane
Date:
Subject: Re: Reduce lock level for ALTER TABLE ... ADD CHECK .. NOT VALID