From: Glenn Morris <rgm@gnu.org>
Date: Sat, 12 Apr 2008 03:13:27 +0000 (+0000)
Subject: (define-obsolete-variable-alias): Doc fix.
X-Git-Tag: emacs-pretest-23.0.90~6313
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=f8754ca2dea51bbcddb30dedc4c4d1e6383fa0c1;p=emacs.git

(define-obsolete-variable-alias): Doc fix.
---

diff --git a/lisp/emacs-lisp/byte-run.el b/lisp/emacs-lisp/byte-run.el
index 855111b9f9b..06b28beab7e 100644
--- a/lisp/emacs-lisp/byte-run.el
+++ b/lisp/emacs-lisp/byte-run.el
@@ -161,6 +161,15 @@ is equivalent to the following two lines of code:
 \(defvaralias 'old-var 'new-var \"old-var's doc.\")
 \(make-obsolete-variable 'old-var 'new-var \"22.1\")
 
+If CURRENT-NAME is a defcustom (more generally, any variable
+where OBSOLETE-NAME may be set, e.g. in a .emacs file, before the
+alias is defined), then the define-obsolete-variable-alias
+statement should be placed before the defcustom.  This is so that
+any user customizations are applied before the defcustom tries to
+initialize the variable (this is due to the way `defvaralias' works).
+Exceptions to this rule occur for define-obsolete-variable-alias
+statements that are autoloaded, or in files dumped with Emacs.
+
 See the docstrings of `defvaralias' and `make-obsolete-variable' or
 Info node `(elisp)Variable Aliases' for more details."
   (declare (doc-string 4))