From: Glenn Morris <rgm@gnu.org>
Date: Sat, 13 Dec 2008 04:12:08 +0000 (+0000)
Subject: (font-lock-defaults): Doc fix: mention levels; refer to elisp manual.
X-Git-Tag: emacs-pretest-23.0.90~1125
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=5ff602defb70acc4565a59e2a7d27427be92049e;p=emacs.git

(font-lock-defaults): Doc fix: mention levels; refer to elisp manual.
---

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 2a2f62c3c63..c1f23d1740c 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,8 @@
+2008-12-13  Glenn Morris  <rgm@gnu.org>
+
+	* font-core.el (font-lock-defaults): Doc fix: mention levels;
+	refer to elisp manual.
+
 2008-12-12  Martin Rudalics  <rudalics@gmx.at>
 
 	* window.el (fit-window-to-buffer): Return non-nil when height
diff --git a/lisp/font-core.el b/lisp/font-core.el
index b50509f04df..a45b298c606 100644
--- a/lisp/font-core.el
+++ b/lisp/font-core.el
@@ -32,10 +32,15 @@ Defaults should be of the form:
 
  (KEYWORDS [KEYWORDS-ONLY [CASE-FOLD [SYNTAX-ALIST [SYNTAX-BEGIN ...]]]])
 
-KEYWORDS may be a symbol (a variable or function whose value is the keywords to
-use for fontification) or a list of symbols.  If KEYWORDS-ONLY is non-nil,
-syntactic fontification (strings and comments) is not performed.
+KEYWORDS may be a symbol (a variable or function whose value is the keywords
+to use for fontification) or a list of symbols (specifying different levels
+of fontification).
+
+If KEYWORDS-ONLY is non-nil, syntactic fontification (strings and
+comments) is not performed.
+
 If CASE-FOLD is non-nil, the case of the keywords is ignored when fontifying.
+
 If SYNTAX-ALIST is non-nil, it should be a list of cons pairs of the form
 \(CHAR-OR-STRING . STRING) used to set the local Font Lock syntax table, for
 keyword and syntactic fontification (see `modify-syntax-entry').
@@ -48,6 +53,8 @@ be outside a syntactic block), or `beginning-of-defun' for programming modes or
 known to move outside a syntactic block).  If nil, the beginning of the buffer
 is used as a position outside of a syntactic block, in the worst case.
 
+\(See also Info node `(elisp)Font Lock Basics'.)
+
 These item elements are used by Font Lock mode to set the variables
 `font-lock-keywords', `font-lock-keywords-only',
 `font-lock-keywords-case-fold-search', `font-lock-syntax-table' and