lisa.utils.deprecate: Allow deprecating a parameter

Deprecated parameters will emit a warning when used, and the docstring will be
updated in right spot at the end of the relevant :param: block.