code: def warn_deprecated(
          since, message='', name='', alternative='', pending=False,
          obj_type='attribute', addendum='', removal=''):
      
      message = '\n' + _generate_deprecation_message(
          since, message, name, alternative, pending, obj_type, addendum,
          removal=removal)
      category = (PendingDeprecationWarning if pending
                  else _projectWarning)
      warnings.warn(message, category, stacklevel=2)
docs: 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')