pg.ddx.io pgsql-committers@postgresql.org mailing list archive
help / color / mirror / Atom feedpgsql: doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION.
5+ messages / 1 participants
[nested] [flat]
* pgsql: doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION.
@ 2025-11-27 14:32 Fujii Masao <fujii@postgresql.org>
0 siblings, 0 replies; 5+ messages in thread
From: Fujii Masao @ 2025-11-27 14:32 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION.
The documentation for CREATE/ALTER PUBLICATION previously showed:
[ ONLY ] table_name [ * ] [ ( column_name [, ... ] ) ] [ WHERE ( expression ) ] [, ... ]
to indicate that the table/column specification could be repeated.
However, placing [, ... ] directly after a multi-part construct was
misleading and made it unclear which portion was repeatable.
This commit introduces a new term, table_and_columns, to represent:
[ ONLY ] table_name [ * ] [ ( column_name [, ... ] ) ] [ WHERE ( expression ) ]
and updates the synopsis to use:
table_and_columns [, ... ]
which clearly identifies the repeatable element.
Backpatched to v15, where the misleading syntax was introduced.
Author: Peter Smith <smithpb2250@gmail.com>
Reviewed-by: Chao Li <lic@highgo.com>
Reviewed-by: Fujii Masao <masao.fujii@gmail.com>
Discussion: https://postgr.es/m/CAHut+PtsyvYL3KmA6C8f0ZpXQ=7FEqQtETVy-BOF+cm9WPvfMQ@mail.gmail.com
Backpatch-through: 15
Branch
------
master
Details
-------
https://git.postgresql.org/pg/commitdiff/246ec4a51c16f27133a293f63aa8bc86ca4fe630
Modified Files
--------------
doc/src/sgml/ref/alter_publication.sgml | 8 ++++++--
doc/src/sgml/ref/create_publication.sgml | 10 +++++++---
2 files changed, 13 insertions(+), 5 deletions(-)
^ permalink raw reply [nested|flat] 5+ messages in thread
* pgsql: doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION.
@ 2025-11-27 14:32 Fujii Masao <fujii@postgresql.org>
0 siblings, 0 replies; 5+ messages in thread
From: Fujii Masao @ 2025-11-27 14:32 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION.
The documentation for CREATE/ALTER PUBLICATION previously showed:
[ ONLY ] table_name [ * ] [ ( column_name [, ... ] ) ] [ WHERE ( expression ) ] [, ... ]
to indicate that the table/column specification could be repeated.
However, placing [, ... ] directly after a multi-part construct was
misleading and made it unclear which portion was repeatable.
This commit introduces a new term, table_and_columns, to represent:
[ ONLY ] table_name [ * ] [ ( column_name [, ... ] ) ] [ WHERE ( expression ) ]
and updates the synopsis to use:
table_and_columns [, ... ]
which clearly identifies the repeatable element.
Backpatched to v15, where the misleading syntax was introduced.
Author: Peter Smith <smithpb2250@gmail.com>
Reviewed-by: Chao Li <lic@highgo.com>
Reviewed-by: Fujii Masao <masao.fujii@gmail.com>
Discussion: https://postgr.es/m/CAHut+PtsyvYL3KmA6C8f0ZpXQ=7FEqQtETVy-BOF+cm9WPvfMQ@mail.gmail.com
Backpatch-through: 15
Branch
------
REL_18_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/9ad15f404a70114658290d4ace3b9b9d924a209b
Modified Files
--------------
doc/src/sgml/ref/alter_publication.sgml | 8 ++++++--
doc/src/sgml/ref/create_publication.sgml | 6 +++++-
2 files changed, 11 insertions(+), 3 deletions(-)
^ permalink raw reply [nested|flat] 5+ messages in thread
* pgsql: doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION.
@ 2025-11-27 14:33 Fujii Masao <fujii@postgresql.org>
0 siblings, 0 replies; 5+ messages in thread
From: Fujii Masao @ 2025-11-27 14:33 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION.
The documentation for CREATE/ALTER PUBLICATION previously showed:
[ ONLY ] table_name [ * ] [ ( column_name [, ... ] ) ] [ WHERE ( expression ) ] [, ... ]
to indicate that the table/column specification could be repeated.
However, placing [, ... ] directly after a multi-part construct was
misleading and made it unclear which portion was repeatable.
This commit introduces a new term, table_and_columns, to represent:
[ ONLY ] table_name [ * ] [ ( column_name [, ... ] ) ] [ WHERE ( expression ) ]
and updates the synopsis to use:
table_and_columns [, ... ]
which clearly identifies the repeatable element.
Backpatched to v15, where the misleading syntax was introduced.
Author: Peter Smith <smithpb2250@gmail.com>
Reviewed-by: Chao Li <lic@highgo.com>
Reviewed-by: Fujii Masao <masao.fujii@gmail.com>
Discussion: https://postgr.es/m/CAHut+PtsyvYL3KmA6C8f0ZpXQ=7FEqQtETVy-BOF+cm9WPvfMQ@mail.gmail.com
Backpatch-through: 15
Branch
------
REL_17_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/d7977668eec65363012797302b492adff1578274
Modified Files
--------------
doc/src/sgml/ref/alter_publication.sgml | 8 ++++++--
doc/src/sgml/ref/create_publication.sgml | 6 +++++-
2 files changed, 11 insertions(+), 3 deletions(-)
^ permalink raw reply [nested|flat] 5+ messages in thread
* pgsql: doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION.
@ 2025-11-27 14:33 Fujii Masao <fujii@postgresql.org>
0 siblings, 0 replies; 5+ messages in thread
From: Fujii Masao @ 2025-11-27 14:33 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION.
The documentation for CREATE/ALTER PUBLICATION previously showed:
[ ONLY ] table_name [ * ] [ ( column_name [, ... ] ) ] [ WHERE ( expression ) ] [, ... ]
to indicate that the table/column specification could be repeated.
However, placing [, ... ] directly after a multi-part construct was
misleading and made it unclear which portion was repeatable.
This commit introduces a new term, table_and_columns, to represent:
[ ONLY ] table_name [ * ] [ ( column_name [, ... ] ) ] [ WHERE ( expression ) ]
and updates the synopsis to use:
table_and_columns [, ... ]
which clearly identifies the repeatable element.
Backpatched to v15, where the misleading syntax was introduced.
Author: Peter Smith <smithpb2250@gmail.com>
Reviewed-by: Chao Li <lic@highgo.com>
Reviewed-by: Fujii Masao <masao.fujii@gmail.com>
Discussion: https://postgr.es/m/CAHut+PtsyvYL3KmA6C8f0ZpXQ=7FEqQtETVy-BOF+cm9WPvfMQ@mail.gmail.com
Backpatch-through: 15
Branch
------
REL_16_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/fc6e1a0f2bad75bc021024c5a676576962222157
Modified Files
--------------
doc/src/sgml/ref/alter_publication.sgml | 8 ++++++--
doc/src/sgml/ref/create_publication.sgml | 6 +++++-
2 files changed, 11 insertions(+), 3 deletions(-)
^ permalink raw reply [nested|flat] 5+ messages in thread
* pgsql: doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION.
@ 2025-11-27 14:33 Fujii Masao <fujii@postgresql.org>
0 siblings, 0 replies; 5+ messages in thread
From: Fujii Masao @ 2025-11-27 14:33 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION.
The documentation for CREATE/ALTER PUBLICATION previously showed:
[ ONLY ] table_name [ * ] [ ( column_name [, ... ] ) ] [ WHERE ( expression ) ] [, ... ]
to indicate that the table/column specification could be repeated.
However, placing [, ... ] directly after a multi-part construct was
misleading and made it unclear which portion was repeatable.
This commit introduces a new term, table_and_columns, to represent:
[ ONLY ] table_name [ * ] [ ( column_name [, ... ] ) ] [ WHERE ( expression ) ]
and updates the synopsis to use:
table_and_columns [, ... ]
which clearly identifies the repeatable element.
Backpatched to v15, where the misleading syntax was introduced.
Author: Peter Smith <smithpb2250@gmail.com>
Reviewed-by: Chao Li <lic@highgo.com>
Reviewed-by: Fujii Masao <masao.fujii@gmail.com>
Discussion: https://postgr.es/m/CAHut+PtsyvYL3KmA6C8f0ZpXQ=7FEqQtETVy-BOF+cm9WPvfMQ@mail.gmail.com
Backpatch-through: 15
Branch
------
REL_15_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/f9f928304bb720d5e94651acd6b3e71a6f267430
Modified Files
--------------
doc/src/sgml/ref/alter_publication.sgml | 8 ++++++--
doc/src/sgml/ref/create_publication.sgml | 6 +++++-
2 files changed, 11 insertions(+), 3 deletions(-)
^ permalink raw reply [nested|flat] 5+ messages in thread
end of thread, other threads:[~2025-11-27 14:33 UTC | newest]
Thread overview: 5+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2025-11-27 14:32 pgsql: doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION. Fujii Masao <fujii@postgresql.org>
2025-11-27 14:32 pgsql: doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION. Fujii Masao <fujii@postgresql.org>
2025-11-27 14:33 pgsql: doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION. Fujii Masao <fujii@postgresql.org>
2025-11-27 14:33 pgsql: doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION. Fujii Masao <fujii@postgresql.org>
2025-11-27 14:33 pgsql: doc: Fix misleading synopsis for CREATE/ALTER PUBLICATION. Fujii Masao <fujii@postgresql.org>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox