DOC: changed docstrings for more clarification