I realize you're probably following the pattern used in lock.py, but this isn't the right place to put function docstrings. See http://www.python.org/dev/peps/pep-0257/