| From: | Peter Smith <smithpb2250(at)gmail(dot)com> |
|---|---|
| To: | PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org> |
| Subject: | Re: DOCS: Describe some missing parameters on CREATE/ALTER PUBLICATION pages |
| Date: | 2026-05-18 05:42:59 |
| Message-ID: | CAHut+Pu93h7LOvetCOg8WeBuXqf5xgaBiUK4bETXJwnJczFpDQ@mail.gmail.com |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers |
On Wed, Apr 8, 2026 at 3:10 PM Peter Smith <smithpb2250(at)gmail(dot)com> 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
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Peter Smith | 2026-05-18 05:52:30 | Re: Add missing period to DETAIL messages |
| Previous Message | Chao Li | 2026-05-18 05:28:32 | Re: Bug in ALTER SUBSCRIPTION ... SERVER / ... CONNECTION with broken old server |