# HG changeset patch
# User Glenn Morris <rgm@gnu.org>
# Date 1229141463 0
# Node ID fae812e295b4a46e06dd16fcf77f8eb00b875223
# Parent  4504aa7cb434a3bd6621b0c0d1aef16570cb94f2
(Font Lock Basics): Fix level description.  (Bug#1534)
(Levels of Font Lock): Refer to font-lock-maximum-decoration.

diff -r 4504aa7cb434 -r fae812e295b4 doc/lispref/ChangeLog
--- 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
diff -r 4504aa7cb434 -r fae812e295b4 doc/lispref/modes.texi
--- 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: