From 15688fceeb6b39830ab6bc761ad32678bf745e9e Mon Sep 17 00:00:00 2001 From: Glenn Morris Date: Sat, 20 Sep 2008 20:25:05 +0000 Subject: [PATCH] (Defining Faces): Recommend against face variables. --- doc/lispref/ChangeLog | 4 ++++ doc/lispref/display.texi | 5 +++++ 2 files changed, 9 insertions(+) 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}, -- 2.39.5