Here is a patch to improve a docstring.  Comments welcome.