doc: Fix up ALTER TABLESPACE reference page

The documentation of ALTER TABLESPACE ... MOVE was added without any
markup, not even paragraph breaks.  Fix that, and clarify the text in a
few places.

diff --git a/doc/src/sgml/ref/alter_tablespace.sgml b/doc/src/sgml/ref/alter_tablespace.sgml
index 5c98bc7f067ec1b274bea3fb6db4982a18917ad5..bd1afb4b727257932034faef944b17477d8172ef 100644 (file)
--- a/doc/src/sgml/ref/alter_tablespace.sgml
+++ b/doc/src/sgml/ref/alter_tablespace.sgml
@@ -43,30 +43,45 @@ ALTER TABLESPACE name MOVE { ALL | TABLES | INDEXES |
    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.)
+  
+
+  
+   ALTER TABLESPACE ... MOVE moves objects between
+   tablespaces.  ALL will move all tables, indexes and
+   materialized views; specifying TABLES will move only
+   tables (but not their indexes), INDEXES will only move
+   indexes (including those underneath materialized views, but not tables),
+   and MATERIALIZED VIEWS will only move the table relation
+   of the materialized view (but no indexes associated with it).  Users can
+   also specify a list of roles whose objects are to be moved, using
+   OWNED BY.
+  
 
-   Users may use ALTER TABLESPACE ... MOVE to move objects between tablespaces.
-   ALL will move all tables, indexes and materialized views while specifying
-   TABLES will move only tables (but not their indexes), INDEXES will only move
-   indexes (including those underneath materialized views, but not tables) and
-   MATERIALIZED VIEWS will only move the table relation of the materialized
-   view (but no indexes associated with it).  Users may also specify a list of
-   roles whose objects are to be moved using OWNED BY.
-
-   Users must have CREATE rights on the new tablespace and be considered an
-   owner (either directly or indirectly) on all objects to be moved.  Note that
-   the superuser is considered an owner of all objects and therefore an
-   ALTER TABLESPACE ... MOVE ALL issued by the superuser will move all objects
-   in the current database which are in the tablespace.
-
-   All objects to be moved will be locked immediately by the command.  The
-   NOWAIT option, if specified, will cause the command to fail if it is unable
-   to acquire the locks.
-
-   System catalogs will not be moved by this command- individuals wishing to
-   move a whole database should use ALTER DATABASE, or call ALTER TABLE on the
-   individual system catalogs.  Note that relations in information_schema
-   will be moved, just as any other normal database objects, if the user is the
-   superuser or considered an owner of the relations in information_schema.
+  
+   Users must have CREATE rights on the new tablespace and
+   be considered an owner (either directly or indirectly) of all objects to be
+   moved.  Note that the superuser is considered an owner of all objects, and
+   therefore an ALTER TABLESPACE ... MOVE ALL issued by the
+   superuser will move all objects in the current database that are in the
+   tablespace.  (Attempting to move objects without the required rights will
+   result in an error.  Non-superusers can use OWNED BY in
+   such cases, to restrict the set of objects moved to those with the required
+   rights.)
+  
+
+  
+   All objects to be moved will be locked immediately by the command.  If the
+   NOWAIT is specified, it will cause the command to fail
+   if it is unable to acquire the locks.
+  
+
+  
+   System catalogs will not be moved by this command.  To move a whole
+   database, use ALTER DATABASE, or call ALTER
+   TABLE on the individual system catalogs.  Note that relations in
+   information_schema will be moved, just as any other
+   normal database objects, if the user is the superuser or considered an
+   owner of the relations in information_schema.
   
  
 
@@ -125,7 +140,7 @@ ALTER TABLESPACE name MOVE { ALL | TABLES | INDEXES |
     role_name
     
      
-      Role(s) whose objects are to be moved.
+      Role whose objects are to be moved.
      
     
    
@@ -135,7 +150,7 @@ ALTER TABLESPACE name MOVE { ALL | TABLES | INDEXES |
     
      
       The name of the tablespace to move objects into.  The user must have
-      CREATE rights on the new tablespace to move objects into that
+      CREATE rights on the new tablespace to move objects into that
       tablespace, unless the tablespace being moved into is the default
       tablespace for the database connected to.
      
@@ -143,12 +158,12 @@ ALTER TABLESPACE name MOVE { ALL | TABLES | INDEXES |
    
 
    
-    NOWAIT
+    NOWAIT
     
      
-      The NOWAIT option causes the ALTER TABLESPACE command to fail immediately
+      The NOWAIT option causes the ALTER TABLESPACE command to fail immediately
       if it is unable to acquire the necessary lock on all of the objects being
-      move.
+      moved.
      
     
    
@@ -173,7 +188,7 @@ ALTER TABLESPACE index_space OWNER TO mary;
 
 
   
-   Move all of the objects which I own from the default tablespace to
+   Move all of the objects from the default tablespace to
    the fast_raid tablespace:
 
 ALTER TABLESPACE pg_default MOVE ALL TO fast_raid;