[Emacs-diffs] emacs/doc/lispref ChangeLog modes.texi

[Glenn Morris]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Glenn Morris <gm>       08/12/13 04:11:03

Modified files:
        doc/lispref    : ChangeLog modes.texi 

Log message:
        (Font Lock Basics): Fix level description.  (Bug#1534)
        (Levels of Font Lock): Refer to font-lock-maximum-decoration.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/ChangeLog?cvsroot=emacs&r1=1.165&r2=1.166
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/modes.texi?cvsroot=emacs&r1=1.7&r2=1.8

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/ChangeLog,v
retrieving revision 1.165
retrieving revision 1.166
diff -u -b -r1.165 -r1.166
--- ChangeLog   12 Dec 2008 03:55:24 -0000      1.165
+++ ChangeLog   13 Dec 2008 04:11:03 -0000      1.166
@@ -1,3 +1,8 @@
+2008-12-13  Glenn Morris  <address@hidden>
+
+       * 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  <address@hidden>
 
        * debugging.texi (Error Debugging): Refer forwards to

Index: modes.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/modes.texi,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -b -r1.7 -r1.8
--- modes.texi  26 Nov 2008 16:11:58 -0000      1.7
+++ modes.texi  13 Dec 2008 04:11:03 -0000      1.8
@@ -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
address@hidden
+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: