lisa.utils: Add deprecate() decorator

Allows marking a function/method as deprecated.  This will wrap it to
emit a DeprecationWarning when called, and will update its docstring
with ".. deprecated" Sphinx directive.