revised docstring