[Zope-CVS] SVN: zversioning/trunk/src/versioning/interfaces.py updated class signature and added comments

[Grégoire Weber]

Log message for revision 28042:
  updated class signature and added comments

Changed:
  U   zversioning/trunk/src/versioning/interfaces.py

-=-
Modified: zversioning/trunk/src/versioning/interfaces.py
===================================================================
--- zversioning/trunk/src/versioning/interfaces.py	2004-10-13 08:07:53 UTC (rev 28041)
+++ zversioning/trunk/src/versioning/interfaces.py	2004-10-13 08:16:07 UTC (rev 28042)
@@ -250,10 +250,14 @@
     IHistoryStorage components store IVersionableAspects of objects.
     """
 
-    def createVersionHistory(obj) :
+    def register(obj) :
         """ Puts some object under version control. Returns an IHistory.
         
-        XXX YAGNI?
+        Why register?
+        We like to give the IHistoryStorage component the possibility
+        to veto as early as possible (e.g. to raise "connection to 
+        backend repository lost" or "quota for user Ben exceded" 
+        exceptions or similar)
         """
     
     def getVersion(history, selector):