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 4364ff0fce8..8e6168cbdb0 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 7f9bc97b0d7..c788386f6a6 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>
--
GitLab