[Checkins] SVN: transaction/trunk/transaction/interfaces.py Added documentation I should have included earlier.

[Jim Fulton]

Log message for revision 112265:
  Added documentation I should have included earlier.
  

Changed:
  U   transaction/trunk/transaction/interfaces.py

-=-
Modified: transaction/trunk/transaction/interfaces.py
===================================================================
--- transaction/trunk/transaction/interfaces.py	2010-05-12 20:36:53 UTC (rev 112264)
+++ transaction/trunk/transaction/interfaces.py	2010-05-12 20:42:44 UTC (rev 112265)
@@ -323,8 +323,14 @@
 
         Abort must be called outside of a two-phase commit.
 
-        Abort is called by the transaction manager to abort transactions
-        that are not yet in a two-phase commit.
+        Abort is called by the transaction manager to abort
+        transactions that are not yet in a two-phase commit.  It may
+        also be called when rolling back a savepoint made before the
+        data manager joined the transaction.
+
+        In any case, after abort is called, the data manager is no
+        longer participating in the transaction.  If there are new
+        changes, the data manager must rejoin the transaction.
         """
 
     # Two-phase commit protocol.  These methods are called by the ITransaction