summaryrefslogtreecommitdiff
path: root/lispref/functions.texi
diff options
context:
space:
mode:
authorJuanma Barranquero <lekktu@gmail.com>2005-06-15 23:09:44 +0000
committerJuanma Barranquero <lekktu@gmail.com>2005-06-15 23:09:44 +0000
commit1915b9d56ac7b4dc14b02c446f2d8bd4bb8b9900 (patch)
tree79024c0bd6e8cd0a2d4a5914ffd684d813acfb02 /lispref/functions.texi
parent665ed61ac2142bc0d36d1201146d5512b57701e5 (diff)
downloademacs-1915b9d56ac7b4dc14b02c446f2d8bd4bb8b9900.tar.gz
(Obsolete Functions): Update argument names of `make-obsolete' and
`define-obsolete-function-alias'.
Diffstat (limited to 'lispref/functions.texi')
-rw-r--r--lispref/functions.texi20
1 files changed, 11 insertions, 9 deletions
diff --git a/lispref/functions.texi b/lispref/functions.texi
index bcdfc95cc1c..409f0125ad8 100644
--- a/lispref/functions.texi
+++ b/lispref/functions.texi
@@ -1157,13 +1157,14 @@ a function defined by another package, it is cleaner to use
You can use @code{make-obsolete} to declare a function obsolete. This
indicates that the function may be removed at some stage in the future.
-@defun make-obsolete function new &optional when
+@defun make-obsolete obsolete-name current-name &optional when
This function makes the byte compiler warn that the function
-@var{function} is obsolete. If @var{new} is a symbol, the warning
-message says to use @var{new} instead of @var{function}. @var{new}
-does not need to be an alias for @var{function}; it can be a different
-function with similar functionality. If @var{new} is a string, it is
-the warning message.
+@var{obsolete-name} is obsolete. If @var{current-name} is a symbol, the
+warning message says to use @var{current-name} instead of
+@var{obsolete-name}. @var{current-name} does not need to be an alias for
+@var{obsolete-name}; it can be a different function with similar
+functionality. If @var{current-name} is a string, it is the warning
+message.
If provided, @var{when} should be a string indicating when the function
was first made obsolete---for example, a date or a release number.
@@ -1172,9 +1173,10 @@ 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 @code{define-obsolete-function-alias}.
-@defmac define-obsolete-function-alias function new &optional when docstring
-This macro marks the function @var{function} obsolete and also defines
-it as an alias for the function @var{new}. A typical call has the form:
+@defmac define-obsolete-function-alias obsolete-name current-name &optional when docstring
+This macro marks the function @var{obsolete-name} obsolete and also defines
+it as an alias for the function @var{current-name}. A typical call has the
+form:
@example
(define-obsolete-function-alias 'old-fun 'new-fun "22.1" "Doc.")