John, thanks for the extensive description, I love it!

Would it be too picky to ask to wrap the docstring at 80 chars for readability, and to make it valid ReST format?