-

cool-RR · cool-RR · commit 5cc8456a68ec · 2012-01-02T20:31:36.000-05:00
diff --git a/python_toolbox/context_managers/base_classes/decorating_context_manager.py b/python_toolbox/context_managers/base_classes/decorating_context_manager.py
@@ -14,7 +14,17 @@
 
 class DecoratingContextManager(object):
     '''
-    blocktododoc
+    Context manager that can decorate a function to use it.
+    
+    Example:
+    
+        my_context_manager = DecoratingContextManager()
+        
+        @my_context_manager
+        def f():
+            pass # Anything that happens here is surrounded by the
+                 # equivalent of `my_context_manager`.
+        
     '''
     
     def __call__(self, function):
diff --git a/python_toolbox/context_managers/reentrant_context_manager.py b/python_toolbox/context_managers/reentrant_context_manager.py
@@ -13,8 +13,7 @@
 from python_toolbox.proxy_property import ProxyProperty
 
 from .context_manager import ContextManager
-# blocktodo: need tests on whether `depth` is increased before or after
-# `reentrant_enter` and `reentrant_exit`. Was relevant in freezers.
+
 
 class ReentrantContextManager(ContextManager):
     '''
diff --git a/python_toolbox/import_tools.py b/python_toolbox/import_tools.py
@@ -74,7 +74,7 @@ def normal_import(module_name):
         return __import__(module_name)
     
 
-@caching.cache() # todo: clear cache if sys.path changes
+@caching.cache() # todo: clear cache if `sys.path` changes
 def import_if_exists(module_name, silent_fail=False):
     '''
     Import module by name and return it, only if it exists.
@@ -106,11 +106,6 @@ def import_if_exists(module_name, silent_fail=False):
             else: # silent_fail is False
                 raise ImportError("Can't find %s." % module_name)
 
-    # blocktododoc Not actually using the result of `imp.find_module`, just
-    # want to know that it worked and the module exists. We'll let
-    # `normal_import` find the module again, assuming its finding procedure
-    # will work exactly the same as `imp`'s.
-        
     return normal_import(module_name)
 
 
diff --git a/python_toolbox/module_tasting/module_tasting.py b/python_toolbox/module_tasting/module_tasting.py
@@ -2,12 +2,12 @@
 # This program is distributed under the LGPL2.1 license.
 
 '''
-This module defines the `taste_module` class.
+This module defines the `taste_module` function.
 
 See its documentation for more information.
 '''
 
-# blocktodo: Will need thread safety for when another thread is importing at
+# todo: Will need thread safety for when another thread is importing at
 # the same time. probably make context manager for import lock from imp.
 
 from __future__ import with_statement
diff --git a/python_toolbox/wx_tools/keyboard/key.py b/python_toolbox/wx_tools/keyboard/key.py
@@ -10,7 +10,7 @@
 import wx
 
 
-class Key(object):    #blocktodo: __repr__
+class Key(object):
     '''A key combination.'''
 
     def __init__(self, key_code, cmd=False, alt=False, shift=False):
