code: def warn_deprecated(since, message='', name='', alternative='', pending=False,
                      obj_type='attribute', addendum=''):
      
      message = _generate_deprecation_message(since, message, name, alternative,
                                              pending, obj_type)
  
      warnings.warn(message, metpyDeprecation, stacklevel=1)
docs: 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 "metpy.name_of_module"
              warn_deprecated('0.6.0', name='metpy.name_of_module',
                              obj_type='module')