DOCS: Describe some missing parameters on CREATE/ALTER PUBLICATION pages

From: Peter Smith <smithpb2250(at)gmail(dot)com>
To: PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: DOCS: Describe some missing parameters on CREATE/ALTER PUBLICATION pages
Date: 2026-04-08 05:10:50
Message-ID: CAHut+Ptekz+TO4ui8-fiBm4Y+O2v=HQnkK_cW4G=w9ep8654EA@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

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.

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

Attachment Content-Type Size
v1-0001-Add-missing-parameters.patch application/octet-stream 6.7 KB
v1-0002-Add-missing-varlistentry-ids.patch application/octet-stream 2.9 KB

Browse pgsql-hackers by date

  From Date Subject
Next Message Ashutosh Bapat 2026-04-08 05:20:53 Re: Better shared data structure management and resizable shared data structures
Previous Message Tom Lane 2026-04-08 05:00:51 BF client script runs src/test/modules TAP tests multiple times