[Zope3-checkins] CVS: Zope3/src/zope/app/interfaces - undo.py:1.3

Anthony Baxter anthony@interlink.com.au
Thu, 10 Jul 2003 01:33:06 -0400


Update of /cvs-repository/Zope3/src/zope/app/interfaces
In directory cvs.zope.org:/tmp/cvs-serv7741

Modified Files:
	undo.py 
Log Message:
fix lying docstring


=== Zope3/src/zope/app/interfaces/undo.py 1.2 => 1.3 ===
--- Zope3/src/zope/app/interfaces/undo.py:1.2	Wed Dec 25 09:12:56 2002
+++ Zope3/src/zope/app/interfaces/undo.py	Thu Jul 10 01:33:00 2003
@@ -17,9 +17,20 @@
 class IUndoManager(Interface):
     " Interface for the Undo Manager "
 
-    def getUndoInfo():
+    def getUndoInfo(first=0, last=-20, user_name=None):
         """
-        Gets all undo information.
+        Gets some undo information. It skips the 'first' most
+        recent transactions; i.e. if first is N, then the first
+        transaction returned will be the Nth transaction.
+
+        If last is less than zero, then its absolute value is the
+        maximum number of transactions to return.  Otherwise if last
+        is N, then only the N most recent transactions following start
+        are considered.
+
+        If user_name is not None, only transactions from the given
+        user_name are returned.
+
         Note: at the moment, doesnt care where called from
 
         returns sequence of mapping objects by date desc
@@ -27,7 +38,8 @@
         keys of mapping objects:
           id          -> internal id for zodb
           user_name   -> name of user that last accessed the file
-          time        -> date of last access
+          time        -> unix timestamp of last access
+          datetime    -> datetime object of time
           description -> transaction description
         """