A bit more wordsmithing on the PQping documentation.

tglsfdc · tglsfdc · commit d53c1255d973 · 2010-11-27T02:42:22.000-05:00
diff --git 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>
