diff --git a/doc/src/sgml/ref/abort.sgml b/doc/src/sgml/ref/abort.sgml
index e83b21e4d5..f0e436fccd 100644
--- a/doc/src/sgml/ref/abort.sgml
+++ b/doc/src/sgml/ref/abort.sgml
@@ -1,5 +1,5 @@
@@ -31,7 +31,8 @@ ABORT [ WORK | TRANSACTION ]
ABORT rolls back the current transaction and causes
all the updates made by the transaction to be discarded.
This command is identical
- in behavior to the standard SQL command ROLLBACK,
+ in behavior to the standard SQL command
+ ,
and is present only for historical reasons.
@@ -52,36 +53,17 @@ ABORT [ WORK | TRANSACTION ]
-
- Diagnostics
-
-
-
- ROLLBACK
-
-
- Message returned if successful.
-
-
-
-
-
- WARNING: ROLLBACK: no transaction in progress
-
-
- If there is not any transaction currently in progress.
-
-
-
-
-
-
Notes
- Use COMMIT to successfully
- terminate a transaction.
+ Use to
+ successfully terminate a transaction.
+
+
+
+ Issuing ABORT when not inside a transaction does
+ no harm, but it will provoke a warning message.
@@ -106,6 +88,15 @@ ABORT;
+
+ See Also
+
+
+
+
+
+
+
@@ -29,8 +29,8 @@ ALTER AGGREGATE name ( typeALTER AGGREGATE changes the definition of an
- aggregate function. The only functionality is to rename the
- aggregate function.
+ aggregate function. The only currently available functionality is to
+ rename the aggregate function.
@@ -67,21 +67,6 @@ ALTER AGGREGATE name ( type
-
-
- Diagnostics
-
-
-
- ALTER AGGREGATE
-
-
- Message returned if the command was successful.
-
-
-
-
- Examples
diff --git a/doc/src/sgml/ref/alter_conversion.sgml b/doc/src/sgml/ref/alter_conversion.sgml
index d1ab87c3b5..5b07ef2b1d 100644
--- a/doc/src/sgml/ref/alter_conversion.sgml
+++ b/doc/src/sgml/ref/alter_conversion.sgml
@@ -1,5 +1,5 @@
@@ -29,7 +29,8 @@ ALTER CONVERSION name RENAME TO newname<
ALTER CONVERSION changes the definition of a
- conversion. The only functionality is to rename the conversion.
+ conversion. The only currently available functionality is to rename the
+ conversion.
@@ -56,21 +57,6 @@ ALTER CONVERSION name RENAME TO newname<
-
-
- Diagnostics
-
-
-
- ALTER CONVERSION
-
-
- Message returned if the command was successful.
-
-
-
-
- Examples
diff --git a/doc/src/sgml/ref/alter_database.sgml b/doc/src/sgml/ref/alter_database.sgml
index 6e8da1f030..cdc5e7f13e 100644
--- a/doc/src/sgml/ref/alter_database.sgml
+++ b/doc/src/sgml/ref/alter_database.sgml
@@ -1,5 +1,5 @@
@@ -103,31 +103,6 @@ ALTER DATABASE name RENAME TO
-
- Diagnostics
-
-
-
- ALTER DATABASE
-
-
- Message returned if the alteration was successful.
-
-
-
-
-
- ERROR: database "dbname" does not exist
-
-
- Error message returned if the specified database is not known
- to the system.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/alter_domain.sgml b/doc/src/sgml/ref/alter_domain.sgml
index f31311b633..09e3db3ad8 100644
--- a/doc/src/sgml/ref/alter_domain.sgml
+++ b/doc/src/sgml/ref/alter_domain.sgml
@@ -1,5 +1,5 @@
@@ -23,9 +23,6 @@ PostgreSQL documentation
-
- 2002-11-27
-
ALTER DOMAIN domain
{ SET DEFAULT value | DROP DEFAULT }
@@ -38,116 +35,11 @@ ALTER DOMAIN domain
ALTER DOMAIN domain
OWNER TO new_owner
-
-
-
- 2002-11-27
-
-
- Inputs
-
-
-
-
-
- domain
-
-
- The name (possibly schema-qualified) of an existing domain to
- alter.
-
-
-
-
-
- domain_constraint
-
-
- New domain constraint for the domain.
-
-
-
-
-
- constraint_name
-
-
- Name of an existing constraint to drop.
-
-
-
-
-
- CASCADE
-
-
- Automatically drop objects that depend on the constraint.
-
-
-
-
-
- RESTRICT
-
-
- Refuse to drop the constraint if there are any dependent
- objects. This is the default behavior.
-
-
-
-
-
- new_owner
-
-
- The user name of the new owner of the domain.
-
-
-
-
-
-
-
-
-
-
- 1998-04-15
-
-
- Outputs
-
-
-
-
-
- ALTER DOMAIN
-
-
- Message returned from domain alteration.
-
-
-
-
-
- ERROR
-
-
- Message returned if domain is not available.
-
-
-
-
-
-
-
-
- 2002-11-27
-
-
- Description
-
+
+ Description
+
ALTER DOMAIN changes the definition of an existing domain.
There are several sub-forms:
@@ -213,10 +105,74 @@ ALTER DOMAIN domain
-
-
- Usage
-
+
+ Parameters
+
+
+
+
+ domain
+
+
+ The name (possibly schema-qualified) of an existing domain to
+ alter.
+
+
+
+
+
+ domain_constraint
+
+
+ New domain constraint for the domain.
+
+
+
+
+
+ constraint_name
+
+
+ Name of an existing constraint to drop.
+
+
+
+
+
+ CASCADE
+
+
+ Automatically drop objects that depend on the constraint.
+
+
+
+
+
+ RESTRICT
+
+
+ Refuse to drop the constraint if there are any dependent
+ objects. This is the default behavior.
+
+
+
+
+
+ new_owner
+
+
+ The user name of the new owner of the domain.
+
+
+
+
+
+
+
+
+
+ Examples
+
To add a NOT NULL constraint to a domain:
@@ -243,6 +199,15 @@ ALTER DOMAIN zipcode DROP CONSTRAINT zipchk;
+
+ Compatibility
+
+
+ The ALTER DOMAIN statement is compatible with SQL99,
+ except for the OWNER variant, which is a
+ PostgreSQL extension.
+
+
@@ -65,21 +65,6 @@ ALTER FUNCTION name ( [ groupname RENAME TO
-
- Diagnostics
-
-
-
- ALTER GROUP
-
-
- Message returned if the alteration was successful.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/alter_language.sgml b/doc/src/sgml/ref/alter_language.sgml
index c20ceded64..61595252eb 100644
--- a/doc/src/sgml/ref/alter_language.sgml
+++ b/doc/src/sgml/ref/alter_language.sgml
@@ -1,5 +1,5 @@
@@ -58,21 +58,6 @@ ALTER LANGUAGE name RENAME TO newname
-
- Diagnostics
-
-
-
- ALTER LANGUAGE
-
-
- Message returned if the alteration was successful.
-
-
-
-
-
-
Compatibility
diff --git a/doc/src/sgml/ref/alter_opclass.sgml b/doc/src/sgml/ref/alter_opclass.sgml
index be31dd98eb..3a4ec0c7df 100644
--- a/doc/src/sgml/ref/alter_opclass.sgml
+++ b/doc/src/sgml/ref/alter_opclass.sgml
@@ -1,5 +1,5 @@
@@ -67,21 +67,6 @@ ALTER OPERATOR CLASS name USING seqname [ INCREMENT [ BY ] increment ]
[ MINVALUE minvalue | NO MINVALUE ] [ MAXVALUE maxvalue | NO MAXVALUE ]
[ RESTART [ WITH ] start ] [ CACHE cache ] [ [ NO ] CYCLE ]
-
-
-
- 1998-09-11
-
-
- Inputs
-
-
+
+
+ Description
+
+
+ ALTER SEQUENCE changes the parameters of an existing
+ sequence generator. Any parameter not specifically set in the
+ ALTER SEQUENCE command retains its prior setting.
+
+
+
+
+ Parameters
+
+ seqname
@@ -100,8 +103,8 @@ ALTER SEQUENCE seqname [ INCREMENT
The optional enables the sequence to re-begin anywhere.
+ start
+ clause changes the current value of the sequence.
@@ -151,78 +154,11 @@ ALTER SEQUENCE seqname [ INCREMENT
-
+
-
-
- 1998-09-11
-
-
- Outputs
-
-
+
+ Examples
-
-
-
-ALTER SEQUENCE
-
-
-
- Message returned if the command is successful.
-
-
-
-
-
-ERROR: AlterSequence: MINVALUE (start) can't be >= MAXVALUE (max)
-
-
-
- If the specified starting value is out of range.
-
-
-
-
-
-ERROR: AlterSequence: START value (start) can't be < MINVALUE (min)
-
-
-
- If the specified starting value is out of range.
-
-
-
-
-
-ERROR: AlterSequence: MINVALUE (min) can't be >= MAXVALUE (max)
-
-
-
- If the minimum and maximum values are inconsistent.
-
-
-
-
-
-
-
-
-
-
- Description
-
-
-
- See for limitations, and uses
- of sequences.
-
-
-
-
-
- Usage
-
Restart a sequence called serial, at 105:
@@ -231,35 +167,31 @@ ALTER SEQUENCE serial RESTART WITH 105;
-
-
- Notes
-
+
+ Notes
+
- To avoid blocking of concurrent transactions that obtain numbers from the same
- sequence, a nextval operation is never rolled back; that is, once a value has
- been fetched it is considered used, even if the transaction that did the nextval
- later aborts. This means that aborted transactions may leave unused "holes" in
- the sequence of assigned values. setval operations are never rolled back, either.
+ To avoid blocking of concurrent transactions that obtain numbers from the
+ same sequence, ALTER SEQUENCE is never rolled back;
+ the changes take effect immediately and are not reversible.
+
- ALTER SEQUENCE will not immediately affect backends, other than the
- current one, which have cached sequence values. They must use up all cached values
- prior to noticing the changed sequence parameters. The current backend will be
- immediatly affected.
+ ALTER SEQUENCE will not immediately affect
+ nextval results in backends,
+ other than the current one, that have preallocated (cached) sequence
+ values. They will use up all cached values prior to noticing the changed
+ sequence parameters. The current backend will be affected immediately.
-
+
Compatibility
-
-
- 2003-03-02
-
+
SQL99
diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml
index 2dd377c058..87d1a64577 100644
--- a/doc/src/sgml/ref/alter_table.sgml
+++ b/doc/src/sgml/ref/alter_table.sgml
@@ -1,5 +1,5 @@
@@ -331,30 +331,6 @@ ALTER TABLE table
-
- Diagnostics
-
-
-
- ALTER TABLE
-
-
- Message returned if successful.
-
-
-
-
-
- ERROR
-
-
- Message returned if table or column does not exist.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/alter_trigger.sgml b/doc/src/sgml/ref/alter_trigger.sgml
index f840913652..ee7afa87d8 100644
--- a/doc/src/sgml/ref/alter_trigger.sgml
+++ b/doc/src/sgml/ref/alter_trigger.sgml
@@ -1,5 +1,5 @@
@@ -41,7 +41,7 @@ ALTER TRIGGER trigger ON
- Parameter
+ Parameters
@@ -73,31 +73,6 @@ ALTER TRIGGER trigger ON
-
- Diagnostics
-
-
-
- ALTER TRIGGER
-
-
- Message returned if successful.
-
-
-
-
-
- ERROR
-
-
- If the trigger does not exist, or the new name is a duplicate of
- another existing trigger on the table.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/alter_user.sgml b/doc/src/sgml/ref/alter_user.sgml
index f3c7292718..3db6df0052 100644
--- a/doc/src/sgml/ref/alter_user.sgml
+++ b/doc/src/sgml/ref/alter_user.sgml
@@ -1,5 +1,5 @@
@@ -175,31 +175,6 @@ ALTER USER username RESET
-
- Diagnostics
-
-
-
- ALTER USER
-
-
- Message returned if the alteration was successful.
-
-
-
-
-
- ERROR: ALTER USER: user "username" does not exist
-
-
- Error message returned if the specified user is not known to
- the database system.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/analyze.sgml b/doc/src/sgml/ref/analyze.sgml
index 93d8676363..f0be5af1db 100644
--- a/doc/src/sgml/ref/analyze.sgml
+++ b/doc/src/sgml/ref/analyze.sgml
@@ -1,5 +1,5 @@
@@ -77,21 +77,6 @@ ANALYZE [ VERBOSE ] [ table [ (
-
- Diagnostics
-
-
-
- ANALYZE
-
-
- The command is complete.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/begin.sgml b/doc/src/sgml/ref/begin.sgml
index 67393c891b..5acab231b3 100644
--- a/doc/src/sgml/ref/begin.sgml
+++ b/doc/src/sgml/ref/begin.sgml
@@ -1,5 +1,5 @@
@@ -28,21 +28,25 @@ BEGIN [ WORK | TRANSACTION ]
Description
- By default, PostgreSQL executes
- transactions in autocommit mode, that is, each
- statement is executed in its own transaction and a commit is
- implicitly performed at the end of the statement (if execution was
- successful, otherwise a rollback is done).
BEGIN initiates a transaction block, that is,
all statements after BEGIN command will be
executed in a single transaction until an explicit or . Statements
- are executed more quickly in a transaction block, because
+ linkend="sql-rollback" endterm="sql-rollback-title"> is given.
+ By default (without BEGIN),
+ PostgreSQL executes
+ transactions in autocommit mode, that is, each
+ statement is executed in its own transaction and a commit is
+ implicitly performed at the end of the statement (if execution was
+ successful, otherwise a rollback is done).
+
+
+
+ Statements are executed more quickly in a transaction block, because
transaction start/commit requires significant CPU and disk
activity. Execution of multiple statements inside a transaction is
- also useful to ensure consistency when changing several related
- tables: other sessions will be unable to see the intermediate states
+ also useful to ensure consistency when making several related changes:
+ other sessions will be unable to see the intermediate states
wherein not all the related updates have been done.
@@ -63,31 +67,6 @@ BEGIN [ WORK | TRANSACTION ]
-
- Diagnostics
-
-
-
- BEGIN
-
-
- This signifies that a new transaction has been started.
-
-
-
-
-
- WARNING: BEGIN: already a transaction in progress
-
-
- This indicates that a transaction was already in progress. The
- current transaction is not affected.
-
-
-
-
-
-
Notes
@@ -100,7 +79,12 @@ BEGIN [ WORK | TRANSACTION ]
Use or
- to terminate a transaction.
+ to terminate a transaction block.
+
+
+
+ Issuing BEGIN when already inside a transaction block will
+ provoke a warning message. The state of the transaction is not affected.
@@ -138,6 +122,15 @@ BEGIN;
about the transaction semantics when porting database applications.
+
+
+ See Also
+
+
+
+
+
+
@@ -37,9 +37,10 @@ CLOSE cursor
Every non-holdable open cursor is implicitly closed when a
transaction is terminated by COMMIT or
- ROLLBACK. Holdable cursors are implicitely
- closed if the transaction that created them aborts via
- ROLLBACK; if this does not happen, the holdable
+ ROLLBACK. A holdable cursor is implicitly
+ closed if the transaction that created it aborts via
+ ROLLBACK. If the creating transaction successfully
+ commits, the holdable
cursor remains open until an explicit CLOSE is
executed, or the client disconnects.
@@ -59,32 +60,6 @@ CLOSE cursor
-
-
- Diagnostics
-
-
-
- CLOSE CURSOR
-
-
- Message returned if the cursor is successfully closed.
-
-
-
-
-
- ERROR: cursor "cursor" does not exist
-
-
- Message returned if cursor is not declared or has
- already been closed.
-
-
-
-
- Notes
diff --git a/doc/src/sgml/ref/cluster.sgml b/doc/src/sgml/ref/cluster.sgml
index eaa1763d2a..1eaa97e2e1 100644
--- a/doc/src/sgml/ref/cluster.sgml
+++ b/doc/src/sgml/ref/cluster.sgml
@@ -1,5 +1,5 @@
@@ -97,21 +97,6 @@ CLUSTER
-
- Diagnostics
-
-
-
- CLUSTER
-
-
- The clustering was done successfully.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/clusterdb.sgml b/doc/src/sgml/ref/clusterdb.sgml
index dce618f3c0..8d4e082ec0 100644
--- a/doc/src/sgml/ref/clusterdb.sgml
+++ b/doc/src/sgml/ref/clusterdb.sgml
@@ -1,5 +1,5 @@
@@ -54,6 +54,12 @@ PostgreSQL documentation
library will apply.
+
+ In case of difficulty, see and for
+ discussions of potential problems and error messages.
+
+
@@ -176,37 +182,6 @@ PostgreSQL documentation
-
- Diagnostics
-
-
-
-
- CLUSTER
-
-
- The database was successfully clustered.
-
-
-
-
-
- clusterdb: Cluster failed.
-
-
- Something went wrong. clusterdb is only a wrapper
- script. See
- and for a detailed
- discussion of error messages and potential problems.
-
-
-
-
-
-
-
-
-
Environment
diff --git a/doc/src/sgml/ref/comment.sgml b/doc/src/sgml/ref/comment.sgml
index 6927fb10a4..7e0f4318bf 100644
--- a/doc/src/sgml/ref/comment.sgml
+++ b/doc/src/sgml/ref/comment.sgml
@@ -1,5 +1,5 @@
@@ -96,21 +96,6 @@ COMMENT ON
-
- Diagnostics
-
-
-
- COMMENT
-
-
- Message returned if the comment was successfully changed.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/commit.sgml b/doc/src/sgml/ref/commit.sgml
index b4992f73ea..1c72ea0b45 100644
--- a/doc/src/sgml/ref/commit.sgml
+++ b/doc/src/sgml/ref/commit.sgml
@@ -1,5 +1,5 @@
@@ -49,30 +49,6 @@ COMMIT [ WORK | TRANSACTION ]
-
-
- Diagnostics
-
-
-
- COMMIT
-
-
- Message returned if the transaction was successfully committed.
-
-
-
-
-
- WARNING: COMMIT: no transaction in progress
-
-
- Message if there is no transaction in progress.
-
-
-
-
- Notes
@@ -81,6 +57,11 @@ COMMIT [ WORK | TRANSACTION ]
Use to
abort a transaction.
+
+
+ Issuing COMMIT when not inside a transaction does
+ no harm, but it will provoke a warning message.
+
@@ -103,6 +84,15 @@ COMMIT;
WORK. Otherwise, this command is fully conforming.
+
+
+ See Also
+
+
+
+
+
+
@@ -172,21 +172,6 @@ COPY table [ ( name (
written in any order, not just the order illustrated above.
-
-
- Diagnostics
-
-
-
- CREATE AGGREGATE
-
-
- Message returned if the command completes successfully.
-
-
-
-
- Examples
diff --git a/doc/src/sgml/ref/create_cast.sgml b/doc/src/sgml/ref/create_cast.sgml
index b89aead0bf..08f48fea1d 100644
--- a/doc/src/sgml/ref/create_cast.sgml
+++ b/doc/src/sgml/ref/create_cast.sgml
@@ -1,4 +1,4 @@
-
+
@@ -189,21 +189,6 @@ SELECT 'The time is ' || CAST(now() AS text);
-
- Diagnostics
-
-
-
- CREATE CAST
-
-
- Message returned if the cast was successfully created.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/create_constraint.sgml b/doc/src/sgml/ref/create_constraint.sgml
index 1cfcc39a8e..d48b3eea95 100644
--- a/doc/src/sgml/ref/create_constraint.sgml
+++ b/doc/src/sgml/ref/create_constraint.sgml
@@ -1,5 +1,5 @@
@@ -99,21 +99,6 @@ CREATE CONSTRAINT TRIGGER name
-
-
- Diagnostics
-
-
-
- CREATE TRIGGER
-
-
- Message returned if successful.
-
-
-
-
-
+
@@ -119,21 +119,6 @@ conv_proc(
-
- Diagnostics
-
-
-
- CREATE CONVERSION
-
-
- Message returned if the conversion was successfully created.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/create_domain.sgml b/doc/src/sgml/ref/create_domain.sgml
index 6adf9b7ec1..7a71e4a598 100644
--- a/doc/src/sgml/ref/create_domain.sgml
+++ b/doc/src/sgml/ref/create_domain.sgml
@@ -1,5 +1,5 @@
@@ -156,21 +156,6 @@ where constraint is:
-
- Diagnostics
-
-
-
- CREATE DOMAIN
-
-
- Message returned if the domain was successfully created.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/create_function.sgml b/doc/src/sgml/ref/create_function.sgml
index ef8274494e..39ba9ff588 100644
--- a/doc/src/sgml/ref/create_function.sgml
+++ b/doc/src/sgml/ref/create_function.sgml
@@ -1,5 +1,5 @@
@@ -314,21 +314,6 @@ CREATE [ OR REPLACE ] FUNCTION name
-
- Diagnostics
-
-
-
- CREATE FUNCTION
-
-
- Message returned if the function was successfully created.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/create_group.sgml b/doc/src/sgml/ref/create_group.sgml
index 1fb983721b..dea3c18ff9 100644
--- a/doc/src/sgml/ref/create_group.sgml
+++ b/doc/src/sgml/ref/create_group.sgml
@@ -1,5 +1,5 @@
@@ -84,21 +84,6 @@ where option can be:
-
-
- Diagnostics
-
-
-
- CREATE GROUP
-
-
- Message returned if the group was successfully created.
-
-
-
-
- Examples
diff --git a/doc/src/sgml/ref/create_index.sgml b/doc/src/sgml/ref/create_index.sgml
index 06c37f497e..3081f68ac8 100644
--- a/doc/src/sgml/ref/create_index.sgml
+++ b/doc/src/sgml/ref/create_index.sgml
@@ -1,5 +1,5 @@
@@ -185,21 +185,6 @@ CREATE [ UNIQUE ] INDEX index_name
-
- Diagnostics
-
-
-
- CREATE INDEX
-
-
- Message returned if the index was successfully created.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/create_language.sgml b/doc/src/sgml/ref/create_language.sgml
index c729ecc56f..45834255bb 100644
--- a/doc/src/sgml/ref/create_language.sgml
+++ b/doc/src/sgml/ref/create_language.sgml
@@ -1,5 +1,5 @@
@@ -147,21 +147,6 @@ CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE langna
-
- Diagnostics
-
-
-
- CREATE LANGUAGE
-
-
- Message returned if the language was successfully created.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/create_opclass.sgml b/doc/src/sgml/ref/create_opclass.sgml
index f205eab885..2ecf1cd4f2 100644
--- a/doc/src/sgml/ref/create_opclass.sgml
+++ b/doc/src/sgml/ref/create_opclass.sgml
@@ -1,5 +1,5 @@
@@ -204,21 +204,6 @@ CREATE OPERATOR CLASS name [ DEFAUL
clauses may appear in any order.
-
-
- Diagnostics
-
-
-
- CREATE OPERATOR CLASS
-
-
- Message returned if the operator class was successfully created.
-
-
-
-
- Examples
diff --git a/doc/src/sgml/ref/create_operator.sgml b/doc/src/sgml/ref/create_operator.sgml
index 67470102f7..d806bdd9d6 100644
--- a/doc/src/sgml/ref/create_operator.sgml
+++ b/doc/src/sgml/ref/create_operator.sgml
@@ -1,5 +1,5 @@
@@ -253,21 +253,6 @@ COMMUTATOR = OPERATOR(myschema.===) ,
-
-
- Diagnostics
-
-
-
- CREATE OPERATOR
-
-
- Message returned if the operator was successfully created.
-
-
-
-
- Notes
diff --git a/doc/src/sgml/ref/create_rule.sgml b/doc/src/sgml/ref/create_rule.sgml
index 2fccd22a10..996f549757 100644
--- a/doc/src/sgml/ref/create_rule.sgml
+++ b/doc/src/sgml/ref/create_rule.sgml
@@ -1,5 +1,5 @@
@@ -166,21 +166,6 @@ CREATE [ OR REPLACE ] RULE name AS
-
- Diagnostics
-
-
-
- CREATE RULE
-
-
- Message returned if the rule was successfully created.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/create_schema.sgml b/doc/src/sgml/ref/create_schema.sgml
index 3641587b9a..cf98557998 100644
--- a/doc/src/sgml/ref/create_schema.sgml
+++ b/doc/src/sgml/ref/create_schema.sgml
@@ -1,5 +1,5 @@
@@ -95,30 +95,6 @@ CREATE SCHEMA AUTHORIZATION username
-
- Diagnostics
-
-
-
- CREATE SCHEMA
-
-
- Message returned if the schema was successfully created.
-
-
-
-
-
- ERROR: namespace "schemaname" already exists
-
-
- Message returned if the schema specified already exists.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml
index 23cf859cd5..b558731137 100644
--- a/doc/src/sgml/ref/create_table.sgml
+++ b/doc/src/sgml/ref/create_table.sgml
@@ -1,5 +1,5 @@
@@ -564,23 +564,6 @@ and table_constraint is:
-
-
- Diagnostics
-
-
-
- CREATE TABLE
-
-
- Message returned if the table was successfully created.
-
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/create_table_as.sgml b/doc/src/sgml/ref/create_table_as.sgml
index ac05e2d42e..0d86492b75 100644
--- a/doc/src/sgml/ref/create_table_as.sgml
+++ b/doc/src/sgml/ref/create_table_as.sgml
@@ -1,5 +1,5 @@
@@ -101,18 +101,6 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE table_name
-
- Diagnostics
-
-
- Refer to , , and for a summary of possible output
- messages.
-
-
-
Notes
diff --git a/doc/src/sgml/ref/create_trigger.sgml b/doc/src/sgml/ref/create_trigger.sgml
index cf580b1ab9..af75dd9841 100644
--- a/doc/src/sgml/ref/create_trigger.sgml
+++ b/doc/src/sgml/ref/create_trigger.sgml
@@ -1,5 +1,5 @@
@@ -171,21 +171,6 @@ CREATE TRIGGER name { BEFORE | AFTE
-
- Diagnostics
-
-
-
- CREATE TRIGGER
-
-
- Message returned if the trigger was successfully created.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/create_type.sgml b/doc/src/sgml/ref/create_type.sgml
index 6e98d5e00f..f287c12b4b 100644
--- a/doc/src/sgml/ref/create_type.sgml
+++ b/doc/src/sgml/ref/create_type.sgml
@@ -1,5 +1,5 @@
@@ -408,21 +408,6 @@ CREATE TYPE typename (
-
- Diagnostics
-
-
-
- CREATE TYPE
-
-
- Message returned if the type was successfully created.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/create_user.sgml b/doc/src/sgml/ref/create_user.sgml
index f22b8854f0..ff294c63ea 100644
--- a/doc/src/sgml/ref/create_user.sgml
+++ b/doc/src/sgml/ref/create_user.sgml
@@ -1,5 +1,5 @@
@@ -167,21 +167,6 @@ where option can be:
-
- Diagnostics
-
-
-
- CREATE USER
-
-
- Message returned if the user account was successfully created.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/deallocate.sgml b/doc/src/sgml/ref/deallocate.sgml
index 11da825a72..887831d325 100644
--- a/doc/src/sgml/ref/deallocate.sgml
+++ b/doc/src/sgml/ref/deallocate.sgml
@@ -1,5 +1,5 @@
@@ -63,21 +63,6 @@ DEALLOCATE [ PREPARE ] plan_name
-
- Diagnostics
-
-
-
- DEALLOCATE
-
-
- Message returned if the prepared statement was deallocated successfully.
-
-
-
-
-
-
Compatibility
diff --git a/doc/src/sgml/ref/drop_aggregate.sgml b/doc/src/sgml/ref/drop_aggregate.sgml
index 0f19dd6a81..4ec2d9de1b 100644
--- a/doc/src/sgml/ref/drop_aggregate.sgml
+++ b/doc/src/sgml/ref/drop_aggregate.sgml
@@ -1,5 +1,5 @@
@@ -78,31 +78,6 @@ DROP AGGREGATE name (
-
- Diagnostics
-
-
-
- DROP AGGREGATE
-
-
- Message returned if the command was successful.
-
-
-
-
-
- ERROR: RemoveAggregate: aggregate 'name' for type type does not exist
-
-
- This message is returned if the specified aggregate function
- does not exist.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/drop_domain.sgml b/doc/src/sgml/ref/drop_domain.sgml
index b8627e5156..e108bfcbbc 100644
--- a/doc/src/sgml/ref/drop_domain.sgml
+++ b/doc/src/sgml/ref/drop_domain.sgml
@@ -1,5 +1,5 @@
@@ -68,30 +68,6 @@ DROP DOMAIN domainname [, ...] [ C
-
- Diagnostics
-
-
-
- DROP DOMAIN
-
-
- Message returned if the command was successful.
-
-
-
-
-
- ERROR: RemoveDomain: type 'domainname' does not exist
-
-
- This message occurs if the specified domain does not exist.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/drop_function.sgml b/doc/src/sgml/ref/drop_function.sgml
index 1a51b2b58c..ec68f162c2 100644
--- a/doc/src/sgml/ref/drop_function.sgml
+++ b/doc/src/sgml/ref/drop_function.sgml
@@ -1,5 +1,5 @@
@@ -80,30 +80,6 @@ DROP FUNCTION name ( [
-
- Diagnostics
-
-
-
- DROP FUNCTION
-
-
- Message returned if the command completes successfully.
-
-
-
-
-
- WARNING: RemoveFunction: Function name (types) does not exist
-
-
- This message is output if the function specified does not exist.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/drop_group.sgml b/doc/src/sgml/ref/drop_group.sgml
index ea35058681..2473ccf2c5 100644
--- a/doc/src/sgml/ref/drop_group.sgml
+++ b/doc/src/sgml/ref/drop_group.sgml
@@ -1,5 +1,5 @@
@@ -47,21 +47,6 @@ DROP GROUP name
-
-
- Diagnostics
-
-
-
- DROP GROUP
-
-
- Message returned if the group was successfully removed.
-
-
-
-
- Examples
diff --git a/doc/src/sgml/ref/drop_index.sgml b/doc/src/sgml/ref/drop_index.sgml
index 720d601e76..9f71d0cf07 100644
--- a/doc/src/sgml/ref/drop_index.sgml
+++ b/doc/src/sgml/ref/drop_index.sgml
@@ -1,5 +1,5 @@
@@ -68,32 +68,6 @@ DROP INDEX name [, ...] [ CASCADE |
-
- Diagnostics
-
-
-
- DROP INDEX
-
-
- Message returned if the command completes successfully.
-
-
-
-
-
- ERROR: index "name" does not exist
-
-
- This message is returned if name is not an existing
- index.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/drop_language.sgml b/doc/src/sgml/ref/drop_language.sgml
index 1be0bef48b..4a997ac715 100644
--- a/doc/src/sgml/ref/drop_language.sgml
+++ b/doc/src/sgml/ref/drop_language.sgml
@@ -1,5 +1,5 @@
@@ -69,32 +69,6 @@ DROP [ PROCEDURAL ] LANGUAGE name [
-
-
- Diagnostics
-
-
-
- DROP LANGUAGE
-
-
- This message is returned if the language was successfully dropped.
-
-
-
-
-
- ERROR: Language "name" doesn't exist
-
-
- This message is returned if a language called name is not found in the
- database.
-
-
-
-
- Examples
diff --git a/doc/src/sgml/ref/drop_opclass.sgml b/doc/src/sgml/ref/drop_opclass.sgml
index dcd72a3038..85f02cd473 100644
--- a/doc/src/sgml/ref/drop_opclass.sgml
+++ b/doc/src/sgml/ref/drop_opclass.sgml
@@ -1,5 +1,5 @@
@@ -76,21 +76,6 @@ DROP OPERATOR CLASS name USING
-
- Diagnostics
-
-
-
- DROP OPERATOR CLASS
-
-
- Message returned if the command was successful.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/drop_operator.sgml b/doc/src/sgml/ref/drop_operator.sgml
index 427e332b75..2b3267b336 100644
--- a/doc/src/sgml/ref/drop_operator.sgml
+++ b/doc/src/sgml/ref/drop_operator.sgml
@@ -1,5 +1,5 @@
@@ -88,50 +88,6 @@ DROP OPERATOR name (
-
- Diagnostics
-
-
-
- DROP OPERATOR
-
-
- Message returned if the command was successful.
-
-
-
-
-
- ERROR: RemoveOperator: binary operator 'name' taking 'lefttype' and 'righttype' does not exist
-
-
- This message is returned if the specified binary operator does not exist.
-
-
-
-
-
- ERROR: RemoveOperator: left unary operator 'name' taking 'lefttype' does not exist
-
-
- This message is returned if the specified left unary operator
- does not exist.
-
-
-
-
-
- ERROR: RemoveOperator: right unary operator 'name' taking 'righttype' does not exist
-
-
- This message is returned if the specified right unary operator
- does not exist.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/drop_rule.sgml b/doc/src/sgml/ref/drop_rule.sgml
index df34ddd54b..abd0bfc701 100644
--- a/doc/src/sgml/ref/drop_rule.sgml
+++ b/doc/src/sgml/ref/drop_rule.sgml
@@ -1,5 +1,5 @@
@@ -76,30 +76,6 @@ DROP RULE name ON
-
- Diagnostics
-
-
-
- DROP RULE
-
-
- Message returned if the command was successful.
-
-
-
-
-
- ERROR: Rule "name" not found
-
-
- Message if the specified rule does not exist.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/drop_schema.sgml b/doc/src/sgml/ref/drop_schema.sgml
index 77ccbbb8f3..5a52d3da3c 100644
--- a/doc/src/sgml/ref/drop_schema.sgml
+++ b/doc/src/sgml/ref/drop_schema.sgml
@@ -1,5 +1,5 @@
@@ -73,30 +73,6 @@ DROP SCHEMA name [, ...] [ CASCADE
-
- Diagnostics
-
-
-
- DROP SCHEMA
-
-
- Message returned if the schema was successfully dropped.
-
-
-
-
-
- ERROR: Schema "name" does not exist
-
-
- This message is returned if the specified schema does not exist.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/drop_sequence.sgml b/doc/src/sgml/ref/drop_sequence.sgml
index a23dd4ad16..cc2e1bed1f 100644
--- a/doc/src/sgml/ref/drop_sequence.sgml
+++ b/doc/src/sgml/ref/drop_sequence.sgml
@@ -1,5 +1,5 @@
@@ -66,30 +66,6 @@ DROP SEQUENCE name [, ...] [ CASCAD
-
- Diagnostics
-
-
-
- DROP SEQUENCE
-
-
- Message returned if the sequence was successfully dropped.
-
-
-
-
-
- ERROR: sequence "name" does not exist
-
-
- Message returned if the specified sequence does not exist.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/drop_table.sgml b/doc/src/sgml/ref/drop_table.sgml
index 61e253dc50..b37a428eb6 100644
--- a/doc/src/sgml/ref/drop_table.sgml
+++ b/doc/src/sgml/ref/drop_table.sgml
@@ -1,5 +1,5 @@
@@ -78,30 +78,6 @@ DROP TABLE name [, ...] [ CASCADE |
-
- Diagnostics
-
-
-
- DROP TABLE
-
-
- Message returned if the command completes successfully.
-
-
-
-
-
- ERROR: table "name" does not exist
-
-
- Message returned if the specified table does not exist.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/drop_trigger.sgml b/doc/src/sgml/ref/drop_trigger.sgml
index f4a24e9019..6505815fbe 100644
--- a/doc/src/sgml/ref/drop_trigger.sgml
+++ b/doc/src/sgml/ref/drop_trigger.sgml
@@ -1,5 +1,5 @@
@@ -78,30 +78,6 @@ DROP TRIGGER name ON
-
- Diagnostics
-
-
-
- DROP TRIGGER
-
-
- Message returned if the trigger was successfully dropped.
-
-
-
-
-
- ERROR: DropTrigger: there is no trigger name on relation "table"
-
-
- Message returned if the specified trigger does not exist.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/drop_type.sgml b/doc/src/sgml/ref/drop_type.sgml
index 18548fff14..c8aa06c73a 100644
--- a/doc/src/sgml/ref/drop_type.sgml
+++ b/doc/src/sgml/ref/drop_type.sgml
@@ -1,5 +1,5 @@
@@ -67,30 +67,6 @@ DROP TYPE typename [, ...] [ CASCAD
-
-
- Diagnostics
-
-
-
- DROP TYPE
-
-
- Message returned if the command was successful.
-
-
-
-
-
- ERROR: RemoveType: type 'typename' does not exist
-
-
- Message returned if the specified type does not exist.
-
-
-
-
- Examples
diff --git a/doc/src/sgml/ref/drop_view.sgml b/doc/src/sgml/ref/drop_view.sgml
index b17d2bccd8..4e03d10838 100644
--- a/doc/src/sgml/ref/drop_view.sgml
+++ b/doc/src/sgml/ref/drop_view.sgml
@@ -1,5 +1,5 @@
@@ -68,30 +68,6 @@ DROP VIEW name [, ...] [ CASCADE |
-
- Diagnostics
-
-
-
- DROP VIEW
-
-
- Message returned if the command was successful.
-
-
-
-
-
- ERROR: view name does not exist
-
-
- Message returned if the specified view does not exist.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/explain.sgml b/doc/src/sgml/ref/explain.sgml
index e4d9dd6e48..bb9016d69a 100644
--- a/doc/src/sgml/ref/explain.sgml
+++ b/doc/src/sgml/ref/explain.sgml
@@ -1,5 +1,5 @@
@@ -119,16 +119,6 @@ ROLLBACK;
-
- Diagnostics
-
-
- EXPLAIN prints the execution plan of the
- specified statement from the PostgreSQL
- planner.
-
-
-
Notes
diff --git a/doc/src/sgml/ref/fetch.sgml b/doc/src/sgml/ref/fetch.sgml
index d6622a4ea7..9c1050b835 100644
--- a/doc/src/sgml/ref/fetch.sgml
+++ b/doc/src/sgml/ref/fetch.sgml
@@ -1,5 +1,5 @@
@@ -280,21 +280,6 @@ where direction can be empty or one
-
- Diagnostics
-
-
-
- ERROR: cursor "cursor" does not exist
-
-
- There is no cursor with the specified name.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/lock.sgml b/doc/src/sgml/ref/lock.sgml
index 08cb017454..8c24cfb617 100644
--- a/doc/src/sgml/ref/lock.sgml
+++ b/doc/src/sgml/ref/lock.sgml
@@ -1,5 +1,5 @@
@@ -132,21 +132,6 @@ where lockmode is one of:
-
- Diagnostics
-
-
-
- LOCK TABLE
-
-
- Message returned if the lock was successfully acquired.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/notify.sgml b/doc/src/sgml/ref/notify.sgml
index 8d6edac63f..dde512d3e3 100644
--- a/doc/src/sgml/ref/notify.sgml
+++ b/doc/src/sgml/ref/notify.sgml
@@ -1,5 +1,5 @@
@@ -133,21 +133,6 @@ NOTIFY name
-
- Diagnostics
-
-
-
- NOTIFY
-
-
- Message returned when the commmand has executed.
-
-
-
-
-
-
Examples
diff --git a/doc/src/sgml/ref/prepare.sgml b/doc/src/sgml/ref/prepare.sgml
index b2a0c040f6..7777cdee8a 100644
--- a/doc/src/sgml/ref/prepare.sgml
+++ b/doc/src/sgml/ref/prepare.sgml
@@ -1,5 +1,5 @@
@@ -112,21 +112,6 @@ PREPARE plan_name [ (
-
- Diagnostics
-
-
-
- PREPARE
-
-
- Message returned if the statement has been prepared successfully.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/reindex.sgml b/doc/src/sgml/ref/reindex.sgml
index 8258b460f1..b919f2c53c 100644
--- a/doc/src/sgml/ref/reindex.sgml
+++ b/doc/src/sgml/ref/reindex.sgml
@@ -1,5 +1,5 @@
@@ -150,21 +150,6 @@ REINDEX { DATABASE | TABLE | INDEX } name
-
-
- Diagnostics
-
-
-
- REINDEX
-
-
- Message returned if the indexes were successfully recreated.
-
-
-
-
- Examples
diff --git a/doc/src/sgml/ref/reset.sgml b/doc/src/sgml/ref/reset.sgml
index 48d75ad9af..58169d17de 100644
--- a/doc/src/sgml/ref/reset.sgml
+++ b/doc/src/sgml/ref/reset.sgml
@@ -1,5 +1,5 @@
@@ -81,14 +81,6 @@ SET parameter TO DEFAULT
-
- Diagnostics
-
-
- See under the .
-
-
-
Examples
diff --git a/doc/src/sgml/ref/rollback.sgml b/doc/src/sgml/ref/rollback.sgml
index 33c6c3f74a..cac7a5cc5e 100644
--- a/doc/src/sgml/ref/rollback.sgml
+++ b/doc/src/sgml/ref/rollback.sgml
@@ -1,5 +1,5 @@
@@ -49,30 +49,6 @@ ROLLBACK [ WORK | TRANSACTION ]
-
- Diagnostics
-
-
-
- ROLLBACK
-
-
- Message returned if successful.
-
-
-
-
-
- WARNING: ROLLBACK: no transaction in progress
-
-
- If there is not any transaction currently in progress.
-
-
-
-
-
-
Notes
@@ -80,6 +56,11 @@ ROLLBACK [ WORK | TRANSACTION ]
Use to
successfully terminate a transaction.
+
+
+ Issuing ROLLBACK when not inside a transaction does
+ no harm, but it will provoke a warning message.
+
@@ -102,6 +83,15 @@ ROLLBACK;
WORK. Otherwise, this command is fully conforming.
+
+
+ See Also
+
+
+
+
+
+
@@ -78,18 +78,6 @@ SELECT [ ALL | DISTINCT [ ON ( expression
-
- Diagnostics
-
-
- Refer to
-
- and
-
- for a summary of possible output messages.
-
-
-
Notes
diff --git a/doc/src/sgml/ref/set_transaction.sgml b/doc/src/sgml/ref/set_transaction.sgml
index 9149d557dc..12ebb2f61c 100644
--- a/doc/src/sgml/ref/set_transaction.sgml
+++ b/doc/src/sgml/ref/set_transaction.sgml
@@ -1,4 +1,4 @@
-
+
SET TRANSACTION
@@ -120,10 +120,10 @@ SET default_transaction_isolation = 'value'
Compatibility
- Both commands are defined in the SQL standard.
+ Both commands are defined in the SQL standard.
SERIALIZABLE is the default transaction
- isolation level in SQL; in PostgreSQL it is
- READ COMMITED, but you can change it as
+ isolation level in the standard; in PostgreSQL the default is
+ ordinarily READ COMMITTED, but you can change it as
described above. PostgreSQL does not
provide the isolation levels READ UNCOMMITTED
and REPEATABLE READ. Because of multiversion
diff --git a/doc/src/sgml/ref/show.sgml b/doc/src/sgml/ref/show.sgml
index bbdecc76e2..3acaead1eb 100644
--- a/doc/src/sgml/ref/show.sgml
+++ b/doc/src/sgml/ref/show.sgml
@@ -1,5 +1,5 @@
@@ -127,22 +127,6 @@ SHOW ALL
-
- Diagnostics
-
-
-
- ERROR: Option 'name' is not recognized
-
-
- Message returned if name does not
- stand for a known parameter.
-
-
-
-
-
-
Notes
diff --git a/doc/src/sgml/ref/start_transaction.sgml b/doc/src/sgml/ref/start_transaction.sgml
index 26963e8048..60089d71ee 100644
--- a/doc/src/sgml/ref/start_transaction.sgml
+++ b/doc/src/sgml/ref/start_transaction.sgml
@@ -1,5 +1,5 @@
@@ -47,31 +47,6 @@ START TRANSACTION [ ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE } ] [ READ W
-
- Diagnostics
-
-
-
- START TRANSACTION
-
-
- Message returned if successful.
-
-
-
-
-
- WARNING: BEGIN: already a transaction in progress
-
-
- Message returned if there was already a transaction in progress
- when the command was issued.
-
-
-
-
-
-
Compatibility
@@ -81,6 +56,17 @@ START TRANSACTION [ ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE } ] [ READ W
endterm="sql-set-transaction-title">.
+
+
+ See Also
+
+
+
+
+
+
+
+
@@ -49,21 +49,6 @@ TRUNCATE [ TABLE ] name
-
-
- Diagnostics
-
-
-
- TRUNCATE TABLE
-
-
- Message returned if the table was successfully truncated.
-
-
-
-
- Examples
diff --git a/doc/src/sgml/ref/unlisten.sgml b/doc/src/sgml/ref/unlisten.sgml
index 385f6db2e3..175bcf045c 100644
--- a/doc/src/sgml/ref/unlisten.sgml
+++ b/doc/src/sgml/ref/unlisten.sgml
@@ -1,5 +1,5 @@
@@ -70,30 +70,16 @@ UNLISTEN { name | * }
-
- Diagnostics
-
-
-
- UNLISTEN
-
-
- Message returned when the command has executed.
-
-
-
-
-
-
Notes
- You unlisten something you were not listening for; no warning or error will appear.
+ You may unlisten something you were not listening for; no warning or error
+ will appear.
- At the end of each session, UNLISTEN * ist
+ At the end of each session, UNLISTEN * is
automatically executed.