def warn_deprecated(<EOL>since, message='<STR_LIT>', name='<STR_LIT>', alternative='<STR_LIT>', pending=False,<EOL>obj_type='<STR_LIT>', addendum='<STR_LIT>', removal='<STR_LIT>'):
message = '<STR_LIT:\n>' + _generate_deprecation_message(<EOL>since, message, name, alternative, pending, obj_type, addendum,<EOL>removal=removal)<EOL>category = (PendingDeprecationWarning if pending<EOL>else _projectWarning)<EOL>warnings.warn(message, category, stacklevel=<NUM_LIT:2>)<EOL>
Used to display deprecation in a standard way.
Parameters
----------
since : str
    The release at which this API became deprecated.
message : str, optional
    Override the default deprecation message.  The format
    specifier `%(name)s` may be used for the name of the function,
    and `%(alternative)s` may be used in the deprecation message
    to insert the name of an alternative to the deprecated
    function.  `%(obj_type)s` may be used to insert a friendly name
    for the type of object being deprecated.
name : str, optional
    The name of the deprecated object.
alternative : str, optional
    An alternative API that the user may use in place of the deprecated
    API.  The deprecation warning will tell the user about this alternative
    if provided.
pending : bool, optional
    If True, uses a PendingDeprecationWarning instead of a
    DeprecationWarning.  Cannot be used together with *removal*.
removal : str, optional
    The expected removal version.  With the default (an empty string), a
    removal version is automatically computed from *since*.  Set to other
    Falsy values to not schedule a removal date.  Cannot be used together
    with *pending*.
obj_type : str, optional
    The object type being deprecated.
addendum : str, optional
    Additional text appended directly to the final message.
Examples
--------
    Basic example::
        # To warn of the deprecation of "matplotlib.name_of_module"
        warn_deprecated('1.4.0', name='matplotlib.name_of_module',
                        obj_type='module')