(Defining Faces): Explain C-M-x feature for defface.

2 files changed, 9 insertions, 0 deletions

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index 39f35d78ac4..0bd727f0748 100644
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -1,3 +1,7 @@
+2007-07-10  Richard Stallman  <rms@gnu.org>
+
+        * display.texi (Defining Faces): Explain C-M-x feature for defface.
+
 2007-06-24  Karl Berry  <karl@tug.org>
 
         * elisp.texi, vol1.texi, vol2.texi: new Back-Cover Text.
diff --git a/lispref/display.texi b/lispref/display.texi
index f644a02c2eb..8cf25110308 100644
--- a/lispref/display.texi
+++ b/lispref/display.texi
@@ -1760,6 +1760,11 @@ When @code{defface} executes, it defines the face according to
 @var{spec}, then uses any customizations that were read from the
 init file (@pxref{Init File}) to override that specification.
 
+When you evaluate a @code{defcustom} form with @kbd{C-M-x} in Emacs
+Lisp mode (@code{eval-defun}), a special feature of @code{eval-defun}
+overrides any customizations of the face.  This way, the face reflects
+exactly what the @code{defcustom} says.
+
 The purpose of @var{spec} is to specify how the face should appear on
 different kinds of terminals.  It should be an alist whose elements
 have the form @code{(@var{display} @var{atts})}.  Each element's