# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 1113944760 0
# Node ID 3c8535295b32693fb4cc88edbd3496dd8e249994
# Parent  5d556f24030d9f56def83d54bfb041ac7945b9e9
(Search-based Fontification): Explain that
facespec is an expression to be evaluated.

diff -r 5d556f24030d -r 3c8535295b32 lispref/modes.texi
--- a/lispref/modes.texi	Tue Apr 19 20:33:27 2005 +0000
+++ b/lispref/modes.texi	Tue Apr 19 21:06:00 2005 +0000
@@ -2163,9 +2163,10 @@
 Functions}) to calculate the value for @var{subexp}.
 
 @item (@var{matcher} . @var{facespec})
-In this kind of element, @var{facespec} is an object which specifies
-the face variable to use for highlighting.  In the simplest case, it
-is a Lisp variable (a symbol), whose value should be a face name.
+In this kind of element, @var{facespec} is an expression whose value
+specifies the face to use for highlighting.  In the simplest case,
+@var{facespec} is a Lisp variable (a symbol) whose value is a face
+name.
 
 @example
 ;; @r{Highlight occurrences of @samp{fubar},}
@@ -2173,12 +2174,13 @@
 ("fubar" . fubar-face)
 @end example
 
-However, @var{facespec} can also be a list of the form:
+However, @var{facespec} can also evaluate to a list of this form:
 
 @example
 (face @var{face} @var{prop1} @var{val1} @var{prop2} @var{val2}@dots{})
 @end example
 
+@noindent
 to specify the face @var{face} and various additional text properties
 to put on the text that matches.  If you do this, be sure to add the
 other text property names that you set in this way to the value of
@@ -2198,7 +2200,8 @@
 
 The @sc{car}, @var{subexp}, is an integer specifying which subexpression
 of the match to fontify (0 means the entire matching text).  The second
-subelement, @var{facespec}, specifies the face, as described above.
+subelement, @var{facespec}, is an expression whose value specifies the
+face, as described above.
 
 The last two values in @var{subexp-highlighter}, @var{override} and
 @var{laxmatch}, are optional flags.  If @var{override} is @code{t},