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

bmomjian · bmomjian · commit ccc0a1326ed5 · 2005-09-25T03:06:41.000Z
DLL compiles to not match the application.
diff --git 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
@@ -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>
 
