Please feel free to edit the docstring in any way that you think would make it clearer.  There was obviously some ambiguity there, so it's probably worth making some of this more explicit.