Update documentation to reflect the new ALTER OWNER rules for all

affected types of objects.

diff --git a/doc/src/sgml/ref/alter_aggregate.sgml b/doc/src/sgml/ref/alter_aggregate.sgml
index b8d90751235346dc95676da621d52afbde70e8c1..c3311b99ce77a785c8c1beb23165507f3c0b3f2d 100644 (file)
--- a/doc/src/sgml/ref/alter_aggregate.sgml
+++ b/doc/src/sgml/ref/alter_aggregate.sgml
@@ -1,5 +1,5 @@
 
 
@@ -35,11 +35,15 @@ ALTER AGGREGATE name ( type
   
 
   
-   You must own the aggregate function to use ALTER AGGREGATE;
-   except for ALTER AGGREGATE OWNER, which may only be executed by
-   a superuser.
+   You must own the aggregate function to use ALTER AGGREGATE.
    To change the schema of an aggregate function, you must also have
    CREATE privilege on the new schema.
+   To alter the owner, you must also be a direct or indirect member of the new
+   owning role, and that role must have CREATE privilege on
+   the aggregate function's schema.  (These restrictions enforce that altering
+   the owner doesn't do anything you couldn't do by dropping and recreating
+   the aggregate function.  However, a superuser can alter ownership of any
+   aggregate function anyway.)
   
  
   

diff --git a/doc/src/sgml/ref/alter_conversion.sgml b/doc/src/sgml/ref/alter_conversion.sgml
index dc86fcf6816b60076ddc0b62e40e804ce8be3452..50ab29a48acf6c403061b26711a0c2e55ebb21d9 100644 (file)
--- a/doc/src/sgml/ref/alter_conversion.sgml
+++ b/doc/src/sgml/ref/alter_conversion.sgml
@@ -1,5 +1,5 @@
 
 
@@ -32,6 +32,16 @@ ALTER CONVERSION name OWNER TO newowner<
    ALTER CONVERSION changes the definition of a
    conversion.
   
+
+  
+   You must own the conversion to use ALTER CONVERSION.
+   To alter the owner, you must also be a direct or indirect member of the new
+   owning role, and that role must have CREATE privilege on
+   the conversion's schema.  (These restrictions enforce that altering the
+   owner doesn't do anything you couldn't do by dropping and recreating the
+   conversion. However, a superuser can alter ownership of any conversion
+   anyway.)
+  
  
   
  
@@ -60,8 +70,7 @@ ALTER CONVERSION name OWNER TO newowner<
     newowner
     
      
-      The new owner of the conversion. To change the owner of a conversion,
-      you must be a superuser.
+      The new owner of the conversion.
      
     
    

diff --git a/doc/src/sgml/ref/alter_database.sgml b/doc/src/sgml/ref/alter_database.sgml
index 03333d3d99b73d00067f3db5221ed41361f90601..9c19f849f2f323580f18125ee8a6ed45b0429e9d 100644 (file)
--- a/doc/src/sgml/ref/alter_database.sgml
+++ b/doc/src/sgml/ref/alter_database.sgml
@@ -1,5 +1,5 @@
 
 
@@ -71,8 +71,11 @@ ALTER DATABASE name OWNER TO 
   
 
   
-   The fifth form changes the owner of the database.  Only a superuser
-   can change the database's owner.
+   The fifth form changes the owner of the database.
+   To alter the owner, you must own the database and also be a direct or
+   indirect member of the new owning role, and you must have the
+   CREATEDB privilege.
+   (Note that superusers have all these privileges automatically.)
   
  
 

diff --git a/doc/src/sgml/ref/alter_domain.sgml b/doc/src/sgml/ref/alter_domain.sgml
index 4cc6b25018b7500e04883b94c92ee36abe5f13ad..f3ed88c9e27ad4034ebef0620de546ee3d8a46b4 100644 (file)
--- a/doc/src/sgml/ref/alter_domain.sgml
+++ b/doc/src/sgml/ref/alter_domain.sgml
@@ -1,5 +1,5 @@
 
 
@@ -112,10 +112,14 @@ ALTER DOMAIN name
   
 
   
