summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorGlenn Morris <rgm@gnu.org>2008-09-20 20:24:57 +0000
committerGlenn Morris <rgm@gnu.org>2008-09-20 20:24:57 +0000
commitb5a61f59f15a68cb46a93476b364ed8b11d409c3 (patch)
tree2915e3387da60bd0d40c20e5c58f710af4a45518 /doc
parent39eb7f8623fe1c89c2174261ce3705f2fb88e22d (diff)
downloademacs-b5a61f59f15a68cb46a93476b364ed8b11d409c3.tar.gz
(Defining Faces): Recommend against face variables.
Diffstat (limited to 'doc')
-rw-r--r--doc/lispref/display.texi5
1 files changed, 5 insertions, 0 deletions
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 4e154f7f263..01e869234fb 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -1803,6 +1803,11 @@ kind of customization item (@pxref{Customization}) which the user can
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},