[Zope-Checkins] CVS: Zope/lib/python/Products/PluginIndexes/common - PluggableIndex.py:1.5

[Andreas Jung]

Update of /cvs-repository/Zope/lib/python/Products/PluginIndexes/common
In directory cvs.zope.org:/tmp/cvs-serv11284

Modified Files:
	PluggableIndex.py 
Log Message:
minor interface cleanup


=== Zope/lib/python/Products/PluginIndexes/common/PluggableIndex.py 1.4 => 1.5 ===
     def getEntryForObject(documentId, default=None):
         """Get all information contained for a specific object by documentId"""
-        pass
 
     def index_object(documentId, obj, threshold=None):
         """Index an object:
@@ -35,38 +34,39 @@
            'obj' is the object to be indexed
 
            'threshold' is the number of words to process between committing
-           subtransactions.  If None, subtransactions are disabled"""
-
-        pass
+           subtransactions.  If None, subtransactions are disabled
+        """
 
     def unindex_object(documentId):
         """Remove the documentId from the index"""
-        pass
-
 
     def uniqueValues(name=None, withLengths=0):
         """Returns the unique values for name.
 
-        If 'withLengths' is true, returns a sequence of tuples of
-        (value, length)"""
-
-        pass
+           If 'withLengths' is true, returns a sequence of tuples of
+           (value, length)
+        """
 
     def _apply_index(request, cid=''):
         """Apply the index to query parameters given in the argument, request.
 
-        The argument should be a mapping object.
-
-        If the request does not contain the needed parametrs, then None is
-        returned.
-
-        If the request contains a parameter with the name of the column
-        + "_usage", it is sniffed for information on how to handle applying
-        the index.
+           The argument should be a mapping object.
 
-        Otherwise two objects are returned.  The first object is a ResultSet
-        containing the record numbers of the matching records.  The second
-        object is a tuple containing the names of all data fields used."""
+           If the request does not contain the needed parametrs, then None is
+           returned.
 
-        pass
+           If the request contains a parameter with the name of the column
+           + "_usage", it is sniffed for information on how to handle applying
+           the index. (Note: this style or parameters is deprecated)
+
+           If the request contains a parameter with the name of the column
+           and this parameter is either a Record or a class instance then
+           it is assumed that the parameters of this index are passed as
+           attribute (Note: this is the recommended way to pass parameters
+           since Zope 2.4)
+
+           Otherwise two objects are returned.  The first object is a ResultSet
+           containing the record numbers of the matching records.  The second
+           object is a tuple containing the names of all data fields used.
+        """