From: Luc Teirlinck <teirllm@auburn.edu>
Date: Thu, 5 May 2005 23:19:02 +0000 (+0000)
Subject: (Variable Aliases): Change description of `define-obsolete-variable-alias'.
X-Git-Tag: ttn-vms-21-2-B4~511
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=6c9fb58872487b26311784fc44c36bfd01198b63;p=emacs.git

(Variable Aliases): Change description of `define-obsolete-variable-alias'.
---

diff --git a/lispref/variables.texi b/lispref/variables.texi
index 8b34f4bb9aa..5ece7e98906 100644
--- a/lispref/variables.texi
+++ b/lispref/variables.texi
@@ -1736,14 +1736,19 @@ same time using the macro @code{define-obsolete-variable-alias}.
 
 @defmac define-obsolete-variable-alias variable new &optional when docstring
 This macro marks the variable @var{variable} as obsolete and also
-makes it an alias for the variable @var{new}.
-
-If provided, @var{when} should be a string indicating when
-@var{variable} was first made obsolete.  The optional argument
-@var{docstring} specifies the documentation string for @var{variable}.
-If @var{docstring} is omitted or nil, @var{variable} uses the
-documentation string of @var{new} unless it already has one of its
-own.
+makes it an alias for the variable @var{new}.  A typical call has the form:
+
+@example
+(define-obsolete-variable-alias 'old-var 'new-var "22.1" "Doc.")
+@end example
+
+@noindent
+which is equivalent to the following two lines of code:
+
+@example
+(defvaralias 'oldvar 'newvar "Doc.")
+(make-obsolete-variable 'old-var 'new-var "22.1")
+@end example
 @end defmac
 
 @defun indirect-variable variable