[Zope-CVS] CVS: Products/Ape/lib/apelib/core - io.py:1.4

[Shane Hathaway]

Update of /cvs-repository/Products/Ape/lib/apelib/core
In directory cvs.zope.org:/tmp/cvs-serv32590/lib/apelib/core

Modified Files:
	io.py 
Log Message:
Added minor comments

=== Products/Ape/lib/apelib/core/io.py 1.3 => 1.4 ===
--- Products/Ape/lib/apelib/core/io.py:1.3	Mon May 26 22:19:12 2003
+++ Products/Ape/lib/apelib/core/io.py	Mon Jun 23 22:50:05 2003
@@ -206,6 +206,8 @@
     def __init__(self, root_mapper, connections, class_factory=None):
         self._objects = {}     # { keychain -> obj }
         self._keychains = {}   # { id(obj) -> keychain }
+        # _incomplete contains the keychains of objects not yet
+        # imported fully.
         self._incomplete = {}   # { keychain -> 1 }
         self._class_factory = class_factory
         # Avoid a circular reference by making a weakref proxy
@@ -214,6 +216,11 @@
 
 
     def _register(self, keychain, obj):
+        """Registers obj in the temporary object index.
+
+        Returns true if the object was added to the index for the first
+        time.  If the registration conflicts, raises an exception.
+        """
         is_new = 0
         if self._objects.has_key(keychain):
             if self._objects[keychain] is not obj: