From dc6c9c540b5a4bf5aa2aedc8959b0d015004d45c Mon Sep 17 00:00:00 2001 From: Amit Kapila Date: Thu, 13 Aug 2026 10:10:46 +0530 Subject: [PATCH] Doc: Clarify ALTER PUBLICATION's REFRESH PUBLICATION wording. The note used a confusing "tables/except tables/schemas" slash-list, omitted DROP from the operations requiring a subscriber refresh, and called out "unset ALL SEQUENCES" without its symmetric "unset ALL TABLES" case. Reword for clarity and consistency. Author: Peter Smith Reviewed-by: Amit Kapila Backpatch-through: 19 Discussion: https://postgr.es/m/CAHut+PuGKrWhVMvuFyf-wSdF-Tai_jPTz2UCSCqsYM-82ATY5w@mail.gmail.com --- doc/src/sgml/ref/alter_publication.sgml | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/doc/src/sgml/ref/alter_publication.sgml b/doc/src/sgml/ref/alter_publication.sgml index 52114a16a39..925b58129b1 100644 --- a/doc/src/sgml/ref/alter_publication.sgml +++ b/doc/src/sgml/ref/alter_publication.sgml @@ -97,15 +97,16 @@ ALTER PUBLICATION name RENAME TO - Note that adding tables/except tables/schemas to a publication that is - already subscribed to will require an + Note that adding, dropping, or setting tables or schemas in a publication + that is already subscribed to will require an ALTER SUBSCRIPTION ... REFRESH PUBLICATION action on the subscribing side in order to become effective. Likewise altering a - publication to set ALL TABLES or to set or unset - ALL SEQUENCES also requires the subscriber to refresh the - publication. Note also that DROP TABLES IN SCHEMA will - not drop any schema tables that were specified using + publication to set ALL TABLES, to change the + EXCEPT list, or to set ALL SEQUENCES + also requires the subscriber to refresh the publication. Note also that + DROP TABLES IN SCHEMA will not drop any schema tables + that were specified using FOR TABLE/ ADD TABLE.