diff --git a/doc/src/sgml/ref/analyze.sgml b/doc/src/sgml/ref/analyze.sgml
index cf472d4a0ef..0010efa106b 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 7be6d0959da..7c9f524fac7 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 45834255bb8..1629ba77e47 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 1c7e0ec4af8..a70e9630398 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 484f7fbe11f..15459db9ce8 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 e1c28fe2931..6a6733abc2c 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 5c26050db96..dab715313bb 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 8029b5ed036..75861fa6115 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 dde512d3e3d..b16265956ee 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 175bcf045c1..0444d8f7c1c 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 63d7b4d3ee4..ea669913f02 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