(Defining Faces): Recommend against face variables.

This commit is contained in:
Glenn Morris 2008-09-20 20:25:05 +00:00
parent 8230b7b3a1
commit 15688fceeb
2 changed files with 9 additions and 0 deletions

View file

@ -1,3 +1,7 @@
2008-09-20 Glenn Morris <rgm@gnu.org>
* display.texi (Defining Faces): Recommend against face variables.
2008-09-16 Juanma Barranquero <lekktu@gmail.com>
* display.texi (Echo Area Customization): Fix typo.

View file

@ -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},