Document why PQtrace and ecpg debug() can crash the application if the

DLL compiles to not match the application.

diff --git a/doc/src/sgml/ecpg.sgml b/doc/src/sgml/ecpg.sgml
index 4364ff0fce80a75a4fcab313cd904d3fc54cfce8..8e6168cbdb0daceaa767eaac88520383f1d6eed5 100644 (file)
--- a/doc/src/sgml/ecpg.sgml
+++ b/doc/src/sgml/ecpg.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ecpg.sgml,v 1.65 2005/07/14 06:17:35 neilc Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ecpg.sgml,v 1.66 2005/09/25 03:06:41 momjian Exp $
 -->
 
 <chapter id="ecpg">
@@ -1607,6 +1607,13 @@ ECPG = ecpg
      useful when searching for errors in your <acronym>SQL</acronym>
      statements.
     </para>
+    <note>
+    <para>
+    On Win32, if the <application>ecpg</> libraries and application are compiled with
+    different flags, this function call will crash the application because the
+    internal representation of the <literal>FILE</> pointers differ.
+    </para>
+    </note>
    </listitem>
 
    <listitem>

diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index 7f9bc97b0d7a81a6a9313ec168fa592562722d13..c788386f6a6a9c8c073f51b65d31b1c096a714e7 100644 (file)
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/libpq.sgml,v 1.189 2005/08/14 22:19:49 petere Exp $
+$PostgreSQL: pgsql/doc/src/sgml/libpq.sgml,v 1.190 2005/09/25 03:06:41 momjian Exp $
 -->
 
  <chapter id="libpq">
@@ -3515,6 +3515,13 @@ affect the messages available from already-existing
 void PQtrace(PGconn *conn, FILE *stream);
 </synopsis>
 </para>
+<note>
+<para>
+On Win32, if the <application>libpq</> library and application are compiled with
+different flags, this function call will crash the application because the
+internal representation of the <literal>FILE</> pointers differ.
+</para>
+</note>
 </listitem>
 </varlistentry>