Mercurial > emacs

changeset 98267:559b4f23d84b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
(Defining Faces): Recommend against face variables.
author Glenn Morris <rgm@gnu.org>
date Sat, 20 Sep 2008 20:24:57 +0000
parents 31ee18a10bb3
children 2e2d18ca9e6f
files doc/lispref/display.texi
diffstat 1 files changed, 5 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- 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},