From: Glenn Morris Date: Sat, 20 Sep 2008 20:25:05 +0000 (+0000) Subject: (Defining Faces): Recommend against face variables. X-Git-Tag: emacs-pretest-23.0.90~2830 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=15688fceeb6b39830ab6bc761ad32678bf745e9e;p=emacs.git (Defining Faces): Recommend against face variables. --- diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 44da8528114..971ac598891 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,7 @@ +2008-09-20 Glenn Morris + + * display.texi (Defining Faces): Recommend against face variables. + 2008-09-16 Juanma Barranquero * display.texi (Echo Area Customization): Fix typo. 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},