[Zope-Checkins] CVS: Zope3/lib/python/Zope/Event - IEventSet.py:1.1.2.2 IObjectEvent.py:1.1.2.2 ISubscribable.py:1.1.2.2

[Chris Withers]

Update of /cvs-repository/Zope3/lib/python/Zope/Event
In directory cvs.zope.org:/tmp/cvs-serv27208

Modified Files:
      Tag: Zope-3x-branch
	IEventSet.py IObjectEvent.py ISubscribable.py 
Log Message:
SB/CW -  small cosmetic changes


=== Zope3/lib/python/Zope/Event/IEventSet.py 1.1.2.1 => 1.1.2.2 ===
 
 class IEventSet(ISubscriber):
-    """An unordered buffer of events."""
+    """An unordered collection of location-independent events."""
 
     def size():
         """Returns the number of events stored."""
@@ -28,4 +28,5 @@
     def get(n=None):
         """Returns a collection of events.
 
-        This must be iteratable"""
+        This must be iteratable.
+        """


=== Zope3/lib/python/Zope/Event/IObjectEvent.py 1.1.2.1 => 1.1.2.2 ===
 
 class IObjectEvent(IEvent):
-    """The Base interface for Events fired by objects"""
+    """Something has happened to an object.
 
-    def getObject():
-        """Return the object which the event is 'about'"""
+    The object that generated this event is not necessarily the object
+    refered to by getLocation.
+    """
+
+    def getLocation():        
+        """returns the object location."""
+
+class IObjectAdded(IObjectEvent):
+    """An object has been added to a container."""
+
+    def getLocation():        
+        """returns the object location after it has been added to the container"""
+
+class IObjectModified(IObjectEvent):
+    """An object has been modified"""
+
+class IObjectRemoved(IObjectEvent):
+    """An object has been removed from a container"""
+    
+    def getLocation():
+        """location of the object before it was removed"""
+
+class IObjectMoved(IObjectEvent):
+    """An object has been moved"""
+
+    def getFromLocation():
+        """location of the object before it was moved"""
+
+    def getLocation():
+        """location of the object after it was moved"""


=== Zope3/lib/python/Zope/Event/ISubscribable.py 1.1.2.1 => 1.1.2.2 ===