Here's my attempt to fix the docstring. Comments welcome.

-----