DOC: changed docstrings to clarify more