* font-lock.el (font-lock-maximum-decoration): Mention what numeric levels mean.

Fixes: debbugs:6935

2 files changed, 4 insertions, 0 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 3cc219a01d9..1edb18ecb4c 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,8 @@
 2011-07-14  Lars Magne Ingebrigtsen  <larsi@gnus.org>
 
+        * font-lock.el (font-lock-maximum-decoration): Mention what
+        numeric levels mean (bug#6935).
+
         * startup.el (initial-buffer-choice): Don't mention the `none'
         selection, which is against policy.
 
diff --git a/lisp/font-lock.el b/lisp/font-lock.el
index 6c76142c59d..6902ce98ab1 100644
--- a/lisp/font-lock.el
+++ b/lisp/font-lock.el
@@ -254,6 +254,7 @@ for buffers in Rmail mode, and size is irrelevant otherwise."
 If nil, use the default decoration (typically the minimum available).
 If t, use the maximum decoration available.
 If a number, use that level of decoration (or if not available the maximum).
+The higher the number, the more decoration is done.
 If a list, each element should be a cons pair of the form (MAJOR-MODE . LEVEL),
 where MAJOR-MODE is a symbol or t (meaning the default).  For example:
  ((c-mode . t) (c++-mode . 2) (t . 1))