From ccc0a1326ed5c8ba7aa3338cfa7d5e1b9693032b Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Sun, 25 Sep 2005 03:06:41 +0000
Subject: [PATCH] Document why PQtrace and ecpg debug() can crash the
 application if the DLL compiles to not match the application.

---
 doc/src/sgml/ecpg.sgml  | 9 ++++++++-
 doc/src/sgml/libpq.sgml | 9 ++++++++-
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/doc/src/sgml/ecpg.sgml b/doc/src/sgml/ecpg.sgml
index 4364ff0fce..8e6168cbdb 100644
--- 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 7f9bc97b0d..c788386f6a 100644
--- 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>
 
-- 
2.11.0