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

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index 39f35d78ac48a1590eb3bb9db0a7650ae16ac215..0bd727f07487fa03f95f28b32a08c9fd3e2a6466 100644 (file)
--- 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 f644a02c2eb432d7063c759b3ba4ec44ae34b050..8cf25110308c8a33a3e03135a536abfa8763a20c 100644 (file)
--- 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