parameters: (*args, **kwargs)
docstring: Issues a DeprecationWarning, adds warning to `old_name`'s
      docstring, rebinds ``old_name.__name__`` and returns the new
      function object.
  
      This function may also be used as a decorator.
  
      Parameters
      ----------
      func : function
          The function to be deprecated.
      old_name : str, optional
          The name of the function to be deprecated. Default is None, in
          which case the name of `func` is used.
      new_name : str, optional
          The new name for the function. Default is None, in which case the
          deprecation message is that `old_name` is deprecated. If given, the
          deprecation message is that `old_name` is deprecated and `new_name`
          should be used instead.
      message : str, optional
          Additional explanation of the deprecation.  Displayed in the
          docstring after the warning.
  
      Returns
      -------
      old_func : function
          The deprecated function.
  
      Examples
      --------
      Note that ``olduint`` returns a value after printing Deprecation
      Warning:
  
      >>> olduint = np.deprecate(np.uint)
      DeprecationWarning: `uint64` is deprecated! # may vary
      >>> olduint(6)
      6
docstring_summary: Issues a DeprecationWarning, adds warning to `old_name`'s
      docstring, rebinds ``old_name.__name__`` and returns the new
      function object.
docstring_tokens: Issues a DeprecationWarning adds warning to old_name s docstring rebinds old_name . __name__ and returns the new function object .
function: def deprecate(*args, **kwargs):
      """
      Issues a DeprecationWarning, adds warning to `old_name`'s
      docstring, rebinds ``old_name.__name__`` and returns the new
      function object.
  
      This function may also be used as a decorator.
  
      Parameters
      ----------
      func : function
          The function to be deprecated.
      old_name : str, optional
          The name of the function to be deprecated. Default is None, in
          which case the name of `func` is used.
      new_name : str, optional
          The new name for the function. Default is None, in which case the
          deprecation message is that `old_name` is deprecated. If given, the
          deprecation message is that `old_name` is deprecated and `new_name`
          should be used instead.
      message : str, optional
          Additional explanation of the deprecation.  Displayed in the
          docstring after the warning.
  
      Returns
      -------
      old_func : function
          The deprecated function.
  
      Examples
      --------
      Note that ``olduint`` returns a value after printing Deprecation
      Warning:
  
      >>> olduint = np.deprecate(np.uint)
      DeprecationWarning: `uint64` is deprecated! # may vary
      >>> olduint(6)
      6
  
      """
      # Deprecate may be run as a function or as a decorator
      # If run as a function, we initialise the decorator class
      # and execute its __call__ method.
  
      if args:
          fn = args[0]
          args = args[1:]
  
          return _Deprecate(*args, **kwargs)(fn)
      else:
          return _Deprecate(*args, **kwargs)
function_tokens: def deprecate ( * args , * * kwargs ) : # Deprecate may be run as a function or as a decorator # If run as a function, we initialise the decorator class # and execute its __call__ method. if args : fn = args [ 0 ] args = args [ 1 : ] return _Deprecate ( * args , * * kwargs ) ( fn ) else : return _Deprecate ( * args , * * kwargs )