More libpq documentation adjustments from Leslie S Satenstein, reviewed

by Robert Haas.
This commit is contained in:
Bruce Momjian 2011-01-13 12:07:51 -05:00
parent a5a02a7445
commit 712dd95370
1 changed files with 7 additions and 15 deletions

View File

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