[Checkins] SVN: zope.copypastemove/trunk/ Fix documentation for the IObjectCopier.copyTo method.

[Dan Korostelev]

Log message for revision 97525:
  Fix documentation for the IObjectCopier.copyTo method.

Changed:
  U   zope.copypastemove/trunk/CHANGES.txt
  U   zope.copypastemove/trunk/src/zope/copypastemove/__init__.py
  U   zope.copypastemove/trunk/src/zope/copypastemove/interfaces.py

-=-
Modified: zope.copypastemove/trunk/CHANGES.txt
===================================================================
--- zope.copypastemove/trunk/CHANGES.txt	2009-03-05 11:36:32 UTC (rev 97524)
+++ zope.copypastemove/trunk/CHANGES.txt	2009-03-05 11:50:36 UTC (rev 97525)
@@ -5,7 +5,7 @@
 3.5.2 (unreleased)
 ------------------
 
-- ...
+- Fix documentation for the IObjectCopier.copyTo method.
 
 3.5.1 (2009-02-09)
 ------------------

Modified: zope.copypastemove/trunk/src/zope/copypastemove/__init__.py
===================================================================
--- zope.copypastemove/trunk/src/zope/copypastemove/__init__.py	2009-03-05 11:36:32 UTC (rev 97524)
+++ zope.copypastemove/trunk/src/zope/copypastemove/__init__.py	2009-03-05 11:50:36 UTC (rev 97525)
@@ -182,7 +182,7 @@
         """Move this object to the `target` given.
 
         Returns the new name within the `target`
-        Typically, the `target` is adapted to `IPasteTarget`."""
+        """
 
         obj = self.context
         container = obj.__parent__
@@ -373,13 +373,9 @@
     def copyTo(self, target, new_name=None):
         """Copy this object to the `target` given.
 
-        Returns the new name within the `target`.
-
-        Typically, the `target` is adapted to `IPasteTarget`.
-        After the copy is added to the `target` container, publish
-        an `IObjectCopied` event in the context of the target container.
-        If a new object is created as part of the copying process, then
-        an `IObjectCreated` event should be published.
+        Returns the new name within the `target`. After the copy
+        is created and before adding it to the target container,
+        an `IObjectCopied` event is published.
         """
         obj = self.context
         container = obj.__parent__

Modified: zope.copypastemove/trunk/src/zope/copypastemove/interfaces.py
===================================================================
--- zope.copypastemove/trunk/src/zope/copypastemove/interfaces.py	2009-03-05 11:36:32 UTC (rev 97524)
+++ zope.copypastemove/trunk/src/zope/copypastemove/interfaces.py	2009-03-05 11:50:36 UTC (rev 97525)
@@ -26,7 +26,7 @@
         """Move this object to the target given.
 
         Returns the new name within the target.
-        Typically, the target is adapted to `IPasteTarget`."""
+        """
 
     def moveable():
         """Returns ``True`` if the object is moveable, otherwise ``False``."""
@@ -43,12 +43,9 @@
     def copyTo(target, new_name=None):
         """Copy this object to the `target` given.
 
-        Returns the new name within the `target`.
-        Typically, the target is adapted to `IPasteTarget`.
-        After the copy is added to the target container, publish
-        an `IObjectCopied` event in the context of the target container.
-        If a new object is created as part of the copying process, then
-        an `IObjectCreated` event should be published.
+        Returns the new name within the `target`. After the copy
+        is created and before adding it to the target container,
+        an `IObjectCopied` event is published.
         """
 
     def copyable():