[Emacs-diffs] emacs-25 65c96cc: Clarify documentation of 'font-lock-maximum-decoration'

[Eli Zaretskii]

branch: emacs-25
commit 65c96cc02598ded824a19e0c70d49d84d7fce9c7
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Clarify documentation of 'font-lock-maximum-decoration'
    
    * doc/emacs/display.texi (Font Lock): Explain how to make the
    customization of 'font-lock-maximum-decoration' effective for an
    existing buffer.  (Bug#23783)
---
 doc/emacs/display.texi |   12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi
index 8039291..56b643b 100644
--- a/doc/emacs/display.texi
+++ b/doc/emacs/display.texi
@@ -847,9 +847,15 @@ to alter the amount of fontification applied by Font Lock 
mode, for
 major modes that support this feature.  The value should be a number
 (with 1 representing a minimal amount of fontification; some modes
 support levels as high as 3); or @code{t}, meaning ``as high as
-possible'' (the default).  You can also specify different numbers for
-particular major modes; for example, to use level 1 for C/C++ modes,
-and the default level otherwise, use the value
+possible'' (the default).  To be effective for a given file buffer,
+the customization of @code{font-lock-maximum-decoration} should be
+done @emph{before} the file is visited; if you already have the file
+visited in a buffer when you customize this variable, kill the buffer
+and visit the file again after the customization.
+
+You can also specify different numbers for particular major modes; for
+example, to use level 1 for C/C++ modes, and the default level
+otherwise, use the value
 
 @example
 '((c-mode . 1) (c++-mode . 1)))