code: def warn_deprecated(
      since,
      *,
      message="",
      name="",
      alternative="",
      pending=False,
      obj_type="",
      addendum="",
      removal="",
  ):
      """
      Display a standardized deprecation.
  
      Parameters
      ----------
      since : str
          The release at which this API became deprecated.
      message : str, optional
          Override the default deprecation message.  The ``%(since)s``,
          ``%(name)s``, ``%(alternative)s``, ``%(obj_type)s``, ``%(addendum)s``,
          and ``%(removal)s`` format specifiers will be replaced by the values
          of the respective arguments passed to this function.
      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*.
      obj_type : str, optional
          The object type being deprecated.
      addendum : str, optional
          Additional text appended directly to the final message.
      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*.
  
      Examples
      --------
      ::
  
          # To warn of the deprecation of "matplotlib.name_of_module"
          warn_deprecated('1.4.0', name='matplotlib.name_of_module',
                          obj_type='module')
      """
      warning = _generate_deprecation_warning(
          since,
          message,
          name,
          alternative,
          pending,
          obj_type,
          addendum,
          removal=removal,
      )
      from . import warn_external
  
      warn_external(warning, category=MatplotlibDeprecationWarning)
  
file_path: matplotlib/lib/matplotlib/_api/deprecation.py
imports: import contextlib
  import functools
  import inspect
  import math
  import warnings
label_desc: Use image node_id 2 for calling a global function with example usage: warn_deprecated(since) without return types