[SQL-CVS] r4732 - SQLObject/branches/1.7/docs

[<sub...@co...>]

Author: phd
Date: Sat May 10 12:17:50 2014
New Revision: 4732

Log:
Document sqlhub.doInTransaction

Modified:
   SQLObject/branches/1.7/docs/SQLObject.txt

Modified: SQLObject/branches/1.7/docs/SQLObject.txt
==============================================================================
--- SQLObject/branches/1.7/docs/SQLObject.txt	Fri May  9 11:47:30 2014	(r4731)
+++ SQLObject/branches/1.7/docs/SQLObject.txt	Sat May 10 12:17:50 2014	(r4732)
@@ -1432,6 +1432,13 @@
 
     Person.select(Person.q.name=="value", forUpdate=True, connection=trans)
 
+Method ``sqlhub.doInTransaction`` can be used to run a piece of code in
+a transaction. The method accepts a callable and positional and keywords
+arguments. It begins a transaction using its ``processConnection`` or
+``threadConnection``, calls the callable, commits the transaction and
+closes the underlying connection; it returns whatever the callable
+returned. If an error occurs during call to the callable it rolls the
+transaction back and reraise the exception.
 
 Automatic Schema Generation
 ---------------------------