Commit | Line | Data |
---|---|---|
e8af40ee | 1 | ;;; hi-lock.el --- minor mode for interactive automatic highlighting |
abb2db1c | 2 | |
0d30b337 | 3 | ;; Copyright (C) 2000, 2001, 2002, 2003, 2004, |
409cc4a3 | 4 | ;; 2005, 2006, 2007, 2008 Free Software Foundation, Inc. |
abb2db1c | 5 | |
c898bef7 | 6 | ;; Author: David M. Koppelman, koppel@ece.lsu.edu |
abb2db1c GM |
7 | ;; Keywords: faces, minor-mode, matching, display |
8 | ||
9 | ;; This file is part of GNU Emacs. | |
10 | ||
11 | ;; GNU Emacs is free software; you can redistribute it and/or modify | |
12 | ;; it under the terms of the GNU General Public License as published by | |
b4aa6026 | 13 | ;; the Free Software Foundation; either version 3, or (at your option) |
abb2db1c GM |
14 | ;; any later version. |
15 | ||
16 | ;; GNU Emacs is distributed in the hope that it will be useful, | |
17 | ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
18 | ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
19 | ;; GNU General Public License for more details. | |
20 | ||
21 | ;; You should have received a copy of the GNU General Public License | |
22 | ;; along with GNU Emacs; see the file COPYING. If not, write to the | |
086add15 LK |
23 | ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
24 | ;; Boston, MA 02110-1301, USA. | |
abb2db1c | 25 | |
e8af40ee | 26 | ;;; Commentary: |
71296446 | 27 | ;; |
abb2db1c GM |
28 | ;; With the hi-lock commands text matching interactively entered |
29 | ;; regexp's can be highlighted. For example, `M-x highlight-regexp | |
30 | ;; RET clearly RET RET' will highlight all occurrences of `clearly' | |
31 | ;; using a yellow background face. New occurrences of `clearly' will | |
32 | ;; be highlighted as they are typed. `M-x unhighlight-regexp RET' | |
33 | ;; will remove the highlighting. Any existing face can be used for | |
34 | ;; highlighting and a set of appropriate faces is provided. The | |
35 | ;; regexps can be written into the current buffer in a form that will | |
c898bef7 CY |
36 | ;; be recognized the next time the corresponding file is read (when |
37 | ;; file patterns is turned on). | |
abb2db1c GM |
38 | ;; |
39 | ;; Applications: | |
40 | ;; | |
41 | ;; In program source code highlight a variable to quickly see all | |
42 | ;; places it is modified or referenced: | |
43 | ;; M-x highlight-regexp ground_contact_switches_closed RET RET | |
44 | ;; | |
45 | ;; In a shell or other buffer that is showing lots of program | |
46 | ;; output, highlight the parts of the output you're interested in: | |
47 | ;; M-x highlight-regexp Total execution time [0-9]+ RET hi-blue-b RET | |
48 | ;; | |
49 | ;; In buffers displaying tables, highlight the lines you're interested in: | |
50 | ;; M-x highlight-lines-matching-regexp January 2000 RET hi-black-b RET | |
51 | ;; | |
52 | ;; When writing text, highlight personal cliches. This can be | |
53 | ;; amusing. | |
108ee42b | 54 | ;; M-x highlight-phrase as can be seen RET RET |
abb2db1c | 55 | ;; |
108ee42b | 56 | ;; Setup: |
abb2db1c GM |
57 | ;; |
58 | ;; Put the following code in your .emacs file. This turns on | |
108ee42b | 59 | ;; hi-lock mode and adds a "Regexp Highlighting" entry |
abb2db1c GM |
60 | ;; to the edit menu. |
61 | ;; | |
71060bdd | 62 | ;; (global-hi-lock-mode 1) |
71296446 | 63 | ;; |
c898bef7 CY |
64 | ;; To enable the use of patterns found in files (presumably placed |
65 | ;; there by hi-lock) include the following in your .emacs file: | |
66 | ;; | |
67 | ;; (setq hi-lock-file-patterns-policy 'ask) | |
68 | ;; | |
69 | ;; If you get tired of being asked each time a file is loaded replace | |
06b1a5ef | 70 | ;; `ask' with a function that returns t if patterns should be read. |
c898bef7 | 71 | ;; |
abb2db1c GM |
72 | ;; You might also want to bind the hi-lock commands to more |
73 | ;; finger-friendly sequences: | |
74 | ||
75 | ;; (define-key hi-lock-map "\C-z\C-h" 'highlight-lines-matching-regexp) | |
76 | ;; (define-key hi-lock-map "\C-zi" 'hi-lock-find-patterns) | |
77 | ;; (define-key hi-lock-map "\C-zh" 'highlight-regexp) | |
108ee42b | 78 | ;; (define-key hi-lock-map "\C-zp" 'highlight-phrase) |
abb2db1c GM |
79 | ;; (define-key hi-lock-map "\C-zr" 'unhighlight-regexp) |
80 | ;; (define-key hi-lock-map "\C-zb" 'hi-lock-write-interactive-patterns)) | |
81 | ||
82 | ;; See the documentation for hi-lock-mode `C-h f hi-lock-mode' for | |
83 | ;; additional instructions. | |
84 | ||
85 | ;; Sample file patterns: | |
86 | ||
87 | ; Hi-lock: (("^;;; .*" (0 (quote hi-black-hb) t))) | |
88 | ; Hi-lock: ( ("make-variable-buffer-\\(local\\)" (0 font-lock-keyword-face)(1 'italic append))))) | |
89 | ; Hi-lock: end | |
90 | ||
91 | ;;; Code: | |
92 | ||
588aca27 | 93 | (eval-and-compile |
abb2db1c GM |
94 | (require 'font-lock)) |
95 | ||
f43eaaef | 96 | (defgroup hi-lock nil |
abb2db1c | 97 | "Interactively add and remove font-lock patterns for highlighting text." |
f43eaaef JL |
98 | :link '(custom-manual "(emacs)Highlight Interactively") |
99 | :group 'font-lock) | |
abb2db1c | 100 | |
abb2db1c GM |
101 | (defcustom hi-lock-file-patterns-range 10000 |
102 | "Limit of search in a buffer for hi-lock patterns. | |
8b730780 | 103 | When a file is visited and hi-lock mode is on, patterns starting |
abb2db1c GM |
104 | up to this limit are added to font-lock's patterns. See documentation |
105 | of functions `hi-lock-mode' and `hi-lock-find-patterns'." | |
106 | :type 'integer | |
f43eaaef | 107 | :group 'hi-lock) |
abb2db1c | 108 | |
81dc5714 JL |
109 | (defcustom hi-lock-highlight-range 200000 |
110 | "Size of area highlighted by hi-lock when font-lock not active. | |
111 | Font-lock is not active in buffers that do their own highlighting, | |
112 | such as the buffer created by `list-colors-display'. In those buffers | |
113 | hi-lock patterns will only be applied over a range of | |
114 | `hi-lock-highlight-range' characters. If font-lock is active then | |
115 | highlighting will be applied throughout the buffer." | |
116 | :type 'integer | |
117 | :group 'hi-lock) | |
118 | ||
abb2db1c GM |
119 | (defcustom hi-lock-exclude-modes |
120 | '(rmail-mode mime/viewer-mode gnus-article-mode) | |
121 | "List of major modes in which hi-lock will not run. | |
122 | For security reasons since font lock patterns can specify function | |
123 | calls." | |
f5bd8092 | 124 | :type '(repeat symbol) |
f43eaaef | 125 | :group 'hi-lock) |
abb2db1c | 126 | |
cf995676 | 127 | (defcustom hi-lock-file-patterns-policy 'ask |
c898bef7 | 128 | "Specify when hi-lock should use patterns found in file. |
06b1a5ef | 129 | If `ask', prompt when patterns found in buffer; if bound to a function, |
c898bef7 | 130 | use patterns when function returns t (function is called with patterns |
06b1a5ef | 131 | as first argument); if nil or `never' or anything else, don't use file |
176eb1f1 GM |
132 | patterns." |
133 | :type '(choice (const :tag "Do not use file patterns" never) | |
134 | (const :tag "Ask about file patterns" ask) | |
135 | (function :tag "Function to check file patterns")) | |
136 | :group 'hi-lock | |
137 | :version "22.1") | |
138 | ||
139 | ;; It can have a function value. | |
140 | (put 'hi-lock-file-patterns-policy 'risky-local-variable t) | |
abb2db1c GM |
141 | |
142 | (defgroup hi-lock-faces nil | |
143 | "Faces for hi-lock." | |
f43eaaef JL |
144 | :group 'hi-lock |
145 | :group 'faces) | |
abb2db1c GM |
146 | |
147 | (defface hi-yellow | |
e0d815a2 | 148 | '((((min-colors 88) (background dark)) |
ea81d57e DN |
149 | (:background "yellow1" :foreground "black")) |
150 | (((background dark)) (:background "yellow" :foreground "black")) | |
151 | (((min-colors 88)) (:background "yellow1")) | |
a0b8c939 | 152 | (t (:background "yellow"))) |
abb2db1c GM |
153 | "Default face for hi-lock mode." |
154 | :group 'hi-lock-faces) | |
155 | ||
156 | (defface hi-pink | |
16cdf141 | 157 | '((((background dark)) (:background "pink" :foreground "black")) |
a0b8c939 | 158 | (t (:background "pink"))) |
abb2db1c GM |
159 | "Face for hi-lock mode." |
160 | :group 'hi-lock-faces) | |
161 | ||
162 | (defface hi-green | |
e0d815a2 | 163 | '((((min-colors 88) (background dark)) |
ea81d57e DN |
164 | (:background "green1" :foreground "black")) |
165 | (((background dark)) (:background "green" :foreground "black")) | |
e0d815a2 | 166 | (((min-colors 88)) (:background "green1")) |
a0b8c939 | 167 | (t (:background "green"))) |
abb2db1c GM |
168 | "Face for hi-lock mode." |
169 | :group 'hi-lock-faces) | |
170 | ||
171 | (defface hi-blue | |
16cdf141 | 172 | '((((background dark)) (:background "light blue" :foreground "black")) |
a0b8c939 | 173 | (t (:background "light blue"))) |
abb2db1c GM |
174 | "Face for hi-lock mode." |
175 | :group 'hi-lock-faces) | |
176 | ||
177 | (defface hi-black-b | |
178 | '((t (:weight bold))) | |
179 | "Face for hi-lock mode." | |
180 | :group 'hi-lock-faces) | |
181 | ||
182 | (defface hi-blue-b | |
ea81d57e DN |
183 | '((((min-colors 88)) (:weight bold :foreground "blue1")) |
184 | (t (:weight bold :foreground "blue"))) | |
abb2db1c GM |
185 | "Face for hi-lock mode." |
186 | :group 'hi-lock-faces) | |
187 | ||
188 | (defface hi-green-b | |
ea81d57e DN |
189 | '((((min-colors 88)) (:weight bold :foreground "green1")) |
190 | (t (:weight bold :foreground "green"))) | |
abb2db1c GM |
191 | "Face for hi-lock mode." |
192 | :group 'hi-lock-faces) | |
193 | ||
194 | (defface hi-red-b | |
ea81d57e DN |
195 | '((((min-colors 88)) (:weight bold :foreground "red1")) |
196 | (t (:weight bold :foreground "red"))) | |
abb2db1c GM |
197 | "Face for hi-lock mode." |
198 | :group 'hi-lock-faces) | |
199 | ||
200 | (defface hi-black-hb | |
c3b27206 | 201 | '((t (:weight bold :height 1.67 :inherit variable-pitch))) |
abb2db1c GM |
202 | "Face for hi-lock mode." |
203 | :group 'hi-lock-faces) | |
204 | ||
205 | (defvar hi-lock-file-patterns nil | |
206 | "Patterns found in file for hi-lock. Should not be changed.") | |
207 | ||
208 | (defvar hi-lock-interactive-patterns nil | |
209 | "Patterns provided to hi-lock by user. Should not be changed.") | |
210 | ||
211 | (defvar hi-lock-face-history | |
212 | (list "hi-yellow" "hi-pink" "hi-green" "hi-blue" "hi-black-b" | |
213 | "hi-blue-b" "hi-red-b" "hi-green-b" "hi-black-hb") | |
214 | "History list of faces for hi-lock interactive functions.") | |
215 | ||
216 | ;(dolist (f hi-lock-face-history) (unless (facep f) (error "%s not a face" f))) | |
217 | ||
218 | (defvar hi-lock-regexp-history nil | |
219 | "History of regexps used for interactive fontification.") | |
220 | ||
221 | (defvar hi-lock-file-patterns-prefix "Hi-lock" | |
c898bef7 | 222 | "Search target for finding hi-lock patterns at top of file.") |
abb2db1c | 223 | |
71060bdd | 224 | (defvar hi-lock-archaic-interface-message-used nil |
90756087 | 225 | "True if user alerted that `global-hi-lock-mode' is now the global switch. |
8b730780 | 226 | Earlier versions of hi-lock used `hi-lock-mode' as the global switch; |
90756087 | 227 | the message is issued if it appears that `hi-lock-mode' is used assuming |
71060bdd EZ |
228 | that older functionality. This variable avoids multiple reminders.") |
229 | ||
230 | (defvar hi-lock-archaic-interface-deduce nil | |
90756087 JL |
231 | "If non-nil, sometimes assume that `hi-lock-mode' means `global-hi-lock-mode'. |
232 | Assumption is made if `hi-lock-mode' used in the *scratch* buffer while | |
71060bdd EZ |
233 | a library is being loaded.") |
234 | ||
abb2db1c GM |
235 | (make-variable-buffer-local 'hi-lock-interactive-patterns) |
236 | (put 'hi-lock-interactive-patterns 'permanent-local t) | |
237 | (make-variable-buffer-local 'hi-lock-regexp-history) | |
238 | (put 'hi-lock-regexp-history 'permanent-local t) | |
239 | (make-variable-buffer-local 'hi-lock-file-patterns) | |
240 | (put 'hi-lock-file-patterns 'permanent-local t) | |
241 | ||
242 | (defvar hi-lock-menu (make-sparse-keymap "Hi Lock") | |
243 | "Menu for hi-lock mode.") | |
244 | ||
245 | (define-key-after hi-lock-menu [highlight-regexp] | |
246 | '(menu-item "Highlight Regexp..." highlight-regexp | |
247 | :help "Highlight text matching PATTERN (a regexp).")) | |
248 | ||
108ee42b GM |
249 | (define-key-after hi-lock-menu [highlight-phrase] |
250 | '(menu-item "Highlight Phrase..." highlight-phrase | |
251 | :help "Highlight text matching PATTERN (a regexp processed to match phrases).")) | |
252 | ||
abb2db1c GM |
253 | (define-key-after hi-lock-menu [highlight-lines-matching-regexp] |
254 | '(menu-item "Highlight Lines..." highlight-lines-matching-regexp | |
255 | :help "Highlight lines containing match of PATTERN (a regexp)..")) | |
256 | ||
257 | (define-key-after hi-lock-menu [unhighlight-regexp] | |
258 | '(menu-item "Remove Highlighting..." unhighlight-regexp | |
259 | :help "Remove previously entered highlighting pattern." | |
260 | :enable hi-lock-interactive-patterns)) | |
261 | ||
262 | (define-key-after hi-lock-menu [hi-lock-write-interactive-patterns] | |
263 | '(menu-item "Patterns to Buffer" hi-lock-write-interactive-patterns | |
264 | :help "Insert interactively added REGEXPs into buffer at point." | |
265 | :enable hi-lock-interactive-patterns)) | |
266 | ||
267 | (define-key-after hi-lock-menu [hi-lock-find-patterns] | |
268 | '(menu-item "Patterns from Buffer" hi-lock-find-patterns | |
269 | :help "Use patterns (if any) near top of buffer.")) | |
270 | ||
271 | (defvar hi-lock-map (make-sparse-keymap "Hi Lock") | |
272 | "Key map for hi-lock.") | |
273 | ||
274 | (define-key hi-lock-map "\C-xwi" 'hi-lock-find-patterns) | |
275 | (define-key hi-lock-map "\C-xwl" 'highlight-lines-matching-regexp) | |
108ee42b | 276 | (define-key hi-lock-map "\C-xwp" 'highlight-phrase) |
abb2db1c GM |
277 | (define-key hi-lock-map "\C-xwh" 'highlight-regexp) |
278 | (define-key hi-lock-map "\C-xwr" 'unhighlight-regexp) | |
279 | (define-key hi-lock-map "\C-xwb" 'hi-lock-write-interactive-patterns) | |
280 | ||
abb2db1c GM |
281 | ;; Visible Functions |
282 | ||
abb2db1c | 283 | ;;;###autoload |
71060bdd | 284 | (define-minor-mode hi-lock-mode |
abb2db1c GM |
285 | "Toggle minor mode for interactively adding font-lock highlighting patterns. |
286 | ||
90756087 JL |
287 | If ARG positive, turn hi-lock on. Issuing a hi-lock command will also |
288 | turn hi-lock on. To turn hi-lock on in all buffers use | |
289 | `global-hi-lock-mode' or in your .emacs file (global-hi-lock-mode 1). | |
71060bdd EZ |
290 | When hi-lock is turned on, a \"Regexp Highlighting\" submenu is added |
291 | to the \"Edit\" menu. The commands in the submenu, which can be | |
292 | called interactively, are: | |
abb2db1c GM |
293 | |
294 | \\[highlight-regexp] REGEXP FACE | |
295 | Highlight matches of pattern REGEXP in current buffer with FACE. | |
296 | ||
108ee42b GM |
297 | \\[highlight-phrase] PHRASE FACE |
298 | Highlight matches of phrase PHRASE in current buffer with FACE. | |
299 | (PHRASE can be any REGEXP, but spaces will be replaced by matches | |
300 | to whitespace and initial lower-case letters will become case insensitive.) | |
71296446 | 301 | |
abb2db1c GM |
302 | \\[highlight-lines-matching-regexp] REGEXP FACE |
303 | Highlight lines containing matches of REGEXP in current buffer with FACE. | |
304 | ||
305 | \\[unhighlight-regexp] REGEXP | |
306 | Remove highlighting on matches of REGEXP in current buffer. | |
307 | ||
308 | \\[hi-lock-write-interactive-patterns] | |
c898bef7 | 309 | Write active REGEXPs into buffer as comments (if possible). They may |
abb2db1c GM |
310 | be read the next time file is loaded or when the \\[hi-lock-find-patterns] command |
311 | is issued. The inserted regexps are in the form of font lock keywords. | |
ee44464c | 312 | (See `font-lock-keywords'.) They may be edited and re-loaded with \\[hi-lock-find-patterns], |
869d3e17 JB |
313 | any valid `font-lock-keywords' form is acceptable. When a file is |
314 | loaded the patterns are read if `hi-lock-file-patterns-policy' is | |
c898bef7 CY |
315 | 'ask and the user responds y to the prompt, or if |
316 | `hi-lock-file-patterns-policy' is bound to a function and that | |
317 | function returns t. | |
abb2db1c GM |
318 | |
319 | \\[hi-lock-find-patterns] | |
320 | Re-read patterns stored in buffer (in the format produced by \\[hi-lock-write-interactive-patterns]). | |
321 | ||
c898bef7 CY |
322 | When hi-lock is started and if the mode is not excluded or patterns |
323 | rejected, the beginning of the buffer is searched for lines of the | |
324 | form: | |
abb2db1c | 325 | Hi-lock: FOO |
8b730780 JB |
326 | where FOO is a list of patterns. These are added to the font lock |
327 | keywords already present. The patterns must start before position | |
328 | \(number of characters into buffer) `hi-lock-file-patterns-range'. | |
329 | Patterns will be read until | |
abb2db1c | 330 | Hi-lock: end |
8b730780 | 331 | is found. A mode is excluded if it's in the list `hi-lock-exclude-modes'." |
963b2040 | 332 | :group 'hi-lock |
90756087 JL |
333 | :lighter (:eval (if (or hi-lock-interactive-patterns |
334 | hi-lock-file-patterns) | |
335 | " Hi" "")) | |
963b2040 CY |
336 | :global nil |
337 | :keymap hi-lock-map | |
71060bdd EZ |
338 | (when (and (equal (buffer-name) "*scratch*") |
339 | load-in-progress | |
340 | (not (interactive-p)) | |
341 | (not hi-lock-archaic-interface-message-used)) | |
342 | (setq hi-lock-archaic-interface-message-used t) | |
343 | (if hi-lock-archaic-interface-deduce | |
344 | (global-hi-lock-mode hi-lock-mode) | |
345 | (warn | |
346 | "Possible archaic use of (hi-lock-mode). | |
347 | Use (global-hi-lock-mode 1) in .emacs to enable hi-lock for all buffers, | |
90756087 | 348 | use (hi-lock-mode 1) for individual buffers. For compatibility with Emacs |
71060bdd EZ |
349 | versions before 22 use the following in your .emacs file: |
350 | ||
351 | (if (functionp 'global-hi-lock-mode) | |
352 | (global-hi-lock-mode 1) | |
353 | (hi-lock-mode 1)) | |
354 | "))) | |
355 | (if hi-lock-mode | |
963b2040 CY |
356 | ;; Turned on. |
357 | (progn | |
e4d59066 | 358 | (unless font-lock-mode (font-lock-mode 1)) |
963b2040 CY |
359 | (define-key-after menu-bar-edit-menu [hi-lock] |
360 | (cons "Regexp Highlighting" hi-lock-menu)) | |
361 | (hi-lock-find-patterns) | |
e4d59066 | 362 | (add-hook 'font-lock-mode-hook 'hi-lock-font-lock-hook nil t)) |
abb2db1c | 363 | ;; Turned off. |
e4d59066 CY |
364 | (when (or hi-lock-interactive-patterns |
365 | hi-lock-file-patterns) | |
71060bdd | 366 | (when hi-lock-interactive-patterns |
e4d59066 CY |
367 | (font-lock-remove-keywords nil hi-lock-interactive-patterns) |
368 | (setq hi-lock-interactive-patterns nil)) | |
369 | (when hi-lock-file-patterns | |
370 | (font-lock-remove-keywords nil hi-lock-file-patterns) | |
371 | (setq hi-lock-file-patterns nil)) | |
81dc5714 JL |
372 | (remove-overlays nil nil 'hi-lock-overlay t) |
373 | (when font-lock-fontified (font-lock-fontify-buffer))) | |
963b2040 CY |
374 | (define-key-after menu-bar-edit-menu [hi-lock] nil) |
375 | (remove-hook 'font-lock-mode-hook 'hi-lock-font-lock-hook t))) | |
abb2db1c | 376 | |
963b2040 | 377 | ;;;###autoload |
98007d83 | 378 | (define-globalized-minor-mode global-hi-lock-mode |
71060bdd | 379 | hi-lock-mode turn-on-hi-lock-if-enabled |
9cb4bb45 | 380 | :group 'hi-lock) |
71060bdd | 381 | |
963b2040 | 382 | (defun turn-on-hi-lock-if-enabled () |
71060bdd | 383 | (setq hi-lock-archaic-interface-message-used t) |
963b2040 | 384 | (unless (memq major-mode hi-lock-exclude-modes) |
71060bdd | 385 | (hi-lock-mode 1))) |
abb2db1c GM |
386 | |
387 | ;;;###autoload | |
388 | (defalias 'highlight-lines-matching-regexp 'hi-lock-line-face-buffer) | |
389 | ;;;###autoload | |
390 | (defun hi-lock-line-face-buffer (regexp &optional face) | |
108ee42b | 391 | "Set face of all lines containing a match of REGEXP to FACE. |
abb2db1c GM |
392 | |
393 | Interactively, prompt for REGEXP then FACE. Buffer-local history | |
394 | list maintained for regexps, global history maintained for faces. | |
395 | \\<minibuffer-local-map>Use \\[next-history-element] and \\[previous-history-element] to retrieve next or previous history item. | |
8b730780 | 396 | \(See info node `Minibuffer History'.)" |
abb2db1c GM |
397 | (interactive |
398 | (list | |
399 | (hi-lock-regexp-okay | |
400 | (read-from-minibuffer "Regexp to highlight line: " | |
401 | (cons (or (car hi-lock-regexp-history) "") 1 ) | |
402 | nil nil 'hi-lock-regexp-history)) | |
403 | (hi-lock-read-face-name))) | |
597767da | 404 | (or (facep face) (setq face 'hi-yellow)) |
71060bdd | 405 | (unless hi-lock-mode (hi-lock-mode 1)) |
abb2db1c | 406 | (hi-lock-set-pattern |
b18f5523 SM |
407 | ;; The \\(?:...\\) grouping construct ensures that a leading ^, +, * or ? |
408 | ;; or a trailing $ in REGEXP will be interpreted correctly. | |
963b2040 | 409 | (concat "^.*\\(?:" regexp "\\).*$") face)) |
abb2db1c | 410 | |
108ee42b | 411 | |
abb2db1c GM |
412 | ;;;###autoload |
413 | (defalias 'highlight-regexp 'hi-lock-face-buffer) | |
414 | ;;;###autoload | |
415 | (defun hi-lock-face-buffer (regexp &optional face) | |
108ee42b | 416 | "Set face of each match of REGEXP to FACE. |
abb2db1c GM |
417 | |
418 | Interactively, prompt for REGEXP then FACE. Buffer-local history | |
419 | list maintained for regexps, global history maintained for faces. | |
420 | \\<minibuffer-local-map>Use \\[next-history-element] and \\[previous-history-element] to retrieve next or previous history item. | |
8b730780 | 421 | \(See info node `Minibuffer History'.)" |
abb2db1c GM |
422 | (interactive |
423 | (list | |
424 | (hi-lock-regexp-okay | |
425 | (read-from-minibuffer "Regexp to highlight: " | |
426 | (cons (or (car hi-lock-regexp-history) "") 1 ) | |
427 | nil nil 'hi-lock-regexp-history)) | |
428 | (hi-lock-read-face-name))) | |
597767da | 429 | (or (facep face) (setq face 'hi-yellow)) |
71060bdd | 430 | (unless hi-lock-mode (hi-lock-mode 1)) |
963b2040 | 431 | (hi-lock-set-pattern regexp face)) |
abb2db1c | 432 | |
108ee42b GM |
433 | ;;;###autoload |
434 | (defalias 'highlight-phrase 'hi-lock-face-phrase-buffer) | |
435 | ;;;###autoload | |
436 | (defun hi-lock-face-phrase-buffer (regexp &optional face) | |
437 | "Set face of each match of phrase REGEXP to FACE. | |
438 | ||
439 | Whitespace in REGEXP converted to arbitrary whitespace and initial | |
440 | lower-case letters made case insensitive." | |
441 | (interactive | |
442 | (list | |
443 | (hi-lock-regexp-okay | |
444 | (hi-lock-process-phrase | |
445 | (read-from-minibuffer "Phrase to highlight: " | |
446 | (cons (or (car hi-lock-regexp-history) "") 1 ) | |
447 | nil nil 'hi-lock-regexp-history))) | |
448 | (hi-lock-read-face-name))) | |
597767da | 449 | (or (facep face) (setq face 'hi-yellow)) |
71060bdd | 450 | (unless hi-lock-mode (hi-lock-mode 1)) |
963b2040 | 451 | (hi-lock-set-pattern regexp face)) |
108ee42b | 452 | |
abb2db1c GM |
453 | ;;;###autoload |
454 | (defalias 'unhighlight-regexp 'hi-lock-unface-buffer) | |
455 | ;;;###autoload | |
456 | (defun hi-lock-unface-buffer (regexp) | |
108ee42b | 457 | "Remove highlighting of each match to REGEXP set by hi-lock. |
abb2db1c GM |
458 | |
459 | Interactively, prompt for REGEXP. Buffer-local history of inserted | |
460 | regexp's maintained. Will accept only regexps inserted by hi-lock | |
108ee42b | 461 | interactive functions. \(See `hi-lock-interactive-patterns'.\) |
abb2db1c | 462 | \\<minibuffer-local-must-match-map>Use \\[minibuffer-complete] to complete a partially typed regexp. |
cf667bc5 | 463 | \(See info node `Minibuffer History'.\)" |
abb2db1c | 464 | (interactive |
a2ab90da | 465 | (if (and (display-popup-menus-p) (not last-nonmenu-event)) |
cf667bc5 EZ |
466 | (catch 'snafu |
467 | (or | |
468 | (x-popup-menu | |
469 | t | |
470 | (cons | |
471 | `keymap | |
472 | (cons "Select Pattern to Unhighlight" | |
473 | (mapcar (lambda (pattern) | |
474 | (list (car pattern) | |
475 | (format | |
476 | "%s (%s)" (car pattern) | |
477 | (symbol-name | |
478 | (car | |
479 | (cdr (car (cdr (car (cdr pattern)))))))) | |
480 | (cons nil nil) | |
481 | (car pattern))) | |
482 | hi-lock-interactive-patterns)))) | |
483 | ;; If the user clicks outside the menu, meaning that they | |
484 | ;; change their mind, x-popup-menu returns nil, and | |
485 | ;; interactive signals a wrong number of arguments error. | |
486 | ;; To prevent that, we return an empty string, which will | |
487 | ;; effectively disable the rest of the function. | |
488 | (throw 'snafu '("")))) | |
abb2db1c GM |
489 | (let ((history-list (mapcar (lambda (p) (car p)) |
490 | hi-lock-interactive-patterns))) | |
491 | (unless hi-lock-interactive-patterns | |
492 | (error "No highlighting to remove")) | |
493 | (list | |
494 | (completing-read "Regexp to unhighlight: " | |
932c309e | 495 | hi-lock-interactive-patterns nil t |
abb2db1c GM |
496 | (car (car hi-lock-interactive-patterns)) |
497 | (cons 'history-list 1)))))) | |
498 | (let ((keyword (assoc regexp hi-lock-interactive-patterns))) | |
499 | (when keyword | |
500 | (font-lock-remove-keywords nil (list keyword)) | |
501 | (setq hi-lock-interactive-patterns | |
502 | (delq keyword hi-lock-interactive-patterns)) | |
81dc5714 JL |
503 | (remove-overlays |
504 | nil nil 'hi-lock-overlay-regexp (hi-lock-string-serialize regexp)) | |
505 | (when font-lock-fontified (font-lock-fontify-buffer))))) | |
abb2db1c GM |
506 | |
507 | ;;;###autoload | |
508 | (defun hi-lock-write-interactive-patterns () | |
509 | "Write interactively added patterns, if any, into buffer at point. | |
510 | ||
511 | Interactively added patterns are those normally specified using | |
512 | `highlight-regexp' and `highlight-lines-matching-regexp'; they can | |
513 | be found in variable `hi-lock-interactive-patterns'." | |
514 | (interactive) | |
597767da CY |
515 | (if (null hi-lock-interactive-patterns) |
516 | (error "There are no interactive patterns")) | |
517 | (let ((beg (point))) | |
ee44464c | 518 | (mapc |
abb2db1c | 519 | (lambda (pattern) |
90756087 JL |
520 | (insert (format "%s: (%s)\n" |
521 | hi-lock-file-patterns-prefix | |
522 | (prin1-to-string pattern)))) | |
597767da CY |
523 | hi-lock-interactive-patterns) |
524 | (comment-region beg (point))) | |
525 | (when (> (point) hi-lock-file-patterns-range) | |
526 | (warn "Inserted keywords not close enough to top of file"))) | |
abb2db1c GM |
527 | |
528 | ;; Implementation Functions | |
529 | ||
108ee42b GM |
530 | (defun hi-lock-process-phrase (phrase) |
531 | "Convert regexp PHRASE to a regexp that matches phrases. | |
532 | ||
533 | Blanks in PHRASE replaced by regexp that matches arbitrary whitespace | |
534 | and initial lower-case letters made case insensitive." | |
535 | (let ((mod-phrase nil)) | |
536 | (setq mod-phrase | |
537 | (replace-regexp-in-string | |
538 | "\\<[a-z]" (lambda (m) (format "[%s%s]" (upcase m) m)) phrase)) | |
539 | (setq mod-phrase | |
540 | (replace-regexp-in-string | |
541 | "\\s-+" "[ \t\n]+" mod-phrase nil t)))) | |
542 | ||
abb2db1c GM |
543 | (defun hi-lock-regexp-okay (regexp) |
544 | "Return REGEXP if it appears suitable for a font-lock pattern. | |
545 | ||
546 | Otherwise signal an error. A pattern that matches the null string is | |
547 | not suitable." | |
548 | (if (string-match regexp "") | |
549 | (error "Regexp cannot match an empty string") | |
550 | regexp)) | |
551 | ||
552 | (defun hi-lock-read-face-name () | |
553 | "Read face name from minibuffer with completion and history." | |
554 | (intern (completing-read | |
555 | "Highlight using face: " | |
556 | obarray 'facep t | |
557 | (cons (car hi-lock-face-history) | |
558 | (let ((prefix | |
559 | (try-completion | |
560 | (substring (car hi-lock-face-history) 0 1) | |
561 | (mapcar (lambda (f) (cons f f)) | |
562 | hi-lock-face-history)))) | |
563 | (if (and (stringp prefix) | |
564 | (not (equal prefix (car hi-lock-face-history)))) | |
565 | (length prefix) 0))) | |
566 | '(hi-lock-face-history . 0)))) | |
567 | ||
963b2040 CY |
568 | (defun hi-lock-set-pattern (regexp face) |
569 | "Highlight REGEXP with face FACE." | |
570 | (let ((pattern (list regexp (list 0 (list 'quote face) t)))) | |
abb2db1c | 571 | (unless (member pattern hi-lock-interactive-patterns) |
90756087 | 572 | (font-lock-add-keywords nil (list pattern) t) |
963b2040 | 573 | (push pattern hi-lock-interactive-patterns) |
81dc5714 JL |
574 | (if font-lock-fontified |
575 | (font-lock-fontify-buffer) | |
576 | (let* ((serial (hi-lock-string-serialize regexp)) | |
577 | (range-min (- (point) (/ hi-lock-highlight-range 2))) | |
578 | (range-max (+ (point) (/ hi-lock-highlight-range 2))) | |
579 | (search-start | |
580 | (max (point-min) | |
581 | (- range-min (max 0 (- range-max (point-max)))))) | |
582 | (search-end | |
583 | (min (point-max) | |
584 | (+ range-max (max 0 (- (point-min) range-min)))))) | |
585 | (save-excursion | |
586 | (goto-char search-start) | |
587 | (while (re-search-forward regexp search-end t) | |
588 | (let ((overlay (make-overlay (match-beginning 0) (match-end 0)))) | |
589 | (overlay-put overlay 'hi-lock-overlay t) | |
590 | (overlay-put overlay 'hi-lock-overlay-regexp serial) | |
591 | (overlay-put overlay 'face face)) | |
592 | (goto-char (match-end 0))))))))) | |
abb2db1c GM |
593 | |
594 | (defun hi-lock-set-file-patterns (patterns) | |
595 | "Replace file patterns list with PATTERNS and refontify." | |
108ee42b GM |
596 | (when (or hi-lock-file-patterns patterns) |
597 | (font-lock-remove-keywords nil hi-lock-file-patterns) | |
598 | (setq hi-lock-file-patterns patterns) | |
90756087 | 599 | (font-lock-add-keywords nil hi-lock-file-patterns t) |
e4d59066 | 600 | (font-lock-fontify-buffer))) |
abb2db1c GM |
601 | |
602 | (defun hi-lock-find-patterns () | |
603 | "Find patterns in current buffer for hi-lock." | |
604 | (interactive) | |
605 | (unless (memq major-mode hi-lock-exclude-modes) | |
606 | (let ((all-patterns nil) | |
607 | (target-regexp (concat "\\<" hi-lock-file-patterns-prefix ":"))) | |
608 | (save-excursion | |
62cec9fe SM |
609 | (save-restriction |
610 | (widen) | |
611 | (goto-char (point-min)) | |
612 | (re-search-forward target-regexp | |
613 | (+ (point) hi-lock-file-patterns-range) t) | |
614 | (beginning-of-line) | |
615 | (while (and (re-search-forward target-regexp (+ (point) 100) t) | |
616 | (not (looking-at "\\s-*end"))) | |
ed6773fa JB |
617 | (condition-case nil |
618 | (setq all-patterns (append (read (current-buffer)) all-patterns)) | |
619 | (error (message "Invalid pattern list expression at %d" | |
963b2040 | 620 | (line-number-at-pos))))))) |
c898bef7 CY |
621 | (when (and all-patterns |
622 | hi-lock-mode | |
623 | (cond | |
624 | ((eq this-command 'hi-lock-find-patterns) t) | |
625 | ((functionp hi-lock-file-patterns-policy) | |
626 | (funcall hi-lock-file-patterns-policy all-patterns)) | |
627 | ((eq hi-lock-file-patterns-policy 'ask) | |
628 | (y-or-n-p "Add patterns from this buffer to hi-lock? ")) | |
629 | (t nil))) | |
630 | (hi-lock-set-file-patterns all-patterns) | |
631 | (if (interactive-p) | |
632 | (message "Hi-lock added %d patterns." (length all-patterns))))))) | |
abb2db1c GM |
633 | |
634 | (defun hi-lock-font-lock-hook () | |
8b730780 | 635 | "Add hi-lock patterns to font-lock's." |
e4d59066 | 636 | (if font-lock-mode |
90756087 JL |
637 | (progn |
638 | (font-lock-add-keywords nil hi-lock-file-patterns t) | |
639 | (font-lock-add-keywords nil hi-lock-interactive-patterns t)) | |
71060bdd | 640 | (hi-lock-mode -1))) |
abb2db1c | 641 | |
81dc5714 JL |
642 | (defvar hi-lock-string-serialize-hash |
643 | (make-hash-table :test 'equal) | |
644 | "Hash table used to assign unique numbers to strings.") | |
645 | ||
646 | (defvar hi-lock-string-serialize-serial 1 | |
647 | "Number assigned to last new string in call to `hi-lock-string-serialize'. | |
648 | A string is considered new if it had not previously been used in a call to | |
649 | `hi-lock-string-serialize'.") | |
650 | ||
651 | (defun hi-lock-string-serialize (string) | |
652 | "Return unique serial number for STRING." | |
653 | (interactive) | |
654 | (let ((val (gethash string hi-lock-string-serialize-hash))) | |
655 | (if val val | |
656 | (puthash string | |
657 | (setq hi-lock-string-serialize-serial | |
658 | (1+ hi-lock-string-serialize-serial)) | |
659 | hi-lock-string-serialize-hash) | |
660 | hi-lock-string-serialize-serial))) | |
661 | ||
869d3e17 JB |
662 | (defun hi-lock-unload-function () |
663 | "Unload the Hi-Lock library." | |
664 | (global-hi-lock-mode -1) | |
665 | ;; continue standard unloading | |
666 | nil) | |
667 | ||
abb2db1c GM |
668 | (provide 'hi-lock) |
669 | ||
ffc30f4f | 670 | ;; arch-tag: d2e8fd07-4cc9-4c6f-a200-1e729bc54066 |
abb2db1c | 671 | ;;; hi-lock.el ends here |