[svn r37885] adding docstrings, stripping non-used names from import

--HG--
branch : trunk

py/test/collect.py

@@ -25,7 +25,7 @@ The is a schematic example of a tree of collectors and test items::
 """ 
 from __future__ import generators 
 import py
-from py.__.test.outcome import Skipped, Failed, Passed
+from py.__.test.outcome import Skipped
 
 def configproperty(name):
     def fget(self):

py/test/item.py

@@ -67,16 +67,16 @@ class Function(Item):
         return self._sort_value
 
     def run(self):
+        """ setup and execute the underlying test function. """
         self._state.prepare(self) 
         self.execute(self.obj, *self._args)
 
     def execute(self, target, *args):
-        """ default implementation for calling a test target is to
+        """ execute the given test function. """
-            simply call it.
-        """
         target(*args)
 
     def setup(self): 
+        """ perform setup for this test function. """
         if getattr(self.obj, 'im_self', None): 
             name = 'setup_method' 
         else: 
@@ -87,6 +87,7 @@ class Function(Item):
             return meth(self.obj) 
 
     def teardown(self): 
+        """ perform teardown for this test function. """
         if getattr(self.obj, 'im_self', None): 
             name = 'teardown_method' 
         else: