doc: Fix ALTER PUBLICATION details

Some of the text was made nonsensical by commit
e9500240661c03750923e6f539bfa2d75cfaa32a.  Fix that and make some other
minor changes.

Reported-by: Jeff Janes 

diff --git a/doc/src/sgml/ref/alter_publication.sgml b/doc/src/sgml/ref/alter_publication.sgml
index 7b8f114f54146c32eec285f3a10108f3b3780ff9..cc5d92f0410ad1cd66411c434d19b95fa672684a 100644 (file)
--- a/doc/src/sgml/ref/alter_publication.sgml
+++ b/doc/src/sgml/ref/alter_publication.sgml
@@ -34,28 +34,40 @@ ALTER PUBLICATION name RENAME TO 
   Description
 
   
-   The first variant of this command listed in the synopsis can change
+   The command ALTER PUBLICATION can change the attributes
+   of a publication.
+  
+
+  
+   The first three variants change which tables are part of the publication.
+   The SET TABLE clause will replace the list of tables in
+   the publication with the specified one.  The ADD TABLE
+   and DROP TABLE clauses will add and remove one or more
+   tables from the publication.  Note that adding tables to a publication that
+   is already subscribed to will require a ALTER SUBSCRIPTION
+   ... REFRESH PUBLICATION action on the subscribing side in order
+   to become effective.
+  
+
+  
+   The fourth variant of this command listed in the synopsis can change
    all of the publication properties specified in
    .  Properties not mentioned in the
    command retain their previous settings.
   
 
   
+   The remaining variants change the owner and the name of the publication.
+  
+
+  
+   You must own the publication to use ALTER PUBLICATION.
    To alter the owner, you must also be a direct or indirect member of the new
    owning role. The new owner must have CREATE privilege on
    the database.  Also, the new owner of a FOR ALL TABLES
    publication must be a superuser.  However, a superuser can change the
    ownership of a publication while circumventing these restrictions.
   
-
-  
-   The other variants of this command deal with the table membership of the
-   publication.  The SET TABLE clause will replace the
-   list of tables in the publication with the specified one.
-   The ADD TABLE and
-   DROP TABLE will add and remove one or more tables from
-   the publication.
-  
  
 
  
@@ -147,6 +159,8 @@ ALTER PUBLICATION mypublication ADD TABLE users, departments;
   
    
    
+   
+   
   
  
 

diff --git a/doc/src/sgml/ref/alter_subscription.sgml b/doc/src/sgml/ref/alter_subscription.sgml
index 113e32bfd00ea04d3388ce242611fb606ce5a2e4..a3471a044227e879b843dc5ef427eddbc0e5c134 100644 (file)
--- a/doc/src/sgml/ref/alter_subscription.sgml
+++ b/doc/src/sgml/ref/alter_subscription.sgml
@@ -42,8 +42,11 @@ ALTER SUBSCRIPTION name RENAME TO <
   
 
   
+   You must own the subscription to use ALTER SUBSCRIPTION.
    To alter the owner, you must also be a direct or indirect member of the
    new owning role. The new owner has to be a superuser.
+   (Currently, all subscription owners must be superusers, so the owner checks
+   will be bypassed in practice.  But this might change in the future.)