I think that it would be useful to state in the docstring that it is deprecated.