From 8f61184db70be4650db72b14f9fe3487b4230ff7 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Mon, 1 Dec 2003 22:36:40 +0000
Subject: [PATCH] Hi, this doco patch is a quick one to add explicit mention of
 the need for the AT clause in threaded ECPG applications.

Philip Yarra
---
 doc/src/sgml/ecpg.sgml | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/doc/src/sgml/ecpg.sgml b/doc/src/sgml/ecpg.sgml
index 2c113385de..27aca4e60e 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.56 2003/11/29 19:51:36 pgsql Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ecpg.sgml,v 1.57 2003/12/01 22:36:40 momjian Exp $
 -->
 
 <chapter id="ecpg">
@@ -353,6 +353,13 @@ EXEC SQL AT <replaceable>connection-name</replaceable> SELECT ...;
 </programlisting>
    This option is particularly suitable if the application needs to
    use several connections in mixed order.
+      </para>
+
+      <para>
+      If your application uses multiple threads of execution, they cannot share a
+      connection concurrently. You must either explicitly control access to the connection
+      (using mutexes) or use a connection for each thread. If each thread uses its own connection,
+      you will need to use the AT clause to specify which connection the thread will use.
   </para>
 
   <para>