From: Chong Yidong <cyd@stupidchicken.com>
Date: Fri, 20 Apr 2007 19:26:56 +0000 (+0000)
Subject: (Highlight Interactively): Document hi-lock-file-patterns-policy.
X-Git-Tag: emacs-pretest-22.0.99~137
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=bd68a445b3611efedfdb080c3ad75fb1e63a2220;p=emacs.git

(Highlight Interactively): Document hi-lock-file-patterns-policy.
---

diff --git a/man/display.texi b/man/display.texi
index a184f8b3db9..c0132da35d4 100644
--- a/man/display.texi
+++ b/man/display.texi
@@ -711,9 +711,16 @@ at point, with comment delimiters to prevent them from changing your
 program.  (This key binding runs the
 @code{hi-lock-write-interactive-patterns} command.)
 
-These patterns will be read the next time you visit the file while
+These patterns may be read the next time you visit the file while
 Hi Lock mode is enabled, or whenever you use the @kbd{M-x
-hi-lock-find-patterns} command.
+hi-lock-find-patterns} command. 
+
+Patterns are not read if the buffer's mode is listed in
+@code{hi-lock-exclude-modes}. Patterns are only used if
+@code{hi-lock-file-patterns-policy} is 'ask and the user responds yes
+to a prompt, or if @code{hi-lock-file-patterns-policy} is bound to a
+function and that function returns t. The function is called with the
+patterns as an argument.
 
 @item C-x w i
 @kindex C-x w i