public inbox for [email protected]  

help / color / mirror / Atom feed

From: Peter Smith <[email protected]>
To: PostgreSQL Hackers <[email protected]>
Subject: Re: DOCS: Describe some missing parameters on CREATE/ALTER PUBLICATION pages
Date: Mon, 18 May 2026 15:42:59 +1000
Message-ID: <CAHut+Pu93h7LOvetCOg8WeBuXqf5xgaBiUK4bETXJwnJczFpDQ@mail.gmail.com> (raw)
In-Reply-To: <CAHut+Ptekz+TO4ui8-fiBm4Y+O2v=HQnkK_cW4G=w9ep8654EA@mail.gmail.com>
References: <CAHut+Ptekz+TO4ui8-fiBm4Y+O2v=HQnkK_cW4G=w9ep8654EA@mail.gmail.com>

On Wed, Apr 8, 2026 at 3:10 PM Peter Smith <[email protected]> wrote:
>
> Hi.
>
> I noticed that the CREATE PUBLICATION and ALTER PUBLICATION sysnopses
> contain some user-specified parameters which are not defined, and not
> even mentioned anywhere else.
>
> For example,
>
> ALTER PUBLICATION
> - defines 'name', 'table_name', 'schema_name'
> - never mentions 'column_name'
>
> CREATE PUBLICATION
> - defines 'name'
> - never mentions 'table_name', 'schema_name', 'column_name'
>
> ~~~
>
> It seems wrong to include undefined synopsis parameters and just
> assume they will be self-explanatory.
>
> It is ad-hoc; some terms are described on one page but not on the other.
>
> ~
>
> PSA a small patch to make these parameter descriptions more complete
> and consistent.
>
> In passing, I also added some missing <varlistentry> "id"s for the
> ALTER PUBLICATION page.
>

Ping. This patch was posted about 5 weeks ago, but has received no
feedback so far.

======
Kind Regards,
Peter Smith.
Fujitsu Australia

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: DOCS: Describe some missing parameters on CREATE/ALTER PUBLICATION pages
  In-Reply-To: <CAHut+Pu93h7LOvetCOg8WeBuXqf5xgaBiUK4bETXJwnJczFpDQ@mail.gmail.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox