-

cool-RR · cool-RR · commit f0feaa9995af · 2016-01-12T21:11:05.000+02:00
diff --git a/source_py3/python_toolbox/context_management/functions.py b/source_py3/python_toolbox/context_management/functions.py
@@ -68,7 +68,30 @@ def as_idempotent(context_manager):
     Note: The first value returned by `__enter__` will be returned by all the
     subsequent no-op `__enter__` calls.
     
-    blocktodo: add to docs about different ways of calling, ensure tests
+    This can be used when calling an existing context manager:
+    
+        with as_idempotent(some_context_manager):
+            # Now we're idempotent!
+            
+    Or it can be used when defining a context manager to make it idempotent:
+    
+        @as_idempotent
+        class MyContextManager(ContextManager):
+            def __enter__(self):
+                # ...
+            def __exit__(self, exc_type, exc_value, exc_traceback):
+                # ...
+                
+    And also like this... 
+
+    
+        @as_idempotent
+        @ContextManagerType
+        def Meow():
+            yield # ...
+    
+    blocktodo: add tests for decorating ContextManager class and
+    @ContextManagerType generator.
     '''
     return _IdempotentContextManager._wrap_context_manager_or_class(
         context_manager, 
