# HG changeset patch
# User Glenn Morris <rgm@gnu.org>
# Date 1221942297 0
# Node ID 559b4f23d84b76cd4db4fdc7ac6de64e5670dba9
# Parent  31ee18a10bb383709bf6a43e1e57adafdeb3a6bb
(Defining Faces): Recommend against face variables.

diff -r 31ee18a10bb3 -r 559b4f23d84b doc/lispref/display.texi
--- a/doc/lispref/display.texi	Sat Sep 20 20:16:29 2008 +0000
+++ b/doc/lispref/display.texi	Sat Sep 20 20:24:57 2008 +0000
@@ -1803,6 +1803,11 @@
 customize using the Customization buffer (@pxref{Easy Customization,,,
 emacs, The GNU Emacs Manual}).
 
+  People are sometimes tempted to create variables whose values specify
+which faces to use (for example, Font-Lock does this).  In the vast
+majority of cases, this is not necessary, and simply using faces
+directly is preferable.
+
 @defmac defface face spec doc [keyword value]@dots{}
 This declares @var{face} as a customizable face that defaults
 according to @var{spec}.  You should not quote the symbol @var{face},