-   You must own the domain to use ALTER DOMAIN; except for
-   ALTER DOMAIN OWNER, which may only be executed by a superuser.
-   To change a domain's schema, you must also have CREATE
-   privilege on the new schema.
+   You must own the domain to use ALTER DOMAIN.
+   To change the schema of a domain, you must also have
+   CREATE privilege on the new schema.
+   To alter the owner, you must also be a direct or indirect member of the new
+   owning role, and that role must have CREATE privilege on
+   the domain's schema.  (These restrictions enforce that altering the owner
+   doesn't do anything you couldn't do by dropping and recreating the domain.
+   However, a superuser can alter ownership of any domain anyway.)
   
  
 

diff --git a/doc/src/sgml/ref/alter_function.sgml b/doc/src/sgml/ref/alter_function.sgml
index 211a350f84037f7649077cba167ef8cfb6f926a1..a3dd38d2d4af7d2ed7f10e0081202fd1693a74a9 100644 (file)
--- a/doc/src/sgml/ref/alter_function.sgml
+++ b/doc/src/sgml/ref/alter_function.sgml
@@ -1,5 +1,5 @@
 
 
@@ -46,10 +46,14 @@ where action is one of:
   
 
   
-   You must own the function to use ALTER FUNCTION; except for
-   ALTER FUNCTION OWNER, which may only be executed by a superuser.
+   You must own the function to use ALTER FUNCTION.
    To change a function's schema, you must also have CREATE
    privilege on the new schema.
+   To alter the owner, you must also be a direct or indirect member of the new
+   owning role, and that role must have CREATE privilege on
+   the function's schema.  (These restrictions enforce that altering the owner
+   doesn't do anything you couldn't do by dropping and recreating the function.
+   However, a superuser can alter ownership of any function anyway.)
   
  
   

diff --git a/doc/src/sgml/ref/alter_opclass.sgml b/doc/src/sgml/ref/alter_opclass.sgml
index d4171ceb2f9adf0f8081e57ca69e5e81ab0ac217..e1d09fe905069c2f7d5b4ef3d215fbd18523f1bd 100644 (file)
--- a/doc/src/sgml/ref/alter_opclass.sgml
+++ b/doc/src/sgml/ref/alter_opclass.sgml
@@ -1,5 +1,5 @@
 
 
@@ -32,6 +32,16 @@ ALTER OPERATOR CLASS name USING 
    ALTER OPERATOR CLASS changes the definition of
    an operator class.
   
+
+  
+   You must own the operator class to use ALTER OPERATOR CLASS.
+   To alter the owner, you must also be a direct or indirect member of the new
+   owning role, and that role must have CREATE privilege on
+   the operator class's schema.  (These restrictions enforce that altering the
+   owner doesn't do anything you couldn't do by dropping and recreating the
+   operator class.  However, a superuser can alter ownership of any operator
+   class anyway.)
+  
  
   
  
@@ -71,7 +81,6 @@ ALTER OPERATOR CLASS name USING 
     
      
       The new owner of the operator class.
-      You must be a superuser to change the owner of an operator class.
      
     
    

diff --git a/doc/src/sgml/ref/alter_operator.sgml b/doc/src/sgml/ref/alter_operator.sgml
index cfec153f2bbd47aecd575ff1d1f61c4eb2a8e674..bd9aa24f0f8e30db92c4db39aa43dbd789066952 100644 (file)
--- a/doc/src/sgml/ref/alter_operator.sgml
+++ b/doc/src/sgml/ref/alter_operator.sgml
@@ -1,5 +1,5 @@
 
 
@@ -32,6 +32,15 @@ ALTER OPERATOR name ( { lefttype
    an operator.  The only currently available functionality is to change the
    owner of the operator.
   
+
+  
+   You must own the operator to use ALTER OPERATOR.
+   To alter the owner, you must also be a direct or indirect member of the new
+   owning role, and that role must have CREATE privilege on
+   the operator's schema.  (These restrictions enforce that altering the owner
+   doesn't do anything you couldn't do by dropping and recreating the operator.
+   However, a superuser can alter ownership of any operator anyway.)
+  
  
   
  
@@ -72,7 +81,6 @@ ALTER OPERATOR name ( { lefttype
     
      
       The new owner of the operator.
-      You must be a superuser to change the owner of an operator.
      
     
    

diff --git a/doc/src/sgml/ref/alter_schema.sgml b/doc/src/sgml/ref/alter_schema.sgml
index 702df1da39608eb3fdd302730da16f4ee8d2fad6..27acc8ca04128a6e3e535c8b6ecf7710f71463e5 100644 (file)
--- a/doc/src/sgml/ref/alter_schema.sgml
+++ b/doc/src/sgml/ref/alter_schema.sgml
@@ -1,5 +1,5 @@
 
 
@@ -30,9 +30,16 @@ ALTER SCHEMA name OWNER TO newowner
 
   
    ALTER SCHEMA changes the definition of a schema.
-   To rename a schema you must own the schema and have the privilege
-   CREATE for the database.  To change the owner
-   of a schema, you must be a superuser.
+  
+
+  
+   You must own the schema to use ALTER SCHEMA.
+   To rename a schema you must also have the
+   CREATE privilege for the database.
+   To alter the owner, you must also be a direct or
+   indirect member of the new owning role, and you must have the
+   CREATE privilege for the database.
+   (Note that superusers have all these privileges automatically.)
   
  
 

diff --git a/doc/src/sgml/ref/alter_tablespace.sgml b/doc/src/sgml/ref/alter_tablespace.sgml
index bdfe4b815532b5e1dc4d4d01f94721d7058e38f5..29c9d6778ff980ca37cf1f4f2152eb5d8cf47410 100644 (file)
--- a/doc/src/sgml/ref/alter_tablespace.sgml
+++ b/doc/src/sgml/ref/alter_tablespace.sgml
@@ -1,5 +1,5 @@
 
 
@@ -32,6 +32,13 @@ ALTER TABLESPACE name OWNER TO newowner<
    ALTER TABLESPACE changes the definition of
    a tablespace.
   
+
+  
+   You must own the tablespace to use ALTER TABLESPACE.
+   To alter the owner, you must also be a direct or indirect member of the new
+   owning role.
+   (Note that superusers have these privileges automatically.)
+  
  
   
  
@@ -63,7 +70,6 @@ ALTER TABLESPACE name OWNER TO newowner<
     
      
       The new owner of the tablespace.
-      You must be a superuser to change the owner of a tablespace.
      
     
    

diff --git a/doc/src/sgml/ref/alter_type.sgml b/doc/src/sgml/ref/alter_type.sgml
index 915a1bd1bab1963c162d98fed82188e647dd04a2..bde77b44f0d002738b498e0279943fc462be1360 100644 (file)
--- a/doc/src/sgml/ref/alter_type.sgml
+++ b/doc/src/sgml/ref/alter_type.sgml
@@ -1,5 +1,5 @@
 
 
@@ -37,6 +37,17 @@ ALTER TYPE name SET SCHEMA 
    The only currently available capabilities are changing the owner and schema
    of a type.
   
+
+  
+   You must own the type to use ALTER TYPE.
+   To change the schema of a type, you must also have
+   CREATE privilege on the new schema.
+   To alter the owner, you must also be a direct or indirect member of the new
+   owning role, and that role must have CREATE privilege on
+   the type's schema.  (These restrictions enforce that altering the owner
+   doesn't do anything you couldn't do by dropping and recreating the type.
+   However, a superuser can alter ownership of any type anyway.)
+  
  
 
  
@@ -59,7 +70,6 @@ ALTER TYPE name SET SCHEMA 
       
        
         The user name of the new owner of the type.
-        You must be a superuser to change a type's owner.
        
       
      
@@ -68,9 +78,7 @@ ALTER TYPE name SET SCHEMA 
       new_schema
       
        
-        The new schema for the type.  To move a
-        type to a new schema, you must be the owner of the
-        type and have CREATE privilege on the new schema.
+        The new schema for the type.