From 8fc0aa4ccaec0147771b055782ba4d8f752c3c76 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Thu, 13 Oct 2005 17:46:18 +0000
Subject: [PATCH] Clarify causes of possible mismatch between Win32 libraries
 and applications that use FILE pointers.

---
 doc/src/sgml/ecpg.sgml  | 6 ++++--
 doc/src/sgml/libpq.sgml | 6 ++++--
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/doc/src/sgml/ecpg.sgml b/doc/src/sgml/ecpg.sgml
index 0882c5ad64..849c8efbe4 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.67 2005/09/25 03:12:13 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ecpg.sgml,v 1.68 2005/10/13 17:46:18 momjian Exp $
 -->
 
 <chapter id="ecpg">
@@ -1612,7 +1612,9 @@ ECPG = ecpg
     On Win32, if the <application>ecpg</> libraries and an application are
     compiled with different flags, this function call will crash the 
     application because the internal representation of the 
-    <literal>FILE</> pointers differ.
+    <literal>FILE</> pointers differ.  Specifically,
+    threading/non-threading, release/debug, and static/dynamic flags should 
+    be the same for the library and all applications using that library.
     </para>
     </note>
    </listitem>
diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index c72eb298ff..d05cf23e54 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.191 2005/09/25 03:12:13 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/libpq.sgml,v 1.192 2005/10/13 17:46:18 momjian Exp $
 -->
 
  <chapter id="libpq">
@@ -3520,7 +3520,9 @@ void PQtrace(PGconn *conn, FILE *stream);
 On Win32, if the <application>libpq</> library and an application are
 compiled with different flags, this function call will crash the 
 application because the internal representation of the <literal>FILE</> 
-pointers differ.
+pointers differ.  Specifically, threading/non-threading, release/debug, and
+static/dynamic flags should be the same for the library and all applications
+using that library.
 </para>
 </note>
 </listitem>