[Zope3-checkins] SVN: Zope3/trunk/src/zope/app/session/api.txt Abort a transaction after provoking a commit() failure.

[Tim Peters]

Log message for revision 27532:
  Abort a transaction after provoking a commit() failure.
  
  ZODB 3.3c1 won't allow a transaction to commit after
  it's failed to commit once, so failing to clean up after
  commit failures causes cascades of later commit failures.
  


Changed:
  U   Zope3/trunk/src/zope/app/session/api.txt


-=-
Modified: Zope3/trunk/src/zope/app/session/api.txt
===================================================================
--- Zope3/trunk/src/zope/app/session/api.txt	2004-09-14 21:22:34 UTC (rev 27531)
+++ Zope3/trunk/src/zope/app/session/api.txt	2004-09-14 21:47:20 UTC (rev 27532)
@@ -48,7 +48,7 @@
 
 Data Storage
 ------------
-   
+
 The actual data is stored in an `ISessionDataContainer` utility.
 `ISession` chooses which `ISessionDataContainer` should be used by
 looking up as a named utility using the package id. This allows
@@ -72,8 +72,8 @@
     True
 
 The `ISessionDataContainer` contains `ISessionData` objects, and
-`ISessionData` objects in turn contain `ISessionPkgData` objects. You 
-should never need to know this unless you are writing administrative 
+`ISessionData` objects in turn contain `ISessionPkgData` objects. You
+should never need to know this unless you are writing administrative
 views for the session machinery.
 
     >>> ISessionData.providedBy(sdc[client_id])
@@ -99,7 +99,10 @@
         [...]
     TypeError: can't pickle file objects
 
+    Clean up:
+    >>> transaction.abort()
 
+
 Page Templates
 --------------
 
@@ -118,7 +121,7 @@
                     session['count'] += 1
                 except KeyError:
                     session['count'] = 1
-            </script> 
+            </script>
 
             <span tal:content="session/count" />
         </div>