# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 1184029623 0
# Node ID 8e308ce2d88453d8bc8c3e523da90608ff68f29a
# Parent  921bc039bcacc618c18b3437e045fcbac0e8d608
(eval-defun): Explain special handling of `defface'.

diff -r 921bc039bcac -r 8e308ce2d884 lisp/emacs-lisp/lisp-mode.el
--- a/lisp/emacs-lisp/lisp-mode.el	Tue Jul 10 01:05:49 2007 +0000
+++ b/lisp/emacs-lisp/lisp-mode.el	Tue Jul 10 01:07:03 2007 +0000
@@ -730,7 +730,9 @@
 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.