From 65c96cc02598ded824a19e0c70d49d84d7fce9c7 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 18 Jun 2016 12:50:57 +0300 Subject: [PATCH] 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 8039291298c..56b643becf2 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))) -- 2.39.2