# HG changeset patch
# User Lute Kamstra <lute@gnu.org>
# Date 1115715683 0
# Node ID 3eeb147cd9e0d22a2a8f5355f6a2940adaaf4c68
# Parent  50fda5cdcc5d751f81b105877c941f377e7d86fc
(font-lock-keywords-alist, font-lock-removed-keywords-alist): Clarify docstrings.

diff -r 50fda5cdcc5d -r 3eeb147cd9e0 lisp/font-lock.el
--- a/lisp/font-lock.el	Tue May 10 07:26:25 2005 +0000
+++ b/lisp/font-lock.el	Tue May 10 09:01:23 2005 +0000
@@ -470,12 +470,27 @@
 optimized.")
 
 (defvar font-lock-keywords-alist nil
-  "Alist of `font-lock-keywords' local to a `major-mode'.
+  "Alist of additional `font-lock-keywords' elements for major modes.
+
+Each element has the form (MODE KEYWORDS . APPEND).
+`font-lock-set-defaults' adds the elements in the list KEYWORDS to
+`font-lock-keywords' when Font Lock is turned on in major mode MODE.
+
+If APPEND is nil, KEYWORDS are added at the beginning of
+`font-lock-keywords'.  If it is `set', they are used to replace the
+value of `font-lock-keywords'.  If APPEND is any other non-nil value,
+they are added at the end.
+
 This is normally set via `font-lock-add-keywords' and
 `font-lock-remove-keywords'.")
 
 (defvar font-lock-removed-keywords-alist nil
-  "Alist of `font-lock-keywords' removed from `major-mode'.
+  "Alist of `font-lock-keywords' elements to be removed for major modes.
+
+Each element has the form (MODE . KEYWORDS).  `font-lock-set-defaults'
+removes the elements in the list KEYWORDS from `font-lock-keywords'
+when Font Lock is turned on in major mode MODE.
+
 This is normally set via `font-lock-add-keywords' and
 `font-lock-remove-keywords'.")