code: def warn_deprecated(
      since,
      message="",
      name="",
      alternative="",
      pending=False,
      obj_type="attribute",
      addendum="",
  ):
      """
      Used to display deprecation warning 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 function that the user may use in place of the
          deprecated function.  The deprecation warning will tell the user
          about this alternative if provided.
  
      pending : bool, optional
          If True, uses a PendingDeprecationWarning instead of a
          DeprecationWarning.
  
      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')
  
      """
      message = _generate_deprecation_message(
          since, message, name, alternative, pending, obj_type
      )
  
      warnings.warn(message, mplDeprecation, stacklevel=1)
  
file_path: catboost/contrib/python/matplotlib/py2/matplotlib/cbook/deprecation.py
imports: import functools
  import textwrap
  import warnings
label_desc: Use image node_id 2 for calling a global function with example usage: warn_deprecated(since, message, name, alternative, pending, obj_type, addendum) without return types