diff --git a/doc/src/sgml/ref/analyze.sgml b/doc/src/sgml/ref/analyze.sgml
index cf472d4a0e..0010efa106 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 7be6d0959d..7c9f524fac 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 45834255bb..1629ba77e4 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 1c7e0ec4af..a70e963039 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 484f7fbe11..15459db9ce 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 e1c28fe293..6a6733abc2 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 5c26050db9..dab715313b 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 8029b5ed03..75861fa611 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 dde512d3e3..b16265956e 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 175bcf045c..0444d8f7c1 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 63d7b4d3ee..ea669913f0 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