38436
|
1 ;;; jit-lock.el --- just-in-time fontification
|
25003
|
2
|
53709
|
3 ;; Copyright (C) 1998, 2000, 2001, 2004 Free Software Foundation, Inc.
|
25003
|
4
|
|
5 ;; Author: Gerd Moellmann <gerd@gnu.org>
|
|
6 ;; Keywords: faces files
|
|
7
|
|
8 ;; This file is part of GNU Emacs.
|
|
9
|
|
10 ;; GNU Emacs is free software; you can redistribute it and/or modify
|
|
11 ;; it under the terms of the GNU General Public License as published by
|
|
12 ;; the Free Software Foundation; either version 2, or (at your option)
|
|
13 ;; any later version.
|
|
14
|
|
15 ;; GNU Emacs is distributed in the hope that it will be useful,
|
|
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
18 ;; GNU General Public License for more details.
|
|
19
|
|
20 ;; You should have received a copy of the GNU General Public License
|
|
21 ;; along with GNU Emacs; see the file COPYING. If not, write to the
|
|
22 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
23 ;; Boston, MA 02111-1307, USA.
|
|
24
|
|
25 ;;; Commentary:
|
|
26
|
|
27 ;; Just-in-time fontification, triggered by C redisplay code.
|
|
28
|
|
29 ;;; Code:
|
|
30
|
|
31
|
|
32 (eval-when-compile
|
28501
|
33 (defmacro with-buffer-unmodified (&rest body)
|
|
34 "Eval BODY, preserving the current buffer's modified state."
|
53756
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
35 (declare (debug t))
|
28501
|
36 (let ((modified (make-symbol "modified")))
|
|
37 `(let ((,modified (buffer-modified-p)))
|
32152
|
38 (unwind-protect
|
|
39 (progn ,@body)
|
|
40 (unless ,modified
|
|
41 (restore-buffer-modified-p nil))))))
|
49597
|
42
|
29799
|
43 (defmacro with-buffer-prepared-for-jit-lock (&rest body)
|
25003
|
44 "Execute BODY in current buffer, overriding several variables.
|
|
45 Preserves the `buffer-modified-p' state of the current buffer."
|
53756
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
46 (declare (debug t))
|
28521
|
47 `(with-buffer-unmodified
|
|
48 (let ((buffer-undo-list t)
|
|
49 (inhibit-read-only t)
|
|
50 (inhibit-point-motion-hooks t)
|
29799
|
51 (inhibit-modification-hooks t)
|
28521
|
52 deactivate-mark
|
|
53 buffer-file-name
|
|
54 buffer-file-truename)
|
|
55 ,@body))))
|
28501
|
56
|
49597
|
57
|
25003
|
58
|
|
59 ;;; Customization.
|
|
60
|
53709
|
61 (defgroup jit-lock nil
|
|
62 "Font Lock support mode to fontify just-in-time."
|
|
63 :link '(custom-manual "(emacs)Support Modes")
|
|
64 :version "21.1"
|
|
65 :group 'font-lock)
|
|
66
|
25003
|
67 (defcustom jit-lock-chunk-size 500
|
29799
|
68 "*Jit-lock chunks of this many characters, or smaller."
|
25003
|
69 :type 'integer
|
|
70 :group 'jit-lock)
|
|
71
|
|
72
|
|
73 (defcustom jit-lock-stealth-time 3
|
|
74 "*Time in seconds to wait before beginning stealth fontification.
|
|
75 Stealth fontification occurs if there is no input within this time.
|
32581
|
76 If nil, stealth fontification is never performed.
|
25003
|
77
|
|
78 The value of this variable is used when JIT Lock mode is turned on."
|
|
79 :type '(choice (const :tag "never" nil)
|
|
80 (number :tag "seconds"))
|
|
81 :group 'jit-lock)
|
|
82
|
|
83
|
|
84 (defcustom jit-lock-stealth-nice 0.125
|
|
85 "*Time in seconds to pause between chunks of stealth fontification.
|
|
86 Each iteration of stealth fontification is separated by this amount of time,
|
|
87 thus reducing the demand that stealth fontification makes on the system.
|
|
88 If nil, means stealth fontification is never paused.
|
|
89 To reduce machine load during stealth fontification, at the cost of stealth
|
|
90 taking longer to fontify, you could increase the value of this variable.
|
|
91 See also `jit-lock-stealth-load'."
|
|
92 :type '(choice (const :tag "never" nil)
|
49597
|
93 (number :tag "seconds"))
|
25003
|
94 :group 'jit-lock)
|
49597
|
95
|
25003
|
96
|
|
97 (defcustom jit-lock-stealth-load
|
|
98 (if (condition-case nil (load-average) (error)) 200)
|
|
99 "*Load in percentage above which stealth fontification is suspended.
|
|
100 Stealth fontification pauses when the system short-term load average (as
|
|
101 returned by the function `load-average' if supported) goes above this level,
|
|
102 thus reducing the demand that stealth fontification makes on the system.
|
|
103 If nil, means stealth fontification is never suspended.
|
|
104 To reduce machine load during stealth fontification, at the cost of stealth
|
|
105 taking longer to fontify, you could reduce the value of this variable.
|
|
106 See also `jit-lock-stealth-nice'."
|
|
107 :type (if (condition-case nil (load-average) (error))
|
|
108 '(choice (const :tag "never" nil)
|
|
109 (integer :tag "load"))
|
|
110 '(const :format "%t: unsupported\n" nil))
|
|
111 :group 'jit-lock)
|
|
112
|
|
113
|
|
114 (defcustom jit-lock-stealth-verbose nil
|
|
115 "*If non-nil, means stealth fontification should show status messages."
|
|
116 :type 'boolean
|
|
117 :group 'jit-lock)
|
|
118
|
|
119
|
53755
|
120 (defvaralias 'jit-lock-defer-contextually 'jit-lock-contextually)
|
|
121 (defcustom jit-lock-contextually 'syntax-driven
|
|
122 "*If non-nil, means fontification should be syntactically true.
|
|
123 If nil, means fontification occurs only on those lines modified. This
|
25003
|
124 means where modification on a line causes syntactic change on subsequent lines,
|
|
125 those subsequent lines are not refontified to reflect their new context.
|
53755
|
126 If t, means fontification occurs on those lines modified and all
|
25003
|
127 subsequent lines. This means those subsequent lines are refontified to reflect
|
53756
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
128 their new syntactic context, after `jit-lock-context-time' seconds.
|
53755
|
129 If any other value, e.g., `syntax-driven', means syntactically true
|
25003
|
130 fontification occurs only if syntactic fontification is performed using the
|
|
131 buffer mode's syntax table, i.e., only if `font-lock-keywords-only' is nil.
|
|
132
|
|
133 The value of this variable is used when JIT Lock mode is turned on."
|
|
134 :type '(choice (const :tag "never" nil)
|
|
135 (const :tag "always" t)
|
|
136 (other :tag "syntax-driven" syntax-driven))
|
|
137 :group 'jit-lock)
|
|
138
|
53756
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
139 (defcustom jit-lock-context-time 0.5
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
140 "Idle time after which text is contextually refontified, if applicable."
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
141 :type '(number :tag "seconds"))
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
142
|
41502
|
143 (defcustom jit-lock-defer-time nil ;; 0.25
|
41336
|
144 "Idle time after which deferred fontification should take place.
|
|
145 If nil, fontification is not deferred."
|
|
146 :group 'jit-lock
|
|
147 :type '(choice (const :tag "never" nil)
|
|
148 (number :tag "seconds")))
|
25003
|
149
|
|
150 ;;; Variables that are not customizable.
|
|
151
|
|
152 (defvar jit-lock-mode nil
|
|
153 "Non-nil means Just-in-time Lock mode is active.")
|
|
154 (make-variable-buffer-local 'jit-lock-mode)
|
|
155
|
32152
|
156 (defvar jit-lock-functions nil
|
|
157 "Functions to do the actual fontification.
|
|
158 They are called with two arguments: the START and END of the region to fontify.")
|
32305
|
159 (make-variable-buffer-local 'jit-lock-functions)
|
25003
|
160
|
53709
|
161 (defvar jit-lock-context-unfontify-pos nil
|
32305
|
162 "Consider text after this position as contextually unfontified.
|
29799
|
163 If nil, contextual fontification is disabled.")
|
53709
|
164 (make-variable-buffer-local 'jit-lock-context-unfontify-pos)
|
25003
|
165
|
|
166
|
|
167 (defvar jit-lock-stealth-timer nil
|
|
168 "Timer for stealth fontification in Just-in-time Lock mode.")
|
53756
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
169 (defvar jit-lock-context-timer nil
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
170 "Timer for context fontification in Just-in-time Lock mode.")
|
41336
|
171 (defvar jit-lock-defer-timer nil
|
|
172 "Timer for deferred fontification in Just-in-time Lock mode.")
|
|
173
|
53709
|
174 (defvar jit-lock-defer-buffers nil
|
41336
|
175 "List of buffers with pending deferred fontification.")
|
25003
|
176
|
|
177 ;;; JIT lock mode
|
|
178
|
|
179 (defun jit-lock-mode (arg)
|
|
180 "Toggle Just-in-time Lock mode.
|
29799
|
181 Turn Just-in-time Lock mode on if and only if ARG is non-nil.
|
25003
|
182 Enable it automatically by customizing group `font-lock'.
|
|
183
|
|
184 When Just-in-time Lock mode is enabled, fontification is different in the
|
|
185 following ways:
|
|
186
|
|
187 - Demand-driven buffer fontification triggered by Emacs C code.
|
|
188 This means initial fontification of the whole buffer does not occur.
|
|
189 Instead, fontification occurs when necessary, such as when scrolling
|
|
190 through the buffer would otherwise reveal unfontified areas. This is
|
|
191 useful if buffer fontification is too slow for large buffers.
|
|
192
|
|
193 - Stealthy buffer fontification if `jit-lock-stealth-time' is non-nil.
|
|
194 This means remaining unfontified areas of buffers are fontified if Emacs has
|
|
195 been idle for `jit-lock-stealth-time' seconds, while Emacs remains idle.
|
|
196 This is useful if any buffer has any deferred fontification.
|
|
197
|
53755
|
198 - Deferred context fontification if `jit-lock-contextually' is
|
25003
|
199 non-nil. This means fontification updates the buffer corresponding to
|
53756
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
200 true syntactic context, after `jit-lock-context-time' seconds of Emacs
|
25003
|
201 idle time, while Emacs remains idle. Otherwise, fontification occurs
|
|
202 on modified lines only, and subsequent lines can remain fontified
|
|
203 corresponding to previous syntactic contexts. This is useful where
|
|
204 strings or comments span lines.
|
|
205
|
|
206 Stealth fontification only occurs while the system remains unloaded.
|
|
207 If the system load rises above `jit-lock-stealth-load' percent, stealth
|
|
208 fontification is suspended. Stealth fontification intensity is controlled via
|
29413
|
209 the variable `jit-lock-stealth-nice'."
|
29799
|
210 (setq jit-lock-mode arg)
|
|
211 (cond (;; Turn Just-in-time Lock mode on.
|
|
212 jit-lock-mode
|
25003
|
213
|
41336
|
214 ;; Mark the buffer for refontification.
|
32305
|
215 (jit-lock-refontify)
|
29413
|
216
|
25003
|
217 ;; Install an idle timer for stealth fontification.
|
32181
|
218 (when (and jit-lock-stealth-time (null jit-lock-stealth-timer))
|
29413
|
219 (setq jit-lock-stealth-timer
|
41336
|
220 (run-with-idle-timer jit-lock-stealth-time t
|
25003
|
221 'jit-lock-stealth-fontify)))
|
|
222
|
41336
|
223 ;; Init deferred fontification timer.
|
|
224 (when (and jit-lock-defer-time (null jit-lock-defer-timer))
|
|
225 (setq jit-lock-defer-timer
|
|
226 (run-with-idle-timer jit-lock-defer-time t
|
|
227 'jit-lock-deferred-fontify)))
|
|
228
|
53709
|
229 ;; Initialize contextual fontification if requested.
|
53755
|
230 (when (eq jit-lock-contextually t)
|
53756
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
231 (unless jit-lock-context-timer
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
232 (setq jit-lock-context-timer
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
233 (run-with-idle-timer jit-lock-context-time t
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
234 'jit-lock-context-fontify)))
|
53709
|
235 (setq jit-lock-context-unfontify-pos
|
|
236 (or jit-lock-context-unfontify-pos (point-max))))
|
29799
|
237
|
32305
|
238 ;; Setup our hooks.
|
29799
|
239 (add-hook 'after-change-functions 'jit-lock-after-change nil t)
|
25003
|
240 (add-hook 'fontification-functions 'jit-lock-function))
|
|
241
|
|
242 ;; Turn Just-in-time Lock mode off.
|
|
243 (t
|
41336
|
244 ;; Cancel our idle timers.
|
53756
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
245 (when (and (or jit-lock-stealth-timer jit-lock-defer-timer
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
246 jit-lock-context-timer)
|
41336
|
247 ;; Only if there's no other buffer using them.
|
|
248 (not (catch 'found
|
|
249 (dolist (buf (buffer-list))
|
|
250 (with-current-buffer buf
|
|
251 (when jit-lock-mode (throw 'found t)))))))
|
|
252 (when jit-lock-stealth-timer
|
|
253 (cancel-timer jit-lock-stealth-timer)
|
|
254 (setq jit-lock-stealth-timer nil))
|
53756
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
255 (when jit-lock-context-timer
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
256 (cancel-timer jit-lock-context-timer)
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
257 (setq jit-lock-context-timer nil))
|
41336
|
258 (when jit-lock-defer-timer
|
|
259 (cancel-timer jit-lock-defer-timer)
|
|
260 (setq jit-lock-defer-timer nil)))
|
25003
|
261
|
32305
|
262 ;; Remove hooks.
|
29413
|
263 (remove-hook 'after-change-functions 'jit-lock-after-change t)
|
25003
|
264 (remove-hook 'fontification-functions 'jit-lock-function))))
|
|
265
|
32181
|
266 ;;;###autoload
|
|
267 (defun jit-lock-register (fun &optional contextual)
|
32157
c3d137c056d1
(jit-lock-register, jit-lock-unregister): Docstring fix.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
268 "Register FUN as a fontification function to be called in this buffer.
|
c3d137c056d1
(jit-lock-register, jit-lock-unregister): Docstring fix.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
269 FUN will be called with two arguments START and END indicating the region
|
32181
|
270 that needs to be (re)fontified.
|
|
271 If non-nil, CONTEXTUAL means that a contextual fontification would be useful."
|
32156
b3596a2daf42
(jit-lock-register, jit-lock-unregister): New functions.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
272 (add-hook 'jit-lock-functions fun nil t)
|
53755
|
273 (when (and contextual jit-lock-contextually)
|
|
274 (set (make-local-variable 'jit-lock-contextually) t))
|
32156
b3596a2daf42
(jit-lock-register, jit-lock-unregister): New functions.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
275 (jit-lock-mode t))
|
b3596a2daf42
(jit-lock-register, jit-lock-unregister): New functions.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
276
|
b3596a2daf42
(jit-lock-register, jit-lock-unregister): New functions.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
277 (defun jit-lock-unregister (fun)
|
32157
c3d137c056d1
(jit-lock-register, jit-lock-unregister): Docstring fix.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
278 "Unregister FUN as a fontification function.
|
32156
b3596a2daf42
(jit-lock-register, jit-lock-unregister): New functions.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
279 Only applies to the current buffer."
|
b3596a2daf42
(jit-lock-register, jit-lock-unregister): New functions.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
280 (remove-hook 'jit-lock-functions fun t)
|
32305
|
281 (unless jit-lock-functions (jit-lock-mode nil)))
|
25003
|
282
|
29413
|
283 ;; This function is used to prevent font-lock-fontify-buffer from
|
|
284 ;; fontifying eagerly the whole buffer. This is important for
|
|
285 ;; things like CWarn mode which adds/removes a few keywords and
|
|
286 ;; does a refontify (which takes ages on large files).
|
32305
|
287 (defun jit-lock-refontify (&optional beg end)
|
|
288 "Force refontification of the region BEG..END (default whole buffer)."
|
29799
|
289 (with-buffer-prepared-for-jit-lock
|
29708
|
290 (save-restriction
|
|
291 (widen)
|
41336
|
292 (put-text-property (or beg (point-min)) (or end (point-max))
|
|
293 'fontified nil))))
|
25003
|
294
|
|
295 ;;; On demand fontification.
|
|
296
|
|
297 (defun jit-lock-function (start)
|
|
298 "Fontify current buffer starting at position START.
|
|
299 This function is added to `fontification-functions' when `jit-lock-mode'
|
|
300 is active."
|
|
301 (when jit-lock-mode
|
41336
|
302 (if (null jit-lock-defer-time)
|
|
303 ;; No deferral.
|
|
304 (jit-lock-fontify-now start (+ start jit-lock-chunk-size))
|
|
305 ;; Record the buffer for later fontification.
|
53709
|
306 (unless (memq (current-buffer) jit-lock-defer-buffers)
|
|
307 (push (current-buffer) jit-lock-defer-buffers))
|
41336
|
308 ;; Mark the area as defer-fontified so that the redisplay engine
|
|
309 ;; is happy and so that the idle timer can find the places to fontify.
|
|
310 (with-buffer-prepared-for-jit-lock
|
|
311 (put-text-property start
|
|
312 (next-single-property-change
|
|
313 start 'fontified nil
|
|
314 (min (point-max) (+ start jit-lock-chunk-size)))
|
|
315 'fontified 'defer)))))
|
32305
|
316
|
|
317 (defun jit-lock-fontify-now (&optional start end)
|
|
318 "Fontify current buffer from START to END.
|
|
319 Defaults to the whole buffer. END can be out of bounds."
|
29799
|
320 (with-buffer-prepared-for-jit-lock
|
28501
|
321 (save-excursion
|
47725
|
322 (unless start (setq start (point-min)))
|
|
323 (setq end (if end (min end (point-max)) (point-max)))
|
|
324 ;; This did bind `font-lock-beginning-of-syntax-function' to
|
|
325 ;; nil at some point, for an unknown reason. Don't do this; it
|
|
326 ;; can make highlighting slow due to expensive calls to
|
|
327 ;; `parse-partial-sexp' in function
|
|
328 ;; `font-lock-fontify-syntactically-region'. Example: paging
|
|
329 ;; from the end of a buffer to its start, can do repeated
|
|
330 ;; `parse-partial-sexp' starting from `point-min', which can
|
|
331 ;; take a long time in a large buffer.
|
|
332 (let (next)
|
|
333 (save-match-data
|
|
334 ;; Fontify chunks beginning at START. The end of a
|
|
335 ;; chunk is either `end', or the start of a region
|
|
336 ;; before `end' that has already been fontified.
|
|
337 (while start
|
|
338 ;; Determine the end of this chunk.
|
|
339 (setq next (or (text-property-any start end 'fontified t)
|
|
340 end))
|
25395
|
341
|
47725
|
342 ;; Decide which range of text should be fontified.
|
|
343 ;; The problem is that START and NEXT may be in the
|
|
344 ;; middle of something matched by a font-lock regexp.
|
|
345 ;; Until someone has a better idea, let's start
|
|
346 ;; at the start of the line containing START and
|
|
347 ;; stop at the start of the line following NEXT.
|
|
348 (goto-char next) (setq next (line-beginning-position 2))
|
|
349 (goto-char start) (setq start (line-beginning-position))
|
49597
|
350
|
47725
|
351 ;; Fontify the chunk, and mark it as fontified.
|
|
352 ;; We mark it first, to make sure that we don't indefinitely
|
|
353 ;; re-execute this fontification if an error occurs.
|
|
354 (put-text-property start next 'fontified t)
|
53755
|
355 (condition-case err
|
|
356 (run-hook-with-args 'jit-lock-functions start next)
|
|
357 ;; If the user quits (which shouldn't happen in normal on-the-fly
|
|
358 ;; jit-locking), make sure the fontification will be performed
|
|
359 ;; before displaying the block again.
|
|
360 (quit (put-text-property start next 'fontified nil)
|
|
361 (funcall 'signal (car err) (cdr err))))
|
41336
|
362
|
47725
|
363 ;; Find the start of the next chunk, if any.
|
|
364 (setq start (text-property-any next end 'fontified nil))))))))
|
25003
|
365
|
|
366
|
|
367 ;;; Stealth fontification.
|
|
368
|
|
369 (defsubst jit-lock-stealth-chunk-start (around)
|
|
370 "Return the start of the next chunk to fontify around position AROUND..
|
|
371 Value is nil if there is nothing more to fontify."
|
27537
|
372 (if (zerop (buffer-size))
|
|
373 nil
|
|
374 (save-restriction
|
|
375 (widen)
|
41336
|
376 (let* ((next (text-property-not-all around (point-max) 'fontified t))
|
27537
|
377 (prev (previous-single-property-change around 'fontified))
|
|
378 (prop (get-text-property (max (point-min) (1- around))
|
|
379 'fontified))
|
|
380 (start (cond
|
|
381 ((null prev)
|
|
382 ;; There is no property change between AROUND
|
|
383 ;; and the start of the buffer. If PROP is
|
|
384 ;; non-nil, everything in front of AROUND is
|
|
385 ;; fontified, otherwise nothing is fontified.
|
41336
|
386 (if (eq prop t)
|
27537
|
387 nil
|
|
388 (max (point-min)
|
|
389 (- around (/ jit-lock-chunk-size 2)))))
|
41336
|
390 ((eq prop t)
|
27537
|
391 ;; PREV is the start of a region of fontified
|
29799
|
392 ;; text containing AROUND. Start fontifying a
|
27537
|
393 ;; chunk size before the end of the unfontified
|
|
394 ;; region in front of that.
|
|
395 (max (or (previous-single-property-change prev 'fontified)
|
|
396 (point-min))
|
|
397 (- prev jit-lock-chunk-size)))
|
|
398 (t
|
|
399 ;; PREV is the start of a region of unfontified
|
|
400 ;; text containing AROUND. Start at PREV or
|
|
401 ;; chunk size in front of AROUND, whichever is
|
|
402 ;; nearer.
|
|
403 (max prev (- around jit-lock-chunk-size)))))
|
|
404 (result (cond ((null start) next)
|
|
405 ((null next) start)
|
|
406 ((< (- around start) (- next around)) start)
|
|
407 (t next))))
|
|
408 result))))
|
49597
|
409
|
25003
|
410
|
|
411 (defun jit-lock-stealth-fontify ()
|
|
412 "Fontify buffers stealthily.
|
|
413 This functions is called after Emacs has been idle for
|
|
414 `jit-lock-stealth-time' seconds."
|
41336
|
415 ;; I used to check `inhibit-read-only' here, but I can't remember why. -stef
|
25003
|
416 (unless (or executing-kbd-macro
|
|
417 (window-minibuffer-p (selected-window)))
|
|
418 (let ((buffers (buffer-list))
|
|
419 minibuffer-auto-raise
|
|
420 message-log-max)
|
53755
|
421 (with-local-quit
|
|
422 (while (and buffers (not (input-pending-p)))
|
|
423 (with-current-buffer (pop buffers)
|
25003
|
424 (when jit-lock-mode
|
|
425 ;; This is funny. Calling sit-for with 3rd arg non-nil
|
|
426 ;; so that it doesn't redisplay, internally calls
|
|
427 ;; wait_reading_process_input also with a parameter
|
|
428 ;; saying "don't redisplay." Since this function here
|
|
429 ;; is called periodically, this effectively leads to
|
|
430 ;; process output not being redisplayed at all because
|
|
431 ;; redisplay_internal is never called. (That didn't
|
|
432 ;; work in the old redisplay either.) So, we learn that
|
|
433 ;; we mustn't call sit-for that way here. But then, we
|
|
434 ;; have to be cautious not to call sit-for in a widened
|
|
435 ;; buffer, since this could display hidden parts of that
|
|
436 ;; buffer. This explains the seemingly weird use of
|
|
437 ;; save-restriction/widen here.
|
|
438
|
|
439 (with-temp-message (if jit-lock-stealth-verbose
|
|
440 (concat "JIT stealth lock "
|
|
441 (buffer-name)))
|
27537
|
442
|
28521
|
443 ;; In the following code, the `sit-for' calls cause a
|
|
444 ;; redisplay, so it's required that the
|
|
445 ;; buffer-modified flag of a buffer that is displayed
|
|
446 ;; has the right value---otherwise the mode line of
|
|
447 ;; an unmodified buffer would show a `*'.
|
|
448 (let (start
|
|
449 (nice (or jit-lock-stealth-nice 0))
|
41336
|
450 (point (point-min)))
|
28521
|
451 (while (and (setq start
|
|
452 (jit-lock-stealth-chunk-start point))
|
|
453 (sit-for nice))
|
49597
|
454
|
41336
|
455 ;; fontify a block.
|
|
456 (jit-lock-fontify-now start (+ start jit-lock-chunk-size))
|
|
457 ;; If stealth jit-locking is done backwards, this leads to
|
|
458 ;; excessive O(n^2) refontification. -stef
|
53709
|
459 ;; (when (>= jit-lock-context-unfontify-pos start)
|
|
460 ;; (setq jit-lock-context-unfontify-pos end))
|
49597
|
461
|
28521
|
462 ;; Wait a little if load is too high.
|
|
463 (when (and jit-lock-stealth-load
|
|
464 (> (car (load-average)) jit-lock-stealth-load))
|
41336
|
465 (sit-for (or jit-lock-stealth-time 30)))))))))))))
|
25003
|
466
|
|
467
|
|
468
|
|
469 ;;; Deferred fontification.
|
|
470
|
41336
|
471 (defun jit-lock-deferred-fontify ()
|
|
472 "Fontify what was deferred."
|
53709
|
473 (when jit-lock-defer-buffers
|
41336
|
474 ;; Mark the deferred regions back to `fontified = nil'
|
53709
|
475 (dolist (buffer jit-lock-defer-buffers)
|
41336
|
476 (when (buffer-live-p buffer)
|
|
477 (with-current-buffer buffer
|
|
478 ;; (message "Jit-Defer %s" (buffer-name))
|
|
479 (with-buffer-prepared-for-jit-lock
|
|
480 (let ((pos (point-min)))
|
|
481 (while
|
|
482 (progn
|
|
483 (when (eq (get-text-property pos 'fontified) 'defer)
|
|
484 (put-text-property
|
|
485 pos (setq pos (next-single-property-change
|
|
486 pos 'fontified nil (point-max)))
|
|
487 'fontified nil))
|
|
488 (setq pos (next-single-property-change pos 'fontified)))))))))
|
53709
|
489 (setq jit-lock-defer-buffers nil)
|
41336
|
490 ;; Force fontification of the visible parts.
|
|
491 (let ((jit-lock-defer-time nil))
|
|
492 ;; (message "Jit-Defer Now")
|
|
493 (sit-for 0)
|
|
494 ;; (message "Jit-Defer Done")
|
|
495 )))
|
49597
|
496
|
41336
|
497
|
53756
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
498 (defun jit-lock-context-fontify ()
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
499 "Refresh fontification to take new context into account."
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
500 (dolist (buffer (buffer-list))
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
501 (with-current-buffer buffer
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
502 (when jit-lock-context-unfontify-pos
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
503 ;; (message "Jit-Context %s" (buffer-name))
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
504 (save-restriction
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
505 (widen)
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
506 (when (and (>= jit-lock-context-unfontify-pos (point-min))
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
507 (< jit-lock-context-unfontify-pos (point-max)))
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
508 ;; If we're in text that matches a complex multi-line
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
509 ;; font-lock pattern, make sure the whole text will be
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
510 ;; redisplayed eventually.
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
511 ;; Despite its name, we treat jit-lock-defer-multiline here
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
512 ;; rather than in jit-lock-defer since it has to do with multiple
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
513 ;; lines, i.e. with context.
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
514 (when (get-text-property jit-lock-context-unfontify-pos
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
515 'jit-lock-defer-multiline)
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
516 (setq jit-lock-context-unfontify-pos
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
517 (or (previous-single-property-change
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
518 jit-lock-context-unfontify-pos
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
519 'jit-lock-defer-multiline)
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
520 (point-min))))
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
521 (with-buffer-prepared-for-jit-lock
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
522 ;; Force contextual refontification.
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
523 (remove-text-properties
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
524 jit-lock-context-unfontify-pos (point-max)
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
525 '(fontified nil jit-lock-defer-multiline nil)))
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
526 (setq jit-lock-context-unfontify-pos (point-max))))))))
|
bbadbe04fc3d
(jit-lock-context-time, jit-lock-context-timer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
527
|
25003
|
528 (defun jit-lock-after-change (start end old-len)
|
|
529 "Mark the rest of the buffer as not fontified after a change.
|
|
530 Installed on `after-change-functions'.
|
|
531 START and END are the start and end of the changed text. OLD-LEN
|
|
532 is the pre-change length.
|
|
533 This function ensures that lines following the change will be refontified
|
|
534 in case the syntax of those lines has changed. Refontification
|
|
535 will take place when text is fontified stealthily."
|
|
536 (when jit-lock-mode
|
29827
dd9436a06050
(jit-lock-after-change): Don't assume point is at START.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
537 (save-excursion
|
dd9436a06050
(jit-lock-after-change): Don't assume point is at START.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
538 (with-buffer-prepared-for-jit-lock
|
dd9436a06050
(jit-lock-after-change): Don't assume point is at START.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
539 ;; It's important that the `fontified' property be set from the
|
dd9436a06050
(jit-lock-after-change): Don't assume point is at START.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
540 ;; beginning of the line, else font-lock will properly change the
|
dd9436a06050
(jit-lock-after-change): Don't assume point is at START.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
541 ;; text's face, but the display will have been done already and will
|
dd9436a06050
(jit-lock-after-change): Don't assume point is at START.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
542 ;; be inconsistent with the buffer's content.
|
dd9436a06050
(jit-lock-after-change): Don't assume point is at START.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
543 (goto-char start)
|
dd9436a06050
(jit-lock-after-change): Don't assume point is at START.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
544 (setq start (line-beginning-position))
|
49597
|
545
|
37781
|
546 ;; If we're in text that matches a multi-line font-lock pattern,
|
|
547 ;; make sure the whole text will be redisplayed.
|
41336
|
548 ;; I'm not sure this is ever necessary and/or sufficient. -stef
|
37781
|
549 (when (get-text-property start 'font-lock-multiline)
|
|
550 (setq start (or (previous-single-property-change
|
|
551 start 'font-lock-multiline)
|
|
552 (point-min))))
|
49597
|
553
|
29827
dd9436a06050
(jit-lock-after-change): Don't assume point is at START.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
554 ;; Make sure we change at least one char (in case of deletions).
|
dd9436a06050
(jit-lock-after-change): Don't assume point is at START.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
555 (setq end (min (max end (1+ start)) (point-max)))
|
dd9436a06050
(jit-lock-after-change): Don't assume point is at START.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
556 ;; Request refontification.
|
dd9436a06050
(jit-lock-after-change): Don't assume point is at START.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
557 (put-text-property start end 'fontified nil))
|
dd9436a06050
(jit-lock-after-change): Don't assume point is at START.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
558 ;; Mark the change for deferred contextual refontification.
|
53709
|
559 (when jit-lock-context-unfontify-pos
|
|
560 (setq jit-lock-context-unfontify-pos
|
|
561 (min jit-lock-context-unfontify-pos start))))))
|
49597
|
562
|
25003
|
563 (provide 'jit-lock)
|
|
564
|
52401
|
565 ;;; arch-tag: 56b5de6e-f581-453b-bb97-49c39372ff9e
|
38436
|
566 ;;; jit-lock.el ends here
|