From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Sat, 27 Nov 2010 07:42:22 +0000 (-0500)
Subject: A bit more wordsmithing on the PQping documentation.
X-Git-Url: http://git.postgresql.org/gitweb/-?a=commitdiff_plain;h=d53c1255d9730b07d56166ace1191250ca76f496;p=users%2Fhanada%2Fpostgres.git

A bit more wordsmithing on the PQping documentation.
---

diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index 18199b06ce..c253c7c61c 100644
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -1100,7 +1100,11 @@ PGPing PQpingParams(const char **keywords, const char **values, int expand_dbnam
          <term><literal>PQPING_NO_RESPONSE</literal></term>
          <listitem>
           <para>
-           The server could not be contacted.
+           The server could not be contacted.  This might indicate that the
+           server is not running, or that there is something wrong with the
+           given connection parameters (for example, wrong port number), or
+           that there is a network connectivity problem (for example, a
+           firewall blocking the connection request).
           </para>
          </listitem>
         </varlistentry>
@@ -1110,8 +1114,8 @@ PGPing PQpingParams(const char **keywords, const char **values, int expand_dbnam
          <listitem>
           <para>
            No attempt was made to contact the server, because the supplied
-           parameters were incorrect or there was some client-side problem
-           (for example, out of memory).
+           parameters were obviously incorrect or there was some client-side
+           problem (for example, out of memory).
           </para>
          </listitem>
         </varlistentry>