12.9 Declaring Functions Obsolete

You can use make-obsolete to declare a function obsolete. This indicates that the function may be removed at some stage in the future.

Function: make-obsolete obsolete-name current-name &optional when

This function makes the byte compiler warn that the function obsolete-name is obsolete. If current-name is a symbol, the warning message says to use current-name instead of obsolete-name. current-name does not need to be an alias for obsolete-name; it can be a different function with similar functionality. If current-name is a string, it is the warning message.

If provided, when should be a string indicating when the function was first made obsolete—for example, a date or a release number.

You can define a function as an alias and declare it obsolete at the same time using the macro define-obsolete-function-alias.

Macro: define-obsolete-function-alias obsolete-name current-name &optional when docstring

This macro marks the function obsolete-name obsolete and also defines it as an alias for the function current-name. It is equivalent to the following:

(defalias obsolete-name current-name docstring) (make-obsolete obsolete-name current-name when)

Ce document a été généré par Eric Reinbold le 13 Octobre 2007 en utilisant texi2html 1.78.