[Zope3-checkins] CVS: ZODB/src/ZODB - Connection.py:1.121

[Jeremy Hylton]

Update of /cvs-repository/ZODB/src/ZODB
In directory cvs.zope.org:/tmp/cvs-serv12598

Modified Files:
	Connection.py 
Log Message:
Use more care in describing use of Conn. by multiple threads.


=== ZODB/src/ZODB/Connection.py 1.120 => 1.121 ===
--- ZODB/src/ZODB/Connection.py:1.120	Tue Feb 24 16:31:03 2004
+++ ZODB/src/ZODB/Connection.py	Tue Feb 24 16:38:38 2004
@@ -57,8 +57,8 @@
     object and all objects reachable from it are associated with the
     Connection that loaded them.  When the objects are modified, the
     Connection is registered with the current transaction.
-    
-    ZODB is organized so that each thread should have its own
+
+    The typical use of ZODB is for each thread should have its own
     Connection and that no thread should have more than one Connection
     to the same database.  A thread is associated with a Connection by
     loading objects from that Connection.  Objects loaded by one
@@ -75,6 +75,9 @@
     If an application has more than one thread that uses the
     connection or the transaction the connection is registered with,
     the application should provide locking.
+
+    XXX We should document an intended API for using a Connection via
+    multiple threads.
 
     $Id$
     """