Mark a function, class, or method as deprecated (decorator).
Originally adapted from sklearn and http://wiki.python.org/moin/PythonDecoratorLibrary, then modified to make arguments populate properly following our verbose decorator methods based on decorator.
str
Extra information beyond just saying the class/function/method is deprecated.