From: Richard M. Stallman <rms@gnu.org>
Date: Tue, 10 Jul 2007 01:07:09 +0000 (+0000)
Subject: (eval-defun): Explain special handling of `defface'.
X-Git-Tag: emacs-pretest-22.1.90~1286
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=c40e86ef0a28ef43d849f39c1bb0d76bc43932bb;p=emacs.git

(eval-defun): Explain special handling of `defface'.
---

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 87e471753e5..dcdb04cc5fa 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,8 @@
+2007-07-10  Richard Stallman  <rms@gnu.org>
+
+	* emacs-lisp/lisp-mode.el (eval-defun):
+	Explain special handling of `defface'.
+
 2007-07-09  Richard Stallman  <rms@gnu.org>
 
 	* isearch.el (isearch-edit-string): Call to isearch-push-state
diff --git a/lisp/emacs-lisp/lisp-mode.el b/lisp/emacs-lisp/lisp-mode.el
index 73379a816d7..374d3ae2327 100644
--- a/lisp/emacs-lisp/lisp-mode.el
+++ b/lisp/emacs-lisp/lisp-mode.el
@@ -730,7 +730,9 @@ If the current defun is actually a call to `defvar' or `defcustom',
 evaluating it this way resets the variable using its initial value
 expression even if the variable already has some other value.
 \(Normally `defvar' and `defcustom' do not alter the value if there
-already is one.)
+already is one.)  In an analogous way, evaluating a `defface'
+overrides any customizations of the face, so that it becomes
+defined exactly as the `defface' expression says.
 
 If `eval-expression-debug-on-error' is non-nil, which is the default,
 this command arranges for all errors to enter the debugger.