Index: trunk/packages/sipb-xen-base/files/usr/share/python-support/sipb-xen-base/invirt/common.py
===================================================================
--- trunk/packages/sipb-xen-base/files/usr/share/python-support/sipb-xen-base/invirt/common.py	(revision 785)
+++ trunk/packages/sipb-xen-base/files/usr/share/python-support/sipb-xen-base/invirt/common.py	(revision 786)
@@ -27,5 +27,13 @@
 
 def with_closing(rsrc):
-    "Utility to emulate Python 2.5's `with closing(rsrc)` context manager."
+    """
+    Utility to emulate Python 2.5's `with closing(rsrc)` context manager.
+
+    E.g.,
+    @with_closing(file('/tmp/foo'))
+    def contents(f):
+        return f.read()
+    # now 'contents' is the contents of /tmp/foo
+    """
     def wrapper(func):
         try: return func(rsrc)
@@ -41,6 +49,6 @@
         print 'locked'
         return raw_input()
-    # decorator is executed immediately
-    print input # prints the input text
+    # prints 'locked'
+    print input # prints what raw_input() returned
     """
     def wrapper(func):