revised docstrings