"""This is a decorator which can be used to mark functions
as deprecated. It will result in a warning being emitted
when the function is used.
"""This is a decorator which can be used to mark functions
as deprecated. It will result in a warning being emitted
when the function is used.