More libpq documentation adjustments from Leslie S Satenstein, reviewed

by Robert Haas.

diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index 58e593d2abd5b01c2a0ddb55415db5fb4bcbb2dd..fe661b8c52ae8fecb9704ceeb0e08a2aeb3a03aa 100644 (file)
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -972,8 +972,8 @@ PQconninfoOption *PQconninfoParse(const char *conninfo, char **errmsg);
        If errmsg is not NULL, then *errmsg is set
        to NULL on success, else to a malloc'd error string explaining
        the problem.  (It is also possible for *errmsg to be
-       set to NULL even when NULL is returned; this indicates an out-of-memory
-       situation.)
+       set to NULL and the function to return NULL;
+       this indicates an out-of-memory condition.)
       
 
       
@@ -1352,7 +1352,7 @@ ConnStatusType PQstatus(const PGconn *conn);
       
        See the entry for PQconnectStartParams, PQconnectStart
        and PQconnectPoll with regards to other status codes that
-       might be seen.
+       might be returned.
       
      
     
@@ -3163,23 +3163,15 @@ Oid PQoidValue(const PGresult *res);
 
      
       
-       Returns a string with the OID of the inserted row, if the
-       SQL command was an INSERT
-       that inserted exactly one row, or a EXECUTE of
-       a prepared statement consisting of a suitable
-       INSERT.  (The string will be 0 if
-       the INSERT did not insert exactly one row, or
-       if the target table does not have OIDs.)  If the command was not
-       an INSERT, returns an empty string.
+       This function is deprecated in favor of
+       PQoidValue and is not thread-safe.
+       It returns a string with the OID of the inserted row, while
+       PQoidValue returns the OID value.
 
 char *PQoidStatus(const PGresult *res);
 
       
 
-      
-       This function is deprecated in favor of
-       PQoidValue.  It is not thread-safe.
-