| 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 |
| 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 |