|
0
|
1 ;;; fast-lock.el --- Automagic text properties caching for fast Font Lock mode.
|
|
|
2
|
|
2
|
3 ;; Copyright (C) 1994, 1995, 1996 Free Software Foundation, Inc.
|
|
0
|
4
|
|
|
5 ;; Author: Simon Marshall <simon@gnu.ai.mit.edu>
|
|
|
6 ;; Keywords: faces files
|
|
22
|
7 ;; Version: 3.10.02
|
|
|
8
|
|
|
9 ;;; This file is part of GNU Emacs.
|
|
0
|
10
|
|
22
|
11 ;; GNU Emacs is free software; you can redistribute it and/or modify
|
|
0
|
12 ;; it under the terms of the GNU General Public License as published by
|
|
22
|
13 ;; the Free Software Foundation; either version 2, or (at your option)
|
|
|
14 ;; any later version.
|
|
|
15
|
|
|
16 ;; GNU Emacs is distributed in the hope that it will be useful,
|
|
0
|
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.
|
|
22
|
20
|
|
0
|
21 ;; You should have received a copy of the GNU General Public License
|
|
22
|
22 ;; along with GNU Emacs; see the file COPYING. If not, write to the
|
|
2
|
23 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
24 ;; Boston, MA 02111-1307, USA.
|
|
0
|
25
|
|
|
26 ;;; Commentary:
|
|
|
27
|
|
|
28 ;; Purpose:
|
|
|
29 ;;
|
|
|
30 ;; To make visiting a file in `font-lock-mode' faster by restoring its face
|
|
|
31 ;; text properties from automatically saved associated Font Lock cache files.
|
|
|
32 ;;
|
|
|
33 ;; See caveats and feedback below.
|
|
|
34 ;; See also the lazy-lock package. (But don't use the two at the same time!)
|
|
|
35
|
|
|
36 ;; Installation:
|
|
|
37 ;;
|
|
|
38 ;; Put in your ~/.emacs:
|
|
|
39 ;;
|
|
2
|
40 ;; (setq font-lock-support-mode 'fast-lock-mode)
|
|
0
|
41 ;;
|
|
|
42 ;; Start up a new Emacs and use font-lock as usual (except that you can use the
|
|
|
43 ;; so-called "gaudier" fontification regexps on big files without frustration).
|
|
|
44 ;;
|
|
|
45 ;; When you visit a file (which has `font-lock-mode' enabled) that has a
|
|
|
46 ;; corresponding Font Lock cache file associated with it, the Font Lock cache
|
|
|
47 ;; will be loaded from that file instead of being generated by Font Lock code.
|
|
|
48
|
|
|
49 ;; Caveats:
|
|
|
50 ;;
|
|
|
51 ;; A cache will be saved when visiting a compressed file using crypt++, but not
|
|
|
52 ;; be read. This is a "feature"/"consequence"/"bug" of crypt++.
|
|
|
53 ;;
|
|
|
54 ;; Version control packages are likely to stamp all over file modification
|
|
|
55 ;; times. Therefore the act of checking out may invalidate a cache.
|
|
22
|
56 ;;;;;^L
|
|
0
|
57 ;; History:
|
|
|
58 ;;
|
|
|
59 ;; 0.02--1.00:
|
|
2
|
60 ;; - Changed name from turbo-prop to fast-lock. Automagic for font-lock only
|
|
|
61 ;; - Made `fast-lock-mode' a minor mode, like G. Dinesh Dutt's fss-mode
|
|
0
|
62 ;; 1.00--1.01:
|
|
2
|
63 ;; - Turn on `fast-lock-mode' only if `buffer-file-name' or `interactive-p'
|
|
|
64 ;; - Made `fast-lock-file-name' use `buffer-name' if `buffer-file-name' is nil
|
|
|
65 ;; - Moved save-all conditions to `fast-lock-save-cache'
|
|
|
66 ;; - Added `fast-lock-save-text-properties' to `kill-buffer-hook'
|
|
|
67 ;; 1.01--2.00: complete rewrite---not worth the space to document
|
|
|
68 ;; - Changed structure of text properties cache and threw out file mod checks
|
|
0
|
69 ;; 2.00--2.01:
|
|
|
70 ;; - Made `condition-case' forms understand `quit'.
|
|
2
|
71 ;; - Made `fast-lock' require `font-lock'
|
|
|
72 ;; - Made `fast-lock-cache-name' chase links (from Ben Liblit)
|
|
0
|
73 ;; 2.01--3.00:
|
|
2
|
74 ;; - Changed structure of cache to include `font-lock-keywords' (from rms)
|
|
|
75 ;; - Changed `fast-lock-cache-mechanisms' to `fast-lock-cache-directories'
|
|
|
76 ;; - Removed `fast-lock-read-others'
|
|
|
77 ;; - Made `fast-lock-read-cache' ignore cache owner
|
|
|
78 ;; - Made `fast-lock-save-cache-external' create cache directory
|
|
|
79 ;; - Made `fast-lock-save-cache-external' save `font-lock-keywords'
|
|
|
80 ;; - Made `fast-lock-cache-data' check `font-lock-keywords'
|
|
|
81 ;; 3.00--3.01: incorporated port of 2.00 to Lucid, made by Barry Warsaw
|
|
|
82 ;; - Package now provides itself
|
|
|
83 ;; - Lucid: Use `font-lock-any-extents-p' for `font-lock-any-properties-p'
|
|
|
84 ;; - Lucid: Use `list-faces' for `face-list'
|
|
|
85 ;; - Lucid: Added `set-text-properties'
|
|
|
86 ;; - Lucid: Made `turn-on-fast-lock' pass 1 not t to `fast-lock-mode'
|
|
|
87 ;; - Removed test for `fast-lock-mode' from `fast-lock-read-cache'
|
|
|
88 ;; - Lucid: Added Lucid-specific `fast-lock-get-face-properties'
|
|
|
89 ;; 3.01--3.02: now works with Lucid Emacs, thanks to Barry Warsaw
|
|
|
90 ;; - Made `fast-lock-cache-name' map ":" to ";" for OS/2 (from Serganova Vera)
|
|
|
91 ;; - Made `fast-lock-cache-name' use abbreviated file name (from Barry Warsaw)
|
|
|
92 ;; - Lucid: Separated handlers for `error' and `quit' for `condition-case'
|
|
0
|
93 ;; 3.02--3.03:
|
|
2
|
94 ;; - Changed `fast-lock-save-cache-external' to `fast-lock-save-cache-data'
|
|
|
95 ;; - Lucid: Added Lucid-specific `fast-lock-set-face-properties'
|
|
0
|
96 ;; 3.03--3.04:
|
|
2
|
97 ;; - Corrected `subrp' test of Lucid code
|
|
|
98 ;; - Replaced `font-lock-any-properties-p' with `text-property-not-all'
|
|
|
99 ;; - Lucid: Made `fast-lock-set-face-properties' put `text-prop' on extents
|
|
|
100 ;; - Made `fast-lock-cache-directories' a regexp alist (from Colin Rafferty)
|
|
|
101 ;; - Made `fast-lock-cache-directory' to return a usable cache file directory
|
|
0
|
102 ;; 3.04--3.05:
|
|
2
|
103 ;; - Lucid: Fix for XEmacs 19.11 `text-property-not-all'
|
|
|
104 ;; - Replaced `subrp' test of Lucid code with `emacs-version' `string-match'
|
|
|
105 ;; - Made `byte-compile-warnings' omit `unresolved' on compilation
|
|
|
106 ;; - Made `fast-lock-save-cache-data' use a buffer (from Rick Sladkey)
|
|
|
107 ;; - Reverted to old `fast-lock-get-face-properties' (from Rick Sladkey)
|
|
|
108 ;; 3.05--3.06: incorporated hack of 3.03, made by Jonathan Stigelman (Stig)
|
|
|
109 ;; - Reverted to 3.04 version of `fast-lock-get-face-properties'
|
|
|
110 ;; - XEmacs: Removed `list-faces' `defalias'
|
|
|
111 ;; - Made `fast-lock-mode' and `turn-on-fast-lock' succeed `autoload' cookies
|
|
|
112 ;; - Added `fast-lock-submit-bug-report'
|
|
|
113 ;; - Renamed `fast-lock-save-size' to `fast-lock-minimum-size'
|
|
|
114 ;; - Made `fast-lock-save-cache' output a message if no save ever attempted
|
|
|
115 ;; - Made `fast-lock-save-cache-data' output a message if save attempted
|
|
|
116 ;; - Made `fast-lock-cache-data' output a message if load attempted
|
|
|
117 ;; - Made `fast-lock-save-cache-data' do `condition-case' not `unwind-protect'
|
|
|
118 ;; - Made `fast-lock-save-cache' and `fast-lock-read-cache' return nothing
|
|
|
119 ;; - Made `fast-lock-save-cache' check `buffer-modified-p' (Stig)
|
|
|
120 ;; - Added `fast-lock-save-events'
|
|
|
121 ;; - Added `fast-lock-after-save-hook' to `after-save-hook' (Stig)
|
|
|
122 ;; - Added `fast-lock-kill-buffer-hook' to `kill-buffer-hook'
|
|
|
123 ;; - Changed `fast-lock-save-caches' to `fast-lock-kill-emacs-hook'
|
|
|
124 ;; - Added `fast-lock-kill-emacs-hook' to `kill-emacs-hook'
|
|
|
125 ;; - Made `fast-lock-save-cache' check `verify-visited-file-modtime' (Stig)
|
|
|
126 ;; - Made `visited-file-modtime' be the basis of the timestamp (Stig)
|
|
|
127 ;; - Made `fast-lock-save-cache-1' and `fast-lock-cache-data' use/reformat it
|
|
|
128 ;; - Added `fast-lock-cache-filename' to keep track of the cache file name
|
|
|
129 ;; - Added `fast-lock-after-fontify-buffer'
|
|
|
130 ;; - Added `fast-lock-save-faces' list of faces to save (idea from Stig/Tibor)
|
|
|
131 ;; - Made `fast-lock-get-face-properties' functions use it
|
|
|
132 ;; - XEmacs: Made `fast-lock-set-face-properties' do extents the Font Lock way
|
|
|
133 ;; - XEmacs: Removed fix for `text-property-not-all' (19.11 support dropped)
|
|
|
134 ;; - Made `fast-lock-mode' ensure `font-lock-mode' is on
|
|
|
135 ;; - Made `fast-lock-save-cache' do `cdr-safe' not `cdr' (from Dave Foster)
|
|
|
136 ;; - Made `fast-lock-save-cache' do `set-buffer' first (from Dave Foster)
|
|
|
137 ;; - Made `fast-lock-save-cache' loop until saved or quit (from Georg Nikodym)
|
|
|
138 ;; - Made `fast-lock-cache-data' check `buffer-modified-p'
|
|
|
139 ;; - Made `fast-lock-cache-data' do `font-lock-compile-keywords' if necessary
|
|
|
140 ;; - XEmacs: Made `font-lock-compile-keywords' `defalias'
|
|
0
|
141 ;; 3.06--3.07:
|
|
2
|
142 ;; - XEmacs: Add `fast-lock-after-fontify-buffer' to the Font Lock hook
|
|
|
143 ;; - Made `fast-lock-cache-name' explain the use of `directory-abbrev-alist'
|
|
|
144 ;; - Made `fast-lock-mode' use `buffer-file-truename' not `buffer-file-name'
|
|
0
|
145 ;; 3.07--3.08:
|
|
2
|
146 ;; - Made `fast-lock-read-cache' set `fast-lock-cache-filename'
|
|
|
147 ;; 3.08--3.09:
|
|
|
148 ;; - Made `fast-lock-save-cache' cope if `fast-lock-minimum-size' is an a list
|
|
|
149 ;; - Made `fast-lock-mode' respect the value of `font-lock-inhibit-thing-lock'
|
|
|
150 ;; - Added `fast-lock-after-unfontify-buffer'
|
|
|
151 ;; 3.09--3.10:
|
|
|
152 ;; - Rewrite for Common Lisp macros
|
|
|
153 ;; - Made fast-lock.el barf on a crap 8+3 pseudo-OS (Eli Zaretskii help)
|
|
|
154 ;; - XEmacs: Made `add-minor-mode' succeed `autoload' cookie
|
|
|
155 ;; - XEmacs: Made `fast-lock-save-faces' default to `font-lock-face-list'
|
|
|
156 ;; - Made `fast-lock-save-cache' use `font-lock-value-in-major-mode'
|
|
|
157 ;; - Wrap with `save-buffer-state' (Ray Van Tassle report)
|
|
|
158 ;; - Made `fast-lock-mode' wrap `font-lock-support-mode'
|
|
|
159 ;; 3.10--3.11:
|
|
22
|
160 ;; - Made `fast-lock-get-face-properties' cope with face lists
|
|
|
161 ;; - Added `fast-lock-verbose'
|
|
|
162 ;; - XEmacs: Add `font-lock-value-in-major-mode' if necessary
|
|
|
163 ;;;;;^L
|
|
0
|
164 (require 'font-lock)
|
|
|
165
|
|
2
|
166 ;; Make sure fast-lock.el is supported.
|
|
|
167 (if (and (eq system-type 'ms-dos) (not (msdos-long-file-names)))
|
|
|
168 (error "`fast-lock' was written for long file name systems"))
|
|
|
169
|
|
0
|
170 (eval-when-compile
|
|
2
|
171 ;;
|
|
|
172 ;; We don't do this at the top-level as we only use non-autoloaded macros.
|
|
|
173 (require 'cl)
|
|
|
174 ;;
|
|
|
175 ;; I prefer lazy code---and lazy mode.
|
|
|
176 (setq byte-compile-dynamic t byte-compile-dynamic-docstrings t)
|
|
|
177 ;; But, we make sure that the code is as zippy as can be.
|
|
|
178 (setq byte-optimize t)
|
|
|
179 ;;
|
|
|
180 ;; We use this to preserve or protect things when modifying text properties.
|
|
|
181 (defmacro save-buffer-state (varlist &rest body)
|
|
|
182 "Bind variables according to VARLIST and eval BODY restoring buffer state."
|
|
|
183 (` (let* ((,@ (append varlist
|
|
|
184 '((modified (buffer-modified-p))
|
|
|
185 (inhibit-read-only t) (buffer-undo-list t)
|
|
|
186 before-change-functions after-change-functions
|
|
|
187 deactivate-mark buffer-file-name buffer-file-truename))))
|
|
|
188 (,@ body)
|
|
|
189 (when (and (not modified) (buffer-modified-p))
|
|
|
190 (set-buffer-modified-p nil)))))
|
|
22
|
191 (put 'save-buffer-state 'lisp-indent-function 1)
|
|
|
192 ;;
|
|
|
193 ;; We use this to verify that a face should be saved.
|
|
|
194 (defmacro fast-lock-save-facep (face)
|
|
|
195 "Return non-nil if FACE matches `fast-lock-save-faces'."
|
|
|
196 (` (or (null fast-lock-save-faces)
|
|
|
197 (if (symbolp (, face))
|
|
|
198 (memq (, face) fast-lock-save-faces)
|
|
|
199 (let ((list (, face)) found)
|
|
|
200 (while list
|
|
|
201 (if (memq (car list) fast-lock-save-faces)
|
|
|
202 (setq list nil found t)
|
|
|
203 (setq list (cdr list))))
|
|
|
204 found))))))
|
|
0
|
205
|
|
|
206 (defun fast-lock-submit-bug-report ()
|
|
|
207 "Submit via mail a bug report on fast-lock.el."
|
|
|
208 (interactive)
|
|
|
209 (let ((reporter-prompt-for-summary-p t))
|
|
22
|
210 (reporter-submit-bug-report "simon@gnu.ai.mit.edu" "fast-lock 3.10.02"
|
|
0
|
211 '(fast-lock-cache-directories fast-lock-minimum-size
|
|
22
|
212 fast-lock-save-others fast-lock-save-events fast-lock-save-faces
|
|
|
213 fast-lock-verbose)
|
|
0
|
214 nil nil
|
|
|
215 (concat "Hi Si.,
|
|
|
216
|
|
|
217 I want to report a bug. I've read the `Bugs' section of `Info' on Emacs, so I
|
|
|
218 know how to make a clear and unambiguous report. To reproduce the bug:
|
|
|
219
|
|
2
|
220 Start a fresh editor via `" invocation-name " -no-init-file -no-site-file'.
|
|
0
|
221 In the `*scratch*' buffer, evaluate:"))))
|
|
|
222
|
|
|
223 ;;;###autoload
|
|
2
|
224 (defvar fast-lock-mode nil)
|
|
0
|
225 (defvar fast-lock-cache-timestamp nil) ; for saving/reading
|
|
|
226 (defvar fast-lock-cache-filename nil) ; for deleting
|
|
22
|
227 ;;;;;^L
|
|
0
|
228 ;; User Variables:
|
|
|
229
|
|
|
230 (defvar fast-lock-cache-directories '("." "~/.emacs-flc")
|
|
|
231 ; - `internal', keep each file's Font Lock cache file in the same file.
|
|
|
232 ; - `external', keep each file's Font Lock cache file in the same directory.
|
|
2
|
233 "*Directories in which Font Lock cache files are saved and read.
|
|
0
|
234 Each item should be either DIR or a cons pair of the form (REGEXP . DIR) where
|
|
|
235 DIR is a directory name (relative or absolute) and REGEXP is a regexp.
|
|
|
236
|
|
|
237 An attempt will be made to save or read Font Lock cache files using these items
|
|
|
238 until one succeeds (i.e., until a readable or writable one is found). If an
|
|
|
239 item contains REGEXP, DIR is used only if the buffer file name matches REGEXP.
|
|
|
240 For example:
|
|
|
241
|
|
|
242 (let ((home (expand-file-name (abbreviate-file-name (file-truename \"~/\")))))
|
|
|
243 (list (cons (concat \"^\" (regexp-quote home)) \".\") \"~/.emacs-flc\"))
|
|
|
244 =>
|
|
|
245 ((\"^/your/true/home/directory/\" . \".\") \"~/.emacs-flc\")
|
|
|
246
|
|
|
247 would cause a file's current directory to be used if the file is under your
|
|
|
248 home directory hierarchy, or otherwise the absolute directory `~/.emacs-flc'.")
|
|
|
249
|
|
|
250 (defvar fast-lock-minimum-size (* 25 1024)
|
|
2
|
251 "*Minimum size of a buffer for cached fontification.
|
|
0
|
252 Only buffers more than this can have associated Font Lock cache files saved.
|
|
2
|
253 If nil, means cache files are never created.
|
|
|
254 If a list, each element should be a cons pair of the form (MAJOR-MODE . SIZE),
|
|
|
255 where MAJOR-MODE is a symbol or t (meaning the default). For example:
|
|
|
256 ((c-mode . 25600) (c++-mode . 25600) (rmail-mode . 1048576))
|
|
|
257 means that the minimum size is 25K for buffers in C or C++ modes, one megabyte
|
|
|
258 for buffers in Rmail mode, and size is irrelevant otherwise.")
|
|
0
|
259
|
|
|
260 (defvar fast-lock-save-events '(kill-buffer kill-emacs)
|
|
2
|
261 "*Events under which caches will be saved.
|
|
0
|
262 Valid events are `save-buffer', `kill-buffer' and `kill-emacs'.
|
|
|
263 If concurrent editing sessions use the same associated cache file for a file's
|
|
|
264 buffer, then you should add `save-buffer' to this list.")
|
|
|
265
|
|
|
266 (defvar fast-lock-save-others t
|
|
2
|
267 "*If non-nil, save Font Lock cache files irrespective of file owner.
|
|
0
|
268 If nil, means only buffer files known to be owned by you can have associated
|
|
|
269 Font Lock cache files saved. Ownership may be unknown for networked files.")
|
|
|
270
|
|
|
271 (defvar fast-lock-save-faces
|
|
2
|
272 (when (save-match-data (string-match "XEmacs" (emacs-version)))
|
|
|
273 ;; XEmacs uses extents for everything, so we have to pick the right ones.
|
|
|
274 font-lock-face-list)
|
|
|
275 "Faces that will be saved in a Font Lock cache file.
|
|
0
|
276 If nil, means information for all faces will be saved.")
|
|
22
|
277
|
|
|
278 (defvar fast-lock-verbose font-lock-verbose
|
|
|
279 "*If non-nil, means show status messages for cache processing.
|
|
|
280 If a number, only buffers greater than this size have processing messages.")
|
|
|
281 ;;;;;^L
|
|
0
|
282 ;; User Functions:
|
|
|
283
|
|
|
284 ;;;###autoload
|
|
|
285 (defun fast-lock-mode (&optional arg)
|
|
|
286 "Toggle Fast Lock mode.
|
|
|
287 With arg, turn Fast Lock mode on if and only if arg is positive and the buffer
|
|
|
288 is associated with a file. Enable it automatically in your `~/.emacs' by:
|
|
|
289
|
|
2
|
290 (setq font-lock-support-mode 'fast-lock-mode)
|
|
0
|
291
|
|
|
292 If Fast Lock mode is enabled, and the current buffer does not contain any text
|
|
|
293 properties, any associated Font Lock cache is used if its timestamp matches the
|
|
|
294 buffer's file, and its `font-lock-keywords' match those that you are using.
|
|
|
295
|
|
|
296 Font Lock caches may be saved:
|
|
|
297 - When you save the file's buffer.
|
|
|
298 - When you kill an unmodified file's buffer.
|
|
|
299 - When you exit Emacs, for all unmodified or saved buffers.
|
|
|
300 Depending on the value of `fast-lock-save-events'.
|
|
|
301 See also the commands `fast-lock-read-cache' and `fast-lock-save-cache'.
|
|
|
302
|
|
|
303 Use \\[font-lock-fontify-buffer] to fontify the buffer if the cache is bad.
|
|
|
304
|
|
|
305 Various methods of control are provided for the Font Lock cache. In general,
|
|
|
306 see variable `fast-lock-cache-directories' and function `fast-lock-cache-name'.
|
|
|
307 For saving, see variables `fast-lock-minimum-size', `fast-lock-save-events',
|
|
22
|
308 `fast-lock-save-others' and `fast-lock-save-faces'."
|
|
0
|
309 (interactive "P")
|
|
|
310 ;; Only turn on if we are visiting a file. We could use `buffer-file-name',
|
|
|
311 ;; but many packages temporarily wrap that to nil when doing their own thing.
|
|
|
312 (set (make-local-variable 'fast-lock-mode)
|
|
|
313 (and buffer-file-truename
|
|
2
|
314 (not (memq 'fast-lock-mode font-lock-inhibit-thing-lock))
|
|
0
|
315 (if arg (> (prefix-numeric-value arg) 0) (not fast-lock-mode))))
|
|
|
316 (if (and fast-lock-mode (not font-lock-mode))
|
|
2
|
317 ;; Turned on `fast-lock-mode' rather than `font-lock-mode'.
|
|
|
318 (let ((font-lock-support-mode 'fast-lock-mode))
|
|
0
|
319 (font-lock-mode t))
|
|
|
320 ;; Let's get down to business.
|
|
|
321 (set (make-local-variable 'fast-lock-cache-timestamp) nil)
|
|
|
322 (set (make-local-variable 'fast-lock-cache-filename) nil)
|
|
2
|
323 (when (and fast-lock-mode (not font-lock-fontified))
|
|
|
324 (fast-lock-read-cache))))
|
|
0
|
325
|
|
|
326 (defun fast-lock-read-cache ()
|
|
|
327 "Read the Font Lock cache for the current buffer.
|
|
|
328
|
|
|
329 The following criteria must be met for a Font Lock cache file to be read:
|
|
|
330 - Fast Lock mode must be turned on in the buffer.
|
|
|
331 - The buffer must not be modified.
|
|
|
332 - The buffer's `font-lock-keywords' must match the cache's.
|
|
|
333 - The buffer file's timestamp must match the cache's.
|
|
|
334 - Criteria imposed by `fast-lock-cache-directories'.
|
|
|
335
|
|
|
336 See `fast-lock-mode'."
|
|
|
337 (interactive)
|
|
|
338 (let ((directories fast-lock-cache-directories)
|
|
|
339 (modified (buffer-modified-p)) (inhibit-read-only t)
|
|
|
340 (fontified font-lock-fontified))
|
|
|
341 (set (make-local-variable 'font-lock-fontified) nil)
|
|
|
342 ;; Keep trying directories until fontification is turned off.
|
|
|
343 (while (and directories (not font-lock-fontified))
|
|
|
344 (let ((directory (fast-lock-cache-directory (car directories) nil)))
|
|
2
|
345 (condition-case nil
|
|
|
346 (when directory
|
|
|
347 (setq fast-lock-cache-filename (fast-lock-cache-name directory))
|
|
|
348 (when (file-readable-p fast-lock-cache-filename)
|
|
|
349 (load fast-lock-cache-filename t t t)))
|
|
|
350 (error nil) (quit nil))
|
|
0
|
351 (setq directories (cdr directories))))
|
|
|
352 ;; Unset `fast-lock-cache-filename', and restore `font-lock-fontified', if
|
|
|
353 ;; we don't use a cache. (Note that `fast-lock-cache-data' sets the value
|
|
|
354 ;; of `fast-lock-cache-timestamp'.)
|
|
|
355 (set-buffer-modified-p modified)
|
|
2
|
356 (unless font-lock-fontified
|
|
|
357 (setq fast-lock-cache-filename nil font-lock-fontified fontified))))
|
|
0
|
358
|
|
|
359 (defun fast-lock-save-cache (&optional buffer)
|
|
|
360 "Save the Font Lock cache of BUFFER or the current buffer.
|
|
|
361
|
|
|
362 The following criteria must be met for a Font Lock cache file to be saved:
|
|
|
363 - Fast Lock mode must be turned on in the buffer.
|
|
|
364 - The event must be one of `fast-lock-save-events'.
|
|
|
365 - The buffer must be at least `fast-lock-minimum-size' bytes long.
|
|
|
366 - The buffer file must be owned by you, or `fast-lock-save-others' must be t.
|
|
|
367 - The buffer must contain at least one `face' text property.
|
|
|
368 - The buffer must not be modified.
|
|
|
369 - The buffer file's timestamp must be the same as the file's on disk.
|
|
|
370 - The on disk file's timestamp must be different than the buffer's cache.
|
|
|
371 - Criteria imposed by `fast-lock-cache-directories'.
|
|
|
372
|
|
|
373 See `fast-lock-mode'."
|
|
|
374 (interactive)
|
|
|
375 (save-excursion
|
|
2
|
376 (when buffer
|
|
|
377 (set-buffer buffer))
|
|
|
378 (let ((min-size (font-lock-value-in-major-mode fast-lock-minimum-size))
|
|
|
379 (file-timestamp (visited-file-modtime)) (saved nil))
|
|
|
380 (when (and fast-lock-mode
|
|
|
381 ;;
|
|
|
382 ;; "Only save if the buffer matches the file, the file has
|
|
|
383 ;; changed, and it was changed by the current emacs session."
|
|
|
384 ;;
|
|
|
385 ;; Only save if the buffer is not modified,
|
|
|
386 ;; (i.e., so we don't save for something not on disk)
|
|
|
387 (not (buffer-modified-p))
|
|
|
388 ;; and the file's timestamp is the same as the buffer's,
|
|
|
389 ;; (i.e., someone else hasn't written the file in the meantime)
|
|
|
390 (verify-visited-file-modtime (current-buffer))
|
|
|
391 ;; and the file's timestamp is different from the cache's.
|
|
|
392 ;; (i.e., a save has occurred since the cache was read)
|
|
|
393 (not (equal fast-lock-cache-timestamp file-timestamp))
|
|
|
394 ;;
|
|
|
395 ;; Only save if user's restrictions are satisfied.
|
|
|
396 (and min-size (>= (buffer-size) min-size))
|
|
|
397 (or fast-lock-save-others
|
|
|
398 (eq (user-uid) (nth 2 (file-attributes buffer-file-name))))
|
|
|
399 ;;
|
|
|
400 ;; Only save if there are `face' properties to save.
|
|
|
401 (text-property-not-all (point-min) (point-max) 'face nil))
|
|
|
402 ;;
|
|
|
403 ;; Try each directory until we manage to save or the user quits.
|
|
|
404 (let ((directories fast-lock-cache-directories))
|
|
|
405 (while (and directories (memq saved '(nil error)))
|
|
|
406 (let* ((dir (fast-lock-cache-directory (car directories) t))
|
|
|
407 (file (and dir (fast-lock-cache-name dir))))
|
|
|
408 (when (and file (file-writable-p file))
|
|
|
409 (setq saved (fast-lock-save-cache-1 file file-timestamp)))
|
|
|
410 (setq directories (cdr directories)))))))))
|
|
0
|
411
|
|
|
412 ;;;###autoload
|
|
|
413 (defun turn-on-fast-lock ()
|
|
|
414 "Unconditionally turn on Fast Lock mode."
|
|
|
415 (fast-lock-mode t))
|
|
22
|
416 ;;;;;^L
|
|
0
|
417 ;;; API Functions:
|
|
|
418
|
|
|
419 (defun fast-lock-after-fontify-buffer ()
|
|
|
420 ;; Delete the Font Lock cache file used to restore fontification, if any.
|
|
2
|
421 (when fast-lock-cache-filename
|
|
|
422 (if (file-writable-p fast-lock-cache-filename)
|
|
|
423 (delete-file fast-lock-cache-filename)
|
|
|
424 (message "File %s font lock cache cannot be deleted" (buffer-name))))
|
|
0
|
425 ;; Flag so that a cache will be saved later even if the file is never saved.
|
|
|
426 (setq fast-lock-cache-timestamp nil))
|
|
2
|
427
|
|
|
428 (defalias 'fast-lock-after-unfontify-buffer
|
|
|
429 'ignore)
|
|
22
|
430 ;;;;;^L
|
|
0
|
431 ;; Miscellaneous Functions:
|
|
|
432
|
|
2
|
433 (defun fast-lock-save-cache-after-save-file ()
|
|
0
|
434 ;; Do `fast-lock-save-cache' if `save-buffer' is on `fast-lock-save-events'.
|
|
2
|
435 (when (memq 'save-buffer fast-lock-save-events)
|
|
|
436 (fast-lock-save-cache)))
|
|
0
|
437
|
|
2
|
438 (defun fast-lock-save-cache-before-kill-buffer ()
|
|
0
|
439 ;; Do `fast-lock-save-cache' if `kill-buffer' is on `fast-lock-save-events'.
|
|
2
|
440 (when (memq 'kill-buffer fast-lock-save-events)
|
|
|
441 (fast-lock-save-cache)))
|
|
0
|
442
|
|
2
|
443 (defun fast-lock-save-caches-before-kill-emacs ()
|
|
0
|
444 ;; Do `fast-lock-save-cache's if `kill-emacs' is on `fast-lock-save-events'.
|
|
2
|
445 (when (memq 'kill-emacs fast-lock-save-events)
|
|
|
446 (mapcar 'fast-lock-save-cache (buffer-list))))
|
|
0
|
447
|
|
|
448 (defun fast-lock-cache-directory (directory create)
|
|
|
449 "Return usable directory based on DIRECTORY.
|
|
|
450 Returns nil if the directory does not exist, or, if CREATE non-nil, cannot be
|
|
|
451 created. DIRECTORY may be a string or a cons pair of the form (REGEXP . DIR).
|
|
|
452 See `fast-lock-cache-directories'."
|
|
|
453 (let ((dir
|
|
|
454 (cond ((not buffer-file-name)
|
|
|
455 ;; Should never be nil, but `crypt++' screws it up.
|
|
|
456 nil)
|
|
|
457 ((stringp directory)
|
|
|
458 ;; Just a directory.
|
|
|
459 directory)
|
|
|
460 (t
|
|
|
461 ;; A directory iff the file name matches the regexp.
|
|
|
462 (let ((bufile (expand-file-name buffer-file-truename))
|
|
|
463 (case-fold-search nil))
|
|
2
|
464 (when (save-match-data (string-match (car directory) bufile))
|
|
|
465 (cdr directory)))))))
|
|
0
|
466 (cond ((not dir)
|
|
|
467 nil)
|
|
|
468 ((file-accessible-directory-p dir)
|
|
|
469 dir)
|
|
|
470 (create
|
|
|
471 (condition-case nil
|
|
|
472 (progn (make-directory dir t) dir)
|
|
|
473 (error nil))))))
|
|
|
474
|
|
|
475 ;; If you are wondering why we only hash if the directory is not ".", rather
|
|
|
476 ;; than if `file-name-absolute-p', it is because if we just appended ".flc" for
|
|
|
477 ;; relative cache directories (that are not ".") then it is possible that more
|
|
|
478 ;; than one file would have the same cache name in that directory, if the luser
|
|
|
479 ;; made a link from one relative cache directory to another. (Phew!)
|
|
|
480 (defun fast-lock-cache-name (directory)
|
|
|
481 "Return full cache path name using caching DIRECTORY.
|
|
|
482 If DIRECTORY is `.', the path is the buffer file name appended with `.flc'.
|
|
|
483 Otherwise, the path name is constructed from DIRECTORY and the buffer's true
|
|
|
484 abbreviated file name, with all `/' characters in the name replaced with `#'
|
|
|
485 characters, and appended with `.flc'.
|
|
|
486
|
|
|
487 If the same file has different cache path names when edited on different
|
|
|
488 machines, e.g., on one machine the cache file name has the prefix `#home',
|
|
|
489 perhaps due to automount, try putting in your `~/.emacs' something like:
|
|
|
490
|
|
|
491 (setq directory-abbrev-alist (cons '(\"^/home/\" . \"/\") directory-abbrev-alist))
|
|
|
492
|
|
|
493 Emacs automagically removes the common `/tmp_mnt' automount prefix by default.
|
|
|
494
|
|
|
495 See `fast-lock-cache-directory'."
|
|
|
496 (if (string-equal directory ".")
|
|
|
497 (concat buffer-file-name ".flc")
|
|
|
498 (let* ((bufile (expand-file-name buffer-file-truename))
|
|
|
499 (chars-alist
|
|
|
500 (if (eq system-type 'emx)
|
|
|
501 '((?/ . (?#)) (?# . (?# ?#)) (?: . (?\;)) (?\; . (?\; ?\;)))
|
|
|
502 '((?/ . (?#)) (?# . (?# ?#)))))
|
|
|
503 (mapchars
|
|
|
504 (function (lambda (c) (or (cdr (assq c chars-alist)) (list c))))))
|
|
|
505 (concat
|
|
|
506 (file-name-as-directory (expand-file-name directory))
|
|
|
507 (mapconcat 'char-to-string (apply 'append (mapcar mapchars bufile)) "")
|
|
|
508 ".flc"))))
|
|
22
|
509 ;;;;;^L
|
|
0
|
510 ;; Font Lock Cache Processing Functions:
|
|
|
511
|
|
|
512 (defun fast-lock-save-cache-1 (file timestamp)
|
|
|
513 ;; Save the FILE with the TIMESTAMP as:
|
|
|
514 ;; (fast-lock-cache-data Version=2 TIMESTAMP font-lock-keywords PROPERTIES).
|
|
|
515 ;; Returns non-nil if a save was attempted to a writable cache file.
|
|
|
516 (let ((tpbuf (generate-new-buffer " *fast-lock*"))
|
|
22
|
517 (verbose (if (numberp fast-lock-verbose)
|
|
|
518 (> (buffer-size) fast-lock-verbose)
|
|
|
519 fast-lock-verbose))
|
|
|
520 (saved t))
|
|
|
521 (if verbose (message "Saving %s font lock cache..." (buffer-name)))
|
|
0
|
522 (condition-case nil
|
|
|
523 (save-excursion
|
|
|
524 (print (list 'fast-lock-cache-data 2
|
|
|
525 (list 'quote timestamp)
|
|
|
526 (list 'quote font-lock-keywords)
|
|
|
527 (list 'quote (fast-lock-get-face-properties)))
|
|
|
528 tpbuf)
|
|
|
529 (set-buffer tpbuf)
|
|
|
530 (write-region (point-min) (point-max) file nil 'quietly)
|
|
|
531 (setq fast-lock-cache-timestamp timestamp
|
|
|
532 fast-lock-cache-filename file))
|
|
|
533 (error (setq saved 'error)) (quit (setq saved 'quit)))
|
|
|
534 (kill-buffer tpbuf)
|
|
22
|
535 (if verbose (message "Saving %s font lock cache...%s" (buffer-name)
|
|
|
536 (cond ((eq saved 'error) "failed")
|
|
|
537 ((eq saved 'quit) "aborted")
|
|
|
538 (t "done"))))
|
|
0
|
539 ;; We return non-nil regardless of whether a failure occurred.
|
|
|
540 saved))
|
|
|
541
|
|
|
542 (defun fast-lock-cache-data (version timestamp keywords properties
|
|
|
543 &rest ignored)
|
|
|
544 ;; Change from (HIGH LOW) for back compatibility. Remove for version 3!
|
|
2
|
545 (when (consp (cdr-safe timestamp))
|
|
|
546 (setcdr timestamp (nth 1 timestamp)))
|
|
0
|
547 ;; Compile KEYWORDS and `font-lock-keywords' in case one is and one isn't.
|
|
|
548 (let ((current font-lock-keywords))
|
|
|
549 (setq keywords (font-lock-compile-keywords keywords)
|
|
|
550 font-lock-keywords (font-lock-compile-keywords current)))
|
|
|
551 ;; Use the Font Lock cache PROPERTIES if we're using cache VERSION format 2,
|
|
|
552 ;; the current buffer's file timestamp matches the TIMESTAMP, and the current
|
|
|
553 ;; buffer's font-lock-keywords are the same as KEYWORDS.
|
|
|
554 (let ((buf-timestamp (visited-file-modtime))
|
|
22
|
555 (verbose (if (numberp fast-lock-verbose)
|
|
|
556 (> (buffer-size) fast-lock-verbose)
|
|
|
557 fast-lock-verbose))
|
|
|
558 (loaded t))
|
|
0
|
559 (if (or (/= version 2)
|
|
|
560 (buffer-modified-p)
|
|
|
561 (not (equal timestamp buf-timestamp))
|
|
|
562 (not (equal keywords font-lock-keywords)))
|
|
|
563 (setq loaded nil)
|
|
22
|
564 (if verbose (message "Loading %s font lock cache..." (buffer-name)))
|
|
0
|
565 (condition-case nil
|
|
|
566 (fast-lock-set-face-properties properties)
|
|
|
567 (error (setq loaded 'error)) (quit (setq loaded 'quit)))
|
|
22
|
568 (if verbose (message "Loading %s font lock cache...%s" (buffer-name)
|
|
|
569 (cond ((eq loaded 'error) "failed")
|
|
|
570 ((eq loaded 'quit) "aborted")
|
|
|
571 (t "done")))))
|
|
0
|
572 (setq font-lock-fontified (eq loaded t)
|
|
|
573 fast-lock-cache-timestamp (and (eq loaded t) timestamp))))
|
|
22
|
574 ;;;;;^L
|
|
0
|
575 ;; Text Properties Processing Functions:
|
|
|
576
|
|
|
577 ;; This is faster, but fails if adjacent characters have different `face' text
|
|
|
578 ;; properties. Maybe that's why I dropped it in the first place?
|
|
|
579 ;(defun fast-lock-get-face-properties ()
|
|
|
580 ; "Return a list of all `face' text properties in the current buffer.
|
|
|
581 ;Each element of the list is of the form (VALUE START1 END1 START2 END2 ...)
|
|
|
582 ;where VALUE is a `face' property value and STARTx and ENDx are positions."
|
|
|
583 ; (save-restriction
|
|
|
584 ; (widen)
|
|
|
585 ; (let ((start (text-property-not-all (point-min) (point-max) 'face nil))
|
|
|
586 ; (limit (point-max)) end properties value cell)
|
|
|
587 ; (while start
|
|
|
588 ; (setq end (next-single-property-change start 'face nil limit)
|
|
|
589 ; value (get-text-property start 'face))
|
|
|
590 ; ;; Make, or add to existing, list of regions with same `face'.
|
|
|
591 ; (if (setq cell (assq value properties))
|
|
|
592 ; (setcdr cell (cons start (cons end (cdr cell))))
|
|
|
593 ; (setq properties (cons (list value start end) properties)))
|
|
|
594 ; (setq start (next-single-property-change end 'face)))
|
|
|
595 ; properties)))
|
|
|
596
|
|
22
|
597 ;; This copes if adjacent characters have different `face' text properties, but
|
|
|
598 ;; fails if they are lists.
|
|
|
599 ;(defun fast-lock-get-face-properties ()
|
|
|
600 ; "Return a list of all `face' text properties in the current buffer.
|
|
|
601 ;Each element of the list is of the form (VALUE START1 END1 START2 END2 ...)
|
|
|
602 ;where VALUE is a `face' property value and STARTx and ENDx are positions.
|
|
|
603 ;Only those `face' VALUEs in `fast-lock-save-faces' are returned."
|
|
|
604 ; (save-restriction
|
|
|
605 ; (widen)
|
|
|
606 ; (let ((faces (or fast-lock-save-faces (face-list))) (limit (point-max))
|
|
|
607 ; properties regions face start end)
|
|
|
608 ; (while faces
|
|
|
609 ; (setq face (car faces) faces (cdr faces) regions () end (point-min))
|
|
|
610 ; ;; Make a list of start/end regions with `face' property face.
|
|
|
611 ; (while (setq start (text-property-any end limit 'face face))
|
|
|
612 ; (setq end (or (text-property-not-all start limit 'face face) limit)
|
|
|
613 ; regions (cons start (cons end regions))))
|
|
|
614 ; ;; Add `face' face's regions, if any, to properties.
|
|
|
615 ; (when regions
|
|
|
616 ; (push (cons face regions) properties)))
|
|
|
617 ; properties)))
|
|
|
618
|
|
0
|
619 (defun fast-lock-get-face-properties ()
|
|
|
620 "Return a list of all `face' text properties in the current buffer.
|
|
|
621 Each element of the list is of the form (VALUE START1 END1 START2 END2 ...)
|
|
22
|
622 where VALUE is a `face' property value and STARTx and ENDx are positions."
|
|
0
|
623 (save-restriction
|
|
|
624 (widen)
|
|
22
|
625 (let ((start (text-property-not-all (point-min) (point-max) 'face nil))
|
|
|
626 (limit (point-max)) end properties value cell)
|
|
|
627 (while start
|
|
|
628 (setq end (next-single-property-change start 'face nil limit)
|
|
|
629 value (get-text-property start 'face))
|
|
|
630 ;; Make, or add to existing, list of regions with same `face'.
|
|
|
631 (cond ((setq cell (assoc value properties))
|
|
|
632 (setcdr cell (cons start (cons end (cdr cell)))))
|
|
|
633 ((fast-lock-save-facep value)
|
|
|
634 (push (list value start end) properties)))
|
|
|
635 (setq start (if (get-text-property end 'face)
|
|
|
636 end
|
|
|
637 (next-single-property-change end 'face))))
|
|
0
|
638 properties)))
|
|
|
639
|
|
|
640 (defun fast-lock-set-face-properties (properties)
|
|
|
641 "Set all `face' text properties to PROPERTIES in the current buffer.
|
|
2
|
642 Any existing `face' text properties are removed first.
|
|
0
|
643 See `fast-lock-get-face-properties' for the format of PROPERTIES."
|
|
2
|
644 (save-buffer-state (plist regions)
|
|
|
645 (save-restriction
|
|
|
646 (widen)
|
|
|
647 (font-lock-unfontify-region (point-min) (point-max))
|
|
|
648 (while properties
|
|
|
649 (setq plist (list 'face (car (car properties)))
|
|
|
650 regions (cdr (car properties))
|
|
|
651 properties (cdr properties))
|
|
0
|
652 ;; Set the `face' property for each start/end region.
|
|
|
653 (while regions
|
|
|
654 (set-text-properties (nth 0 regions) (nth 1 regions) plist)
|
|
2
|
655 (setq regions (nthcdr 2 regions)))))))
|
|
22
|
656 ;;;;;^L
|
|
0
|
657 ;; Functions for XEmacs:
|
|
|
658
|
|
2
|
659 (when (save-match-data (string-match "XEmacs" (emacs-version)))
|
|
|
660 ;;
|
|
|
661 ;; It would be better to use XEmacs' `map-extents' over extents with a
|
|
|
662 ;; `font-lock' property, but `face' properties are on different extents.
|
|
|
663 (defun fast-lock-get-face-properties ()
|
|
|
664 "Return a list of all `face' text properties in the current buffer.
|
|
0
|
665 Each element of the list is of the form (VALUE START1 END1 START2 END2 ...)
|
|
|
666 where VALUE is a `face' property value and STARTx and ENDx are positions.
|
|
|
667 Only those `face' VALUEs in `fast-lock-save-faces' are returned."
|
|
2
|
668 (save-restriction
|
|
|
669 (widen)
|
|
|
670 (let ((properties ()) cell)
|
|
|
671 (map-extents
|
|
|
672 (function (lambda (extent ignore)
|
|
|
673 (let ((value (extent-face extent)))
|
|
|
674 ;; We're only interested if it's one of `fast-lock-save-faces'.
|
|
22
|
675 (when (and value (fast-lock-save-facep value))
|
|
2
|
676 (let ((start (extent-start-position extent))
|
|
|
677 (end (extent-end-position extent)))
|
|
|
678 ;; Make or add to existing list of regions with the same
|
|
|
679 ;; `face' property value.
|
|
22
|
680 (if (setq cell (assoc value properties))
|
|
2
|
681 (setcdr cell (cons start (cons end (cdr cell))))
|
|
|
682 (push (list value start end) properties))))
|
|
|
683 ;; Return nil to keep `map-extents' going.
|
|
|
684 nil))))
|
|
|
685 properties)))
|
|
|
686 ;;
|
|
|
687 ;; Make extents just like XEmacs' font-lock.el does.
|
|
|
688 (defun fast-lock-set-face-properties (properties)
|
|
|
689 "Set all `face' text properties to PROPERTIES in the current buffer.
|
|
0
|
690 Any existing `face' text properties are removed first.
|
|
|
691 See `fast-lock-get-face-properties' for the format of PROPERTIES."
|
|
2
|
692 (save-restriction
|
|
|
693 (widen)
|
|
|
694 (font-lock-unfontify-region (point-min) (point-max))
|
|
|
695 (while properties
|
|
|
696 (let ((face (car (car properties)))
|
|
|
697 (regions (cdr (car properties))))
|
|
|
698 ;; Set the `face' property, etc., for each start/end region.
|
|
|
699 (while regions
|
|
|
700 (font-lock-set-face (nth 0 regions) (nth 1 regions) face)
|
|
|
701 (setq regions (nthcdr 2 regions)))
|
|
|
702 (setq properties (cdr properties))))))
|
|
|
703 ;;
|
|
|
704 ;; XEmacs 19.12 font-lock.el's `font-lock-fontify-buffer' runs a hook.
|
|
|
705 (add-hook 'font-lock-after-fontify-buffer-hook
|
|
|
706 'fast-lock-after-fontify-buffer))
|
|
0
|
707
|
|
2
|
708 (unless (boundp 'font-lock-inhibit-thing-lock)
|
|
|
709 (defvar font-lock-inhibit-thing-lock nil
|
|
|
710 "List of Font Lock mode related modes that should not be turned on."))
|
|
0
|
711
|
|
2
|
712 (unless (fboundp 'font-lock-value-in-major-mode)
|
|
|
713 (defun font-lock-value-in-major-mode (alist)
|
|
|
714 ;; Return value in ALIST for `major-mode'.
|
|
|
715 (if (consp alist)
|
|
|
716 (cdr (or (assq major-mode alist) (assq t alist)))
|
|
|
717 alist)))
|
|
|
718
|
|
|
719 (unless (fboundp 'font-lock-compile-keywords)
|
|
|
720 (defalias 'font-lock-compile-keywords 'identity))
|
|
22
|
721 ;;;;;^L
|
|
0
|
722 ;; Install ourselves:
|
|
|
723
|
|
2
|
724 (add-hook 'after-save-hook 'fast-lock-save-cache-after-save-file)
|
|
|
725 (add-hook 'kill-buffer-hook 'fast-lock-save-cache-before-kill-buffer)
|
|
|
726 (add-hook 'kill-emacs-hook 'fast-lock-save-caches-before-kill-emacs)
|
|
0
|
727
|
|
|
728 ;;;###autoload
|
|
2
|
729 (if (fboundp 'add-minor-mode) (add-minor-mode 'fast-lock-mode nil))
|
|
|
730 ;;;###dont-autoload
|
|
|
731 (unless (assq 'fast-lock-mode minor-mode-alist)
|
|
|
732 (setq minor-mode-alist (append minor-mode-alist '((fast-lock-mode nil)))))
|
|
0
|
733
|
|
|
734 ;; Provide ourselves:
|
|
|
735
|
|
|
736 (provide 'fast-lock)
|
|
|
737
|
|
|
738 ;;; fast-lock.el ends here
|
