explained deprecation in docstring