From 103ecbdcb6d6c13589ab4cbd9b92cf344ff82409 Mon Sep 17 00:00:00 2001 From: Peter Smith Date: Wed, 8 Apr 2026 13:33:21 +1000 Subject: [PATCH v2] doc: Add missing CREATE/ALTER PUBLICATION parameter descriptions Document table_name, column_name, and schema_name in the CREATE PUBLICATION and ALTER PUBLICATION reference pages. Also add anchors for the ALTER PUBLICATION parameter list, matching the style already used by CREATE PUBLICATION. --- doc/src/sgml/ref/alter_publication.sgml | 32 +++++++++++------ doc/src/sgml/ref/create_publication.sgml | 45 ++++++++++++++++++++---- 2 files changed, 60 insertions(+), 17 deletions(-) diff --git a/doc/src/sgml/ref/alter_publication.sgml b/doc/src/sgml/ref/alter_publication.sgml index 52114a16a39..d2898d2633e 100644 --- a/doc/src/sgml/ref/alter_publication.sgml +++ b/doc/src/sgml/ref/alter_publication.sgml @@ -149,7 +149,7 @@ ALTER PUBLICATION name RENAME TO Parameters - + name @@ -158,15 +158,17 @@ ALTER PUBLICATION name RENAME TO - + table_name Name of an existing table. If ONLY is specified before the - table name, only that table is affected. If ONLY is not - specified, the table and all its descendant tables (if any) are - affected. Optionally, * can be specified after the table - name to explicitly indicate that descendant tables are included. + table_name, only that table + is affected. If ONLY is not specified, the table and + all its descendant tables (if any) are affected. Optionally, + * can be specified after the + table_name to explicitly + indicate that descendant tables are included. @@ -189,7 +191,17 @@ ALTER PUBLICATION name RENAME TO - + + column_name + + + Name of an existing column of + table_name. + + + + + schema_name @@ -198,7 +210,7 @@ ALTER PUBLICATION name RENAME TO - + SET ( publication_parameter [= value] [, ... ] ) @@ -224,7 +236,7 @@ ALTER PUBLICATION name RENAME TO - + new_owner @@ -233,7 +245,7 @@ ALTER PUBLICATION name RENAME TO - + new_name diff --git a/doc/src/sgml/ref/create_publication.sgml b/doc/src/sgml/ref/create_publication.sgml index 85cfcaddafa..35c28006f60 100644 --- a/doc/src/sgml/ref/create_publication.sgml +++ b/doc/src/sgml/ref/create_publication.sgml @@ -79,15 +79,45 @@ CREATE PUBLICATION name + + table_name + + + Name of an existing table. + + + + + + column_name + + + Name of an existing column of + table_name. + + + + + + schema_name + + + Name of an existing schema. + + + + FOR TABLE Specifies a list of tables to add to the publication. If - ONLY is specified before the table name, only + ONLY is specified before the + table_name, only that table is added to the publication. If ONLY is not specified, the table and all its descendant tables (if any) are added. - Optionally, * can be specified after the table name to + Optionally, * can be specified after the + table_name to explicitly indicate that descendant tables are included. This does not apply to a partitioned table, however. The partitions of a partitioned table are always implicitly considered part of the @@ -208,11 +238,12 @@ CREATE PUBLICATION name For inherited tables, if ONLY is specified before the - table name, only that table is excluded from the publication. If - ONLY is not specified, the table and all its descendant - tables (if any) are excluded. Optionally, * can be - specified after the table name to explicitly indicate that descendant - tables are excluded. + table_name, only that table + is excluded from the publication. If ONLY is not + specified, the table and all its descendant tables (if any) are excluded. + Optionally, * can be specified after the + table_name to explicitly + indicate that descendant tables are excluded. For partitioned tables, only the root partitioned table may be specified -- 2.55.0