diff --git a/doc/src/sgml/ref/alter_tablespace.sgml b/doc/src/sgml/ref/alter_tablespace.sgml
index 5c98bc7f06..bd1afb4b72 100644
--- 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.)
+
- 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.
+
+ 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 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.
+
+ 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. The
- NOWAIT option, if specified, will cause the command to fail if it is unable
- to acquire the locks.
+
+ 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- 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.
+
+ 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;