DOCS: Describe some missing parameters on CREATE/ALTER PUBLICATION pages
Peter Smith <smithpb2250@gmail.com>
From: Peter Smith <smithpb2250@gmail.com>
To: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2026-04-08T05:10:50Z
Lists: pgsql-hackers
Attachments
- v1-0001-Add-missing-parameters.patch (application/octet-stream) patch v1-0001
- v1-0002-Add-missing-varlistentry-ids.patch (application/octet-stream) patch v1-0002
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