Index: doc/src/sgml/libpq.sgml
===================================================================
RCS file: /usr/local/cvsroot/pgsql-server/doc/src/sgml/libpq.sgml,v
retrieving revision 1.145
diff -2 -c -r1.145 libpq.sgml
*** doc/src/sgml/libpq.sgml 9 Jan 2004 02:02:43 -0000 1.145
--- doc/src/sgml/libpq.sgml 26 Jan 2004 05:15:18 -0000
***************
*** 913,917 ****
Note that by libpq convention, a nonempty
PQerrorMessage result will
! include a trailing newline.
--- 913,920 ----
Note that by libpq convention, a nonempty
PQerrorMessage result will
! include a trailing newline. The caller should not free the result
! directly. It will be freed when the associated PGconn>
! handle is passed to PQfinish.
!
***************
*** 1263,1267 ****
Converts the enumerated type returned by PQresultStatus> into
! a string constant describing the status code.
char *PQresStatus(ExecStatusType status);
--- 1266,1271 ----
Converts the enumerated type returned by PQresultStatus> into
! a string constant describing the status code. The caller should not
! free the result.
char *PQresStatus(ExecStatusType status);
***************
*** 1280,1284 ****
char *PQresultErrorMessage(const PGresult *res);
! If there was an error, the returned string will include a trailing newline.
--- 1284,1291 ----
char *PQresultErrorMessage(const PGresult *res);
! If there was an error, the returned string will include a trailing newline.
! The caller should not free the result directly. It will be freed when the
! associated PGresult> handle is passed to
! PQclear.
***************
*** 1308,1312 ****
PGresult is not an error or warning result,
or does not include the specified field. Field values will normally
! not include a trailing newline.
--- 1315,1324 ----
PGresult is not an error or warning result,
or does not include the specified field. Field values will normally
! not include a trailing newline. The caller should not free the
! result directly. It will be freed when the
! associated PGresult> handle is passed to
! PQclear.
!
!
***************
*** 1537,1541 ****
Returns the column name associated with the given column number.
! Column numbers start at 0.
char *PQfname(const PGresult *res,
--- 1549,1556 ----
Returns the column name associated with the given column number.
! Column numbers start at 0. The caller should not free the result
! directly. It will be freed when the associated PGresult>
! handle is passed to PQclear.
!
char *PQfname(const PGresult *res,
***************
*** 1751,1754 ****
--- 1766,1774 ----
of a PGresult.
Row and column numbers start at 0.
+ The caller should not free the result directly.
+ It will be freed when the
+ associated PGresult> handle is passed to
+ PQclear.
+
char* PQgetvalue(const PGresult *res,
***************
*** 1886,1890 ****
Commonly this is just the name of the command, but it may include additional
! data such as the number of rows processed.
--- 1906,1914 ----
Commonly this is just the name of the command, but it may include additional
! data such as the number of rows processed. The caller should
! not free the result directly. It will be freed when the
! associated PGresult> handle is passed to
! PQclear.
!
***************
*** 1907,1911 ****
or FETCH>, this returns a
string containing the number of rows affected. If the
! command was anything else, it returns the empty string.
--- 1931,1940 ----
or FETCH>, this returns a
string containing the number of rows affected. If the
! command was anything else, it returns the empty string. The
! caller should not free the result directly. It will be freed
! when the associated PGresult> handle is passed to
! PQclear.
!
!