No, is intended to be more of a free-form description of what it does. 
I decided that a 'standard' (pep257 style) docstring would require a proper individual description of the arguments -- probably in addition to a functional account like this one -- so it would be substantially longer and therefore undesirable.
I'll try recasting this as a comment rather than a docstring.