From 26834e8633d1275c4fd17a619b7cf8a0bdf33c27 Mon Sep 17 00:00:00 2001
From: Nisha Moond <nisha.moond412@gmail.com>
Date: Tue, 2 Jun 2026 15:58:46 +0530
Subject: [PATCH v2] doc: add missing EXCEPT parameter entry in ALTER
 PUBLICATION

The EXCEPT clause was included in the syntax and described briefly in
the command description, but was missing from the Parameters section.

Add a parameter entry describing its behavior in ALTER PUBLICATION.

This patch also adds an example to convert an ALL TABLES publication
to ALL SEQUENCES one.
---
 doc/src/sgml/ref/alter_publication.sgml | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/doc/src/sgml/ref/alter_publication.sgml b/doc/src/sgml/ref/alter_publication.sgml
index 52114a16a39..e91931f3393 100644
--- a/doc/src/sgml/ref/alter_publication.sgml
+++ b/doc/src/sgml/ref/alter_publication.sgml
@@ -198,6 +198,21 @@ ALTER PUBLICATION <replaceable class="parameter">name</replaceable> RENAME TO <r
     </listitem>
    </varlistentry>
 
+   <varlistentry>
+    <term><literal>EXCEPT</literal></term>
+    <listitem>
+     <para>
+      This clause can be used with <literal>SET ALL TABLES</literal> to
+      specify a list of tables to be excluded from the publication.  If
+      <literal>EXCEPT</literal> is specified, the existing exclusion list is
+      replaced with the specified tables.  If <literal>EXCEPT</literal> is
+      omitted, any existing table exclusions are removed.  See
+      <link linkend="sql-createpublication-params-for-except-table"><command>CREATE PUBLICATION</command> ... <literal>EXCEPT</literal></link>
+      for details.
+     </para>
+    </listitem>
+   </varlistentry>
+
    <varlistentry>
     <term><literal>SET ( <replaceable class="parameter">publication_parameter</replaceable> [= <replaceable class="parameter">value</replaceable>] [, ... ] )</literal></term>
     <listitem>
@@ -277,6 +292,13 @@ ALTER PUBLICATION mypublication SET ALL TABLES EXCEPT (TABLE users, departments)
    with no excluded tables:
 <programlisting>
 ALTER PUBLICATION mypublication SET ALL TABLES;
+</programlisting></para>
+
+  <para>
+   Convert a <literal>FOR ALL TABLES</literal> publication into a
+   <literal>FOR ALL SEQUENCES</literal> publication:
+<programlisting>
+ALTER PUBLICATION mypublication SET ALL SEQUENCES;
 </programlisting></para>
 
   <para>
-- 
2.50.1 (Apple Git-155)

