Mop-up for error-message updates in documentation.

diff --git a/doc/src/sgml/ref/analyze.sgml b/doc/src/sgml/ref/analyze.sgml
index 1aa0346d354e2379ac5ab986fd517c4f1363aa3d..ab9242e27c6ecdefca37986b46c2037366fbea75 100644 (file)
--- a/doc/src/sgml/ref/analyze.sgml
+++ b/doc/src/sgml/ref/analyze.sgml
@@ -77,6 +77,16 @@ ANALYZE [ VERBOSE ] [ <replaceable class="PARAMETER">table</replaceable> [ (<rep
   </variablelist>
  </refsect1>
 
+ <refsect1>
+  <title>Outputs</title>
+
+   <para>
+    When <literal>VERBOSE</> is specified, <command>ANALYZE</> emits
+    progress messages to indicate which table is currently being
+    processed.  Various statistics about the tables are printed as well.
+   </para>
+ </refsect1>
+
  <refsect1>
   <title>Notes</title>
 

diff --git a/doc/src/sgml/ref/clusterdb.sgml b/doc/src/sgml/ref/clusterdb.sgml
index cac111cc2f90d67bf91654a7110f33d727906cdc..dc552f8fdb6a5a02146da664366ee69eec12c29d 100644 (file)
--- a/doc/src/sgml/ref/clusterdb.sgml
+++ b/doc/src/sgml/ref/clusterdb.sgml
@@ -51,16 +51,6 @@ PostgreSQL documentation
    this utility and via other methods for accessing the server.
   </para>
 
-  <para>
-   In case of difficulty, see <xref linkend="SQL-CLUSTER"
-   endterm="sql-cluster-title"> and <xref linkend="APP-PSQL"> 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 <application>libpq</application> front-end
-   library will apply.
-  </para>
-
  </refsect1>
 
 
@@ -203,6 +193,22 @@ PostgreSQL documentation
  </refsect1>
 
 
+ <refsect1>
+  <title>Diagnostics</title>
+
+  <para>
+   In case of difficulty, see <xref linkend="SQL-CLUSTER"
+   endterm="sql-cluster-title"> and <xref linkend="APP-PSQL"> 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 <application>libpq</application> front-end
+   library will apply.
+  </para>
+
+ </refsect1>
+
+
  <refsect1>
   <title>Examples</title>
 

diff --git a/doc/src/sgml/ref/create_language.sgml b/doc/src/sgml/ref/create_language.sgml
index 531e1072ae1ff8618c82601145db87a4c000b21e..c6a146cf00deb70c04af46ecdbeacf2087fad05f 100644 (file)
--- a/doc/src/sgml/ref/create_language.sgml
+++ b/doc/src/sgml/ref/create_language.sgml
@@ -139,7 +139,7 @@ CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE <replaceable class="parameter">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 <function>elog()</function>
+       validator function should use the <function>ereport()</function>
        function.  The return value of the function is ignored.
       </para>
      </listitem>

diff --git a/doc/src/sgml/ref/createdb.sgml b/doc/src/sgml/ref/createdb.sgml
index 4f5b550e96688fc6aa87a8a033aec1bc2d9b7f4e..0b99c6ec7f85d1bc646ea5190cf7300f00cfc34e 100644 (file)
--- a/doc/src/sgml/ref/createdb.sgml
+++ b/doc/src/sgml/ref/createdb.sgml
@@ -53,16 +53,6 @@ PostgreSQL documentation
    this utility and via other methods for accessing the server.
   </para>
 
-  <para>
-   In case of difficulty, see <xref linkend="SQL-CREATEDATABASE"
-   endterm="sql-createdatabase-title"> and <xref linkend="APP-PSQL"> 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 <application>libpq</application> front-end
-   library will apply.
-  </para>
-
  </refsect1>
 
 
@@ -252,7 +242,23 @@ PostgreSQL documentation
  </refsect1>
 
 
- <refsect1 id="R1-APP-CREATEDB-2">
+ <refsect1>
+  <title>Diagnostics</title>
+
+  <para>
+   In case of difficulty, see <xref linkend="SQL-CREATEDATABASE"
+   endterm="sql-createdatabase-title"> and <xref linkend="APP-PSQL"> 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 <application>libpq</application> front-end
+   library will apply.
+  </para>
+
+ </refsect1>
+
+
+ <refsect1>
   <title>Examples</title>
 
    <para>

diff --git a/doc/src/sgml/ref/createuser.sgml b/doc/src/sgml/ref/createuser.sgml
index b53d882c925a2cc9c054e9e99669a8a70c7707c3..3d29ddbf04df5de8d343b7ba17d2aa49d79971d5 100644 (file)
--- a/doc/src/sgml/ref/createuser.sgml
+++ b/doc/src/sgml/ref/createuser.sgml
@@ -54,16 +54,6 @@ PostgreSQL documentation
    this utility and via other methods for accessing the server.
   </para>
 
-  <para>
-   In case of difficulty, see <xref linkend="SQL-CREATEUSER"
-   endterm="sql-createuser-title"> and <xref linkend="APP-PSQL"> 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 <application>libpq</application> front-end
-   library will apply.
-  </para>
-
  </refsect1>
 
 
@@ -276,6 +266,22 @@ PostgreSQL documentation
  </refsect1>
 
 
+ <refsect1>
+  <title>Diagnostics</title>
+
+  <para>
+   In case of difficulty, see <xref linkend="SQL-CREATEUSER"
+   endterm="sql-createuser-title"> and <xref linkend="APP-PSQL"> 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 <application>libpq</application> front-end
+   library will apply.
+  </para>
+
+ </refsect1>
+
+
  <refsect1>
   <title>Examples</title>
 

diff --git a/doc/src/sgml/ref/dropdb.sgml b/doc/src/sgml/ref/dropdb.sgml
index 6b1bfd06b9065d18a68a20a9a004aff63bfcc7db..92df6b1daad11250d6c2bdc1ffa22945a90815e5 100644 (file)
--- a/doc/src/sgml/ref/dropdb.sgml
+++ b/doc/src/sgml/ref/dropdb.sgml
@@ -46,16 +46,6 @@ PostgreSQL documentation
    this utility and via other methods for accessing the server.
   </para>
 
-  <para>
-   In case of difficulty, see <xref linkend="SQL-DROPDATABASE"
-   endterm="sql-dropdatabase-title"> and <xref linkend="APP-PSQL"> 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 <application>libpq</application> front-end
-   library will apply.
-  </para>
-
  </refsect1>
 
 
@@ -181,7 +171,23 @@ PostgreSQL documentation
  </refsect1>
 
 
- <refsect1 id="R1-APP-DROPDB-2">
+ <refsect1>
+  <title>Diagnostics</title>
+
+  <para>
+   In case of difficulty, see <xref linkend="SQL-DROPDATABASE"
+   endterm="sql-dropdatabase-title"> and <xref linkend="APP-PSQL"> 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 <application>libpq</application> front-end
+   library will apply.
+  </para>
+
+ </refsect1>
+
+
+ <refsect1>
   <title>Examples</title>
 
    <para>

diff --git a/doc/src/sgml/ref/dropuser.sgml b/doc/src/sgml/ref/dropuser.sgml
index 85e2c362c250b6ebc41523acd0863c9ed2cee7aa..ed46730f897547daaea69c51caef946e281e9bf5 100644 (file)
--- a/doc/src/sgml/ref/dropuser.sgml
+++ b/doc/src/sgml/ref/dropuser.sgml
@@ -48,16 +48,6 @@ PostgreSQL documentation
    this utility and via other methods for accessing the server.
   </para>
 
-  <para>
-   In case of difficulty, see <xref linkend="SQL-DROPUSER"
-   endterm="sql-dropuser-title"> and <xref linkend="APP-PSQL"> 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 <application>libpq</application> front-end
-   library will apply.
-  </para>
-
  </refsect1>
 
 
@@ -185,6 +175,22 @@ PostgreSQL documentation
  </refsect1>
 
 
+ <refsect1>
+  <title>Diagnostics</title>
+
+  <para>
+   In case of difficulty, see <xref linkend="SQL-DROPUSER"
+   endterm="sql-dropuser-title"> and <xref linkend="APP-PSQL"> 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 <application>libpq</application> front-end
+   library will apply.
+  </para>
+
+ </refsect1>
+
+
  <refsect1>
   <title>Examples</title>
 

diff --git a/doc/src/sgml/ref/listen.sgml b/doc/src/sgml/ref/listen.sgml
index 6d3898ffba9ca2866300fa6578cc2feb33211163..0158ac6bbc07b65fdef075f2ac7cf045a477ae9a 100644 (file)
--- a/doc/src/sgml/ref/listen.sgml
+++ b/doc/src/sgml/ref/listen.sgml
@@ -92,7 +92,9 @@ LISTEN <replaceable class="PARAMETER">name</replaceable>
   <title>Examples</title>
 
   <para>
-   Configure and execute a listen/notify sequence from <application>psql</application>:
+   Configure and execute a listen/notify sequence from
+   <application>psql</application>:
+
 <programlisting>
 LISTEN virtual;
 NOTIFY virtual;

diff --git a/doc/src/sgml/ref/notify.sgml b/doc/src/sgml/ref/notify.sgml
index 51027a46fac640e960adce07eab83c0bdad90a5f..aeaeeac110f21fd86e81e80f93913cfdd2e14fd7 100644 (file)
--- a/doc/src/sgml/ref/notify.sgml
+++ b/doc/src/sgml/ref/notify.sgml
@@ -143,7 +143,7 @@ NOTIFY <replaceable class="PARAMETER">name</replaceable>
 <programlisting>
 LISTEN virtual;
 NOTIFY virtual;
-Asynchronous NOTIFY 'virtual' from backend with pid '8448' received. 
+Asynchronous notification "virtual" received from server process with PID 8448.
 </programlisting>
   </para>
  </refsect1>

diff --git a/doc/src/sgml/ref/unlisten.sgml b/doc/src/sgml/ref/unlisten.sgml
index c205320b7160789461c2c3fd8a4c5c6ec89bfbe8..ff67142d42e6ecb8a05ffe4000ddaaf7afda0130 100644 (file)
--- a/doc/src/sgml/ref/unlisten.sgml
+++ b/doc/src/sgml/ref/unlisten.sgml
@@ -93,13 +93,13 @@ UNLISTEN { <replaceable class="PARAMETER">name</replaceable> | * }
 <programlisting>
 LISTEN virtual;
 NOTIFY virtual;
-Asynchronous NOTIFY 'virtual' from backend with pid '8448' received
+Asynchronous notification "virtual" received from server process with PID 8448.
 </programlisting>
   </para>
 
   <para>
-   Once <command>UNLISTEN</> has been executed, further <command>NOTIFY</> commands will be
-   ignored:
+   Once <command>UNLISTEN</> has been executed, further <command>NOTIFY</>
+   commands will be ignored:
 
 <programlisting>
 UNLISTEN virtual;

diff --git a/doc/src/sgml/ref/vacuumdb.sgml b/doc/src/sgml/ref/vacuumdb.sgml
index 8bd30fcd5d3c791f2c1aba0fd3120118f2545efd..f826109311c6dd0975d5ca1448e10a5d5fce5e91 100644 (file)
--- a/doc/src/sgml/ref/vacuumdb.sgml
+++ b/doc/src/sgml/ref/vacuumdb.sgml
@@ -58,24 +58,6 @@ PostgreSQL documentation
    this utility and via other methods for accessing the server.
   </para>
 
-  <para>
-   In case of difficulty, see <xref linkend="SQL-VACUUM"
-   endterm="sql-vacuum-title"> and <xref linkend="APP-PSQL"> 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 <application>libpq</application> front-end
-   library will apply.
-  </para>
-
-  <para>
-   <application>vacuumdb</application> might need to connect several
-   times to the <productname>PostgreSQL</productname> server, asking
-   for a password each time. It is convenient to have a
-   <filename>$HOME/.pgpass</> file in such cases. See <xref
-   linkend="libpq-pgpass"> for more information.
-  </para>
-
  </refsect1>
 
 
@@ -256,6 +238,34 @@ PostgreSQL documentation
  </refsect1>
 
 
+ <refsect1>
+  <title>Diagnostics</title>
+
+  <para>
+   In case of difficulty, see <xref linkend="SQL-VACUUM"
+   endterm="sql-vacuum-title"> and <xref linkend="APP-PSQL"> 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 <application>libpq</application> front-end
+   library will apply.
+  </para>
+
+ </refsect1>
+
+
+ <refsect1>
+  <title>Notes</title>
+
+  <para>
+   <application>vacuumdb</application> might need to connect several
+   times to the <productname>PostgreSQL</productname> server, asking
+   for a password each time. It is convenient to have a
+   <filename>$HOME/.pgpass</> file in such cases. See <xref
+   linkend="libpq-pgpass"> for more information.
+  </para>
+ </refsect1>
+
  <refsect1>
   <title>Examples</title>