diff --git a/doc/src/sgml/ref/analyze.sgml b/doc/src/sgml/ref/analyze.sgml
index cf472d4a0ef089860753894f71764c602ac60135..0010efa106bc2bbf93ac4096ccaf9cdd0cfc8d70 100644
--- a/doc/src/sgml/ref/analyze.sgml
+++ b/doc/src/sgml/ref/analyze.sgml
@@ -1,5 +1,5 @@
@@ -77,6 +77,16 @@ ANALYZE [ VERBOSE ] [ table [ (
+
+ Outputs
+
+
+ When VERBOSE is specified, ANALYZE emits
+ progress messages to indicate which table is currently being
+ processed. Various statistics about the tables are printed as well.
+
+
+
Notes
diff --git a/doc/src/sgml/ref/clusterdb.sgml b/doc/src/sgml/ref/clusterdb.sgml
index 7be6d0959dab2be7f60e90d0dab3ff6df4c01178..7c9f524fac775d0e4ee1f0fd25cdbc68ca85e76b 100644
--- a/doc/src/sgml/ref/clusterdb.sgml
+++ b/doc/src/sgml/ref/clusterdb.sgml
@@ -1,5 +1,5 @@
@@ -51,16 +51,6 @@ PostgreSQL documentation
this utility and via other methods for accessing the server.
-
- In case of difficulty, see and for
- discussions of potential problems and error messages.
- The database server must be running at the
- targeted host. Also, any default connection settings and environment
- variables used by the libpq front-end
- library will apply.
-
-
@@ -203,6 +193,22 @@ PostgreSQL documentation
+
+ Diagnostics
+
+
+ In case of difficulty, see and for
+ discussions of potential problems and error messages.
+ The database server must be running at the
+ targeted host. Also, any default connection settings and environment
+ variables used by the libpq front-end
+ library will apply.
+
+
+
+
+
Examples
diff --git a/doc/src/sgml/ref/create_language.sgml b/doc/src/sgml/ref/create_language.sgml
index 45834255bb8fb57babec0df00d0598a45e6d3b55..1629ba77e4763c8169923bc997a270e660a5de55 100644
--- a/doc/src/sgml/ref/create_language.sgml
+++ b/doc/src/sgml/ref/create_language.sgml
@@ -1,5 +1,5 @@
@@ -139,7 +139,7 @@ CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE langna
for syntactical correctness, but it can also look at other
properties of the function, for example if the language cannot
handle certain argument types. To signal an error, the
- validator function should use the elog()
+ validator function should use the ereport()
function. The return value of the function is ignored.
diff --git a/doc/src/sgml/ref/createdb.sgml b/doc/src/sgml/ref/createdb.sgml
index 1c7e0ec4af8212c1f5e2f558706b20b3554fe485..a70e9630398271424c24b90eccdbda1069b0b2c3 100644
--- a/doc/src/sgml/ref/createdb.sgml
+++ b/doc/src/sgml/ref/createdb.sgml
@@ -1,5 +1,5 @@
@@ -53,16 +53,6 @@ PostgreSQL documentation
this utility and via other methods for accessing the server.
-
- In case of difficulty, see and for
- discussions of potential problems and error messages.
- The database server must be running at the
- targeted host. Also, any default connection settings and environment
- variables used by the libpq front-end
- library will apply.
-
-
@@ -252,7 +242,23 @@ PostgreSQL documentation
-
+
+ Diagnostics
+
+
+ In case of difficulty, see and for
+ discussions of potential problems and error messages.
+ The database server must be running at the
+ targeted host. Also, any default connection settings and environment
+ variables used by the libpq front-end
+ library will apply.
+
+
+
+
+
+
Examples
diff --git a/doc/src/sgml/ref/createuser.sgml b/doc/src/sgml/ref/createuser.sgml
index 484f7fbe11f70e0cb4f658a3896b3cb412a5b2ee..15459db9ce84b35005bb2cf88dccdf942bc1eb09 100644
--- a/doc/src/sgml/ref/createuser.sgml
+++ b/doc/src/sgml/ref/createuser.sgml
@@ -1,5 +1,5 @@
@@ -54,16 +54,6 @@ PostgreSQL documentation
this utility and via other methods for accessing the server.
-
- In case of difficulty, see and for
- discussions of potential problems and error messages.
- The database server must be running at the
- targeted host. Also, any default connection settings and environment
- variables used by the libpq front-end
- library will apply.
-
-
@@ -276,6 +266,22 @@ PostgreSQL documentation
+
+ Diagnostics
+
+
+ In case of difficulty, see and for
+ discussions of potential problems and error messages.
+ The database server must be running at the
+ targeted host. Also, any default connection settings and environment
+ variables used by the libpq front-end
+ library will apply.
+
+
+
+
+
Examples
diff --git a/doc/src/sgml/ref/dropdb.sgml b/doc/src/sgml/ref/dropdb.sgml
index e1c28fe29313a90e32ea93d4550b4d1402f64de4..6a6733abc2cebb3dd195d7ff975485dfd7cd176e 100644
--- a/doc/src/sgml/ref/dropdb.sgml
+++ b/doc/src/sgml/ref/dropdb.sgml
@@ -1,5 +1,5 @@
@@ -46,16 +46,6 @@ PostgreSQL documentation
this utility and via other methods for accessing the server.
-
- In case of difficulty, see and for
- discussions of potential problems and error messages.
- The database server must be running at the
- targeted host. Also, any default connection settings and environment
- variables used by the libpq front-end
- library will apply.
-
-
@@ -181,7 +171,23 @@ PostgreSQL documentation
-
+
+ Diagnostics
+
+
+ In case of difficulty, see and for
+ discussions of potential problems and error messages.
+ The database server must be running at the
+ targeted host. Also, any default connection settings and environment
+ variables used by the libpq front-end
+ library will apply.
+
+
+
+
+
+
Examples
diff --git a/doc/src/sgml/ref/dropuser.sgml b/doc/src/sgml/ref/dropuser.sgml
index 5c26050db96d094763df9cff96d0cd08ffbcc245..dab715313bb59f7fb3ee59711abc8987f4115943 100644
--- a/doc/src/sgml/ref/dropuser.sgml
+++ b/doc/src/sgml/ref/dropuser.sgml
@@ -1,5 +1,5 @@
@@ -48,16 +48,6 @@ PostgreSQL documentation
this utility and via other methods for accessing the server.
-
- In case of difficulty, see and for
- discussions of potential problems and error messages.
- The database server must be running at the
- targeted host. Also, any default connection settings and environment
- variables used by the libpq front-end
- library will apply.
-
-
@@ -185,6 +175,22 @@ PostgreSQL documentation
+
+ Diagnostics
+
+
+ In case of difficulty, see and for
+ discussions of potential problems and error messages.
+ The database server must be running at the
+ targeted host. Also, any default connection settings and environment
+ variables used by the libpq front-end
+ library will apply.
+
+
+
+
+
Examples
diff --git a/doc/src/sgml/ref/listen.sgml b/doc/src/sgml/ref/listen.sgml
index 8029b5ed036afde73ede82022ca016fda50c0956..75861fa6115e29aefa15e9b27cadd7649082a8e7 100644
--- a/doc/src/sgml/ref/listen.sgml
+++ b/doc/src/sgml/ref/listen.sgml
@@ -1,5 +1,5 @@
@@ -92,7 +92,9 @@ LISTEN name
Examples
- Configure and execute a listen/notify sequence from psql:
+ Configure and execute a listen/notify sequence from
+ psql:
+
LISTEN virtual;
NOTIFY virtual;
diff --git a/doc/src/sgml/ref/notify.sgml b/doc/src/sgml/ref/notify.sgml
index dde512d3e3d8adfea31fb0f79afc812a7a6867f3..b16265956eefae80db71a4f3e1e8088c014f44c3 100644
--- a/doc/src/sgml/ref/notify.sgml
+++ b/doc/src/sgml/ref/notify.sgml
@@ -1,5 +1,5 @@
@@ -143,7 +143,7 @@ NOTIFY name
LISTEN virtual;
NOTIFY virtual;
-Asynchronous NOTIFY 'virtual' from backend with pid '8448' received.
+Asynchronous notification "virtual" received from server process with PID 8448.
diff --git a/doc/src/sgml/ref/unlisten.sgml b/doc/src/sgml/ref/unlisten.sgml
index 175bcf045c1725a4c0e461f9f4c986225da745b7..0444d8f7c1c0a49cea4bca7c16d42531a8fff2d8 100644
--- a/doc/src/sgml/ref/unlisten.sgml
+++ b/doc/src/sgml/ref/unlisten.sgml
@@ -1,5 +1,5 @@
@@ -93,13 +93,13 @@ UNLISTEN { name | * }
LISTEN virtual;
NOTIFY virtual;
-Asynchronous NOTIFY 'virtual' from backend with pid '8448' received
+Asynchronous notification "virtual" received from server process with PID 8448.
- Once UNLISTEN has been executed, further NOTIFY commands will be
- ignored:
+ Once UNLISTEN has been executed, further NOTIFY
+ commands will be ignored:
UNLISTEN virtual;
diff --git a/doc/src/sgml/ref/vacuumdb.sgml b/doc/src/sgml/ref/vacuumdb.sgml
index 63d7b4d3ee49ec2e5bb5ff5ddb70fed7e4debcb4..ea669913f02d630b2f1d06d8660e2f9ba85371f4 100644
--- a/doc/src/sgml/ref/vacuumdb.sgml
+++ b/doc/src/sgml/ref/vacuumdb.sgml
@@ -1,5 +1,5 @@
@@ -58,24 +58,6 @@ PostgreSQL documentation
this utility and via other methods for accessing the server.
-
- In case of difficulty, see and for
- discussions of potential problems and error messages.
- The database server must be running at the
- targeted host. Also, any default connection settings and environment
- variables used by the libpq front-end
- library will apply.
-
-
-
- vacuumdb might need to connect several
- times to the PostgreSQL server, asking
- for a password each time. It is convenient to have a
- $HOME/.pgpass file in such cases. See for more information.
-
-
@@ -256,6 +238,34 @@ PostgreSQL documentation
+
+ Diagnostics
+
+
+ In case of difficulty, see and for
+ discussions of potential problems and error messages.
+ The database server must be running at the
+ targeted host. Also, any default connection settings and environment
+ variables used by the libpq front-end
+ library will apply.
+
+
+
+
+
+
+ Notes
+
+
+ vacuumdb might need to connect several
+ times to the PostgreSQL server, asking
+ for a password each time. It is convenient to have a
+ $HOME/.pgpass file in such cases. See for more information.
+
+
+
Examples