[Zope3-checkins] CVS: Zope3/src/persistence - interfaces.py:1.4

Jeremy Hylton jeremy@zope.com
Wed, 5 Mar 2003 17:10:36 -0500


Update of /cvs-repository/Zope3/src/persistence
In directory cvs.zope.org:/tmp/cvs-serv17277/persistence

Modified Files:
	interfaces.py 
Log Message:
Revise the explanation of the interface.


=== Zope3/src/persistence/interfaces.py 1.3 => 1.4 ===
--- Zope3/src/persistence/interfaces.py:1.3	Mon Feb 24 06:23:43 2003
+++ Zope3/src/persistence/interfaces.py	Wed Mar  5 17:10:32 2003
@@ -209,9 +209,8 @@
 class IPersistentDataManager(Interface):
     """Provide services for managing persistent state.
 
-    This interface is provided by ZODB Connections.
-
-    This interface is used by persistent objects.
+    This interface is used by a persistent object to interact with its
+    data manager in the context of a transaction.
     """
 
     def setstate(object):
@@ -231,6 +230,11 @@
         from details of transaction management. For example, it allows
         the use of per-database-connection rather than per-thread
         transaction managers.
+
+        A persistent object should not register with its data manager
+        more than once during a single transaction.  XXX should is too
+        wishy-washy; we should probably guarantee that this is true,
+        and it might be.
         """
 
     def mtime(object):