procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

(Search-based Fontification): Explain that

Browse source 
facespec is an expression to be evaluated.
This commit is contained in:
Richard M. Stallman 2005-04-19 21:06:19 +00:00
parent 2cc604202a
commit ed35c7368c
2 changed files with 13 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
lispref/ChangeLog
View file

@ -1,3 +1,8 @@
2005-04-19 Richard M. Stallman <rms@gnu.org>
* modes.texi (Search-based Fontification): Explain that
facespec is an expression to be evaluated.
2005-04-19 Kevin Ryde <user42@zip.com.au>
* streams.texi (Output Functions): Fix xref.

13
lispref/modes.texi
View file

@ -2163,9 +2163,10 @@ If you use @code{regexp-opt} to produce the regular expression
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 @@ is a Lisp variable (a symbol), whose value should be a face name.
("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 @@ It has the form:
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},