I have adjusted the docstring, hopefully adequate now.