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

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 87e471753e5e67261db4b4a2e1450967824fd4a3..dcdb04cc5fa8cab76572a5c1b63b6f6c17fafc37 100644 (file)
--- 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 73379a816d78eeababd02418c8a3001647bdb216..374d3ae2327e90ec06c00ad9f6a2d41a8bdf5b26 100644 (file)
--- 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.