Mercurial > emacs
changeset 100386:fae812e295b4
(Font Lock Basics): Fix level description. (Bug#1534)
(Levels of Font Lock): Refer to font-lock-maximum-decoration.
| author | Glenn Morris <rgm@gnu.org> |
|---|---|
| date | Sat, 13 Dec 2008 04:11:03 +0000 |
| parents | 4504aa7cb434 |
| children | 35f1ab86f203 |
| files | doc/lispref/ChangeLog doc/lispref/modes.texi |
| diffstat | 2 files changed, 14 insertions(+), 5 deletions(-) [+] |
line wrap: on
line diff
--- a/doc/lispref/ChangeLog Sat Dec 13 03:29:47 2008 +0000 +++ b/doc/lispref/ChangeLog Sat Dec 13 04:11:03 2008 +0000 @@ -1,3 +1,8 @@ +2008-12-13 Glenn Morris <rgm@gnu.org> + + * modes.texi (Font Lock Basics): Fix level description. (Bug#1534) + (Levels of Font Lock): Refer to font-lock-maximum-decoration. + 2008-12-12 Glenn Morris <rgm@gnu.org> * debugging.texi (Error Debugging): Refer forwards to
--- a/doc/lispref/modes.texi Sat Dec 13 03:29:47 2008 +0000 +++ b/doc/lispref/modes.texi Sat Dec 13 04:11:03 2008 +0000 @@ -2429,8 +2429,11 @@ It can be a symbol, a variable or a function whose value is the list to use for @code{font-lock-keywords}. It can also be a list of several such symbols, one for each possible level of fontification. -The first symbol specifies how to do level 1 fontification, the second -symbol how to do level 2, and so on. @xref{Levels of Font Lock}. +The first symbol specifies the @samp{mode default} level of +fontification, the next symbol level 1 fontification, the next level 2, +and so on. The @samp{mode default} level is normally the same as level +1. It is used when @code{font-lock-maximum-decoration} has a @code{nil} +value. @xref{Levels of Font Lock}. The second element, @var{keywords-only}, specifies the value of the variable @code{font-lock-keywords-only}. If this is omitted or @@ -2854,9 +2857,10 @@ Many major modes offer three different levels of fontification. You can define multiple levels by using a list of symbols for @var{keywords} in @code{font-lock-defaults}. Each symbol specifies one level of -fontification; it is up to the user to choose one of these levels. The -chosen level's symbol value is used to initialize -@code{font-lock-keywords}. +fontification; it is up to the user to choose one of these levels, +normally by setting @code{font-lock-maximum-decoration} (@pxref{Font +Lock,,, emacs, the GNU Emacs Manual}). The chosen level's symbol +value is used to initialize @code{font-lock-keywords}. Here are the conventions for how to define the levels of fontification: