Re: pg_createsubscriber: publication-name and subscription-name options do not exist

From: Shubham Khanna <khannashubham1197(at)gmail(dot)com>
To: Peter Smith <smithpb2250(at)gmail(dot)com>
Cc: vignesh C <vignesh21(at)gmail(dot)com>, christophe(dot)courtois(at)dalibo(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org, Amit Kapila <amit(dot)kapila16(at)gmail(dot)com>
Subject: Re: pg_createsubscriber: publication-name and subscription-name options do not exist
Date: 2024-12-03 03:28:16
Message-ID: CAHv8Rj+doEWrP8dXN96D4zFVjmZxKdVnt+=RuwxpDL5Y95tZQw@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Tue, Dec 3, 2024 at 8:39 AM Shubham Khanna
<khannashubham1197(at)gmail(dot)com> wrote:
>
> On Tue, Dec 3, 2024 at 7:16 AM Peter Smith <smithpb2250(at)gmail(dot)com> wrote:
> >
> > Hi Shubham,
> >
> > I took a look at the patch v2-0001. Here are some review comments.
> >
> > 1.
> > Previously when this DOCS page was referring to the --publication and
> > --subscription it was calling those "switches". I don't know why, but
> > it does.
> >
> > Maybe calling them "options" is ok too, but personally (for
> > consistency with the above) I would've stuck with the same "switches"
> > terminology.
> >
> > 1a.
> > /If --publication option is not specified.../If the --publication
> > switch is not specified.../
> >
> > or maybe just omit the term entirely
> > /If --publication option is not specified.../If --publication is not
> > specified.../
> >
> > ~
> >
> > 1b.
> > /If --subscription option is not specified.../If the --subscription
> > switch is not specified.../
> >
> > or maybe just omit the term entirely
> > /If --subscription option is not specified.../If --subscription is not
> > specified.../
> >
> > ~~~
> >
> > 2.
> > Although the patch addresses the reported problems, I think the same
> > problem exists for "replication-slot-name". e.g. the DOCS are saying
> > "If replication-slot-name is not specified..." although there is no
> > such thing -- it is called "--replication-slot"
> >
> > So, the patch should also be fixing that one using the same consistent wording.
> >
> > e.g.
> > /If replication-slot-name is not specified.../If the
> > --replication-slot switch is not specified.../
> > or
> > /If replication-slot-name is not specified.../If --replication-slot is
> > not specified.../
> >
>
> I have fixed the suggested changes. The attached Patch contains the
> required changes.
>

I have omitted the 'switch' from the suggested places to ensure
consistency within the documentation. The attached patch includes the
updated changes.

Thanks and regards,
Shubham Khanna.

Attachment Content-Type Size
v4-0001-DOCS-Fix.patch application/octet-stream 2.5 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Peter Smith 2024-12-03 03:50:43 Re: pg_createsubscriber: publication-name and subscription-name options do not exist
Previous Message Shubham Khanna 2024-12-03 03:09:49 Re: pg_createsubscriber: publication-name and subscription-name options do not exist