aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorBruce Momjian <bruce@momjian.us>2007-02-19 22:06:23 +0000
committerBruce Momjian <bruce@momjian.us>2007-02-19 22:06:23 +0000
commite3285f32e8262d1de69ddcd1d5a757a081be1eb4 (patch)
treeaa664eb78cf2e5697c28d2e15a05c1bc34f08a34 /doc/src
parent4acc4aa871e39bec4ea234a98c60b939a994a9ae (diff)
downloadpostgresql-e3285f32e8262d1de69ddcd1d5a757a081be1eb4.tar.gz
postgresql-e3285f32e8262d1de69ddcd1d5a757a081be1eb4.zip
Update PQfree() documentation to be clearer, backpatch to 8.2.X.
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/libpq.sgml12
1 files changed, 8 insertions, 4 deletions
diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index 5b8ef438b36..a7be065ec67 100644
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/libpq.sgml,v 1.231 2007/02/16 16:37:29 tgl Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/libpq.sgml,v 1.232 2007/02/19 22:06:23 momjian Exp $ -->
<chapter id="libpq">
<title><application>libpq</application> - C Library</title>
@@ -2617,9 +2617,13 @@ void PQfreemem(void *ptr);
<function>PQescapeBytea</function>,
<function>PQunescapeBytea</function>,
and <function>PQnotifies</function>.
- It is needed by Microsoft Windows, which cannot free memory across
- DLLs, unless multithreaded DLLs (<option>/MD</option> in VC6) are used.
- On other platforms, this function is the same as the standard library function <function>free()</>.
+ It is particularly important that this function, rather than
+ <function>free()</>, be used on Microsoft Windows. This is because
+ allocating memory in a DLL and releasing it in the application works
+ only if multithreaded/single-threaded, release/debug, and static/dynamic
+ flags are the same for the DLL and the application. On non-Microsoft
+ Windows platforms, this function is the same as the standard library
+ function <function>free()</>.
</para>
</listitem>
</varlistentry>