]> code.delx.au - gnu-emacs/blob - lisp/whitespace.el
d3ae080e485f0926a47ab6f4afeac7380c0aac83
[gnu-emacs] / lisp / whitespace.el
1 ;;; whitespace.el --- warn about and clean bogus whitespaces in the file
2
3 ;; Copyright (C) 1999, 2000, 2002, 2003, 2004,
4 ;; 2005 Free Software Foundation, Inc.
5
6 ;; Author: Rajesh Vaidheeswarran <rv@gnu.org>
7 ;; Keywords: convenience
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
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,
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
23 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
24 ;; Boston, MA 02110-1301, USA.
25
26 ;;; Commentary:
27 ;;
28 ;; URL: http://www.dsmit.com/lisp/
29 ;;
30 ;; The whitespace library is intended to find and help fix five different types
31 ;; of whitespace problems that commonly exist in source code.
32 ;;
33 ;; 1. Leading space (empty lines at the top of a file).
34 ;; 2. Trailing space (empty lines at the end of a file).
35 ;; 3. Indentation space (8 or more spaces at beginning of line, that should be
36 ;; replaced with TABS).
37 ;; 4. Spaces followed by a TAB. (Almost always, we never want that).
38 ;; 5. Spaces or TABS at the end of a line.
39 ;;
40 ;; Whitespace errors are reported in a buffer, and on the modeline.
41 ;;
42 ;; Modeline will show a W:<x>!<y> to denote a particular type of whitespace,
43 ;; where `x' and `y' can be one (or more) of:
44 ;;
45 ;; e - End-of-Line whitespace.
46 ;; i - Indentation whitespace.
47 ;; l - Leading whitespace.
48 ;; s - Space followed by Tab.
49 ;; t - Trailing whitespace.
50 ;;
51 ;; If any of the whitespace checks is turned off, the modeline will display a
52 ;; !<y>.
53 ;;
54 ;; (since (3) is the most controversial one, here is the rationale: Most
55 ;; terminal drivers and printer drivers have TAB configured or even
56 ;; hardcoded to be 8 spaces. (Some of them allow configuration, but almost
57 ;; always they default to 8.)
58 ;;
59 ;; Changing `tab-width' to other than 8 and editing will cause your code to
60 ;; look different from within Emacs, and say, if you cat it or more it, or
61 ;; even print it.
62 ;;
63 ;; Almost all the popular programming modes let you define an offset (like
64 ;; c-basic-offset or perl-indent-level) to configure the offset, so you
65 ;; should never have to set your `tab-width' to be other than 8 in all
66 ;; these modes. In fact, with an indent level of say, 4, 2 TABS will cause
67 ;; Emacs to replace your 8 spaces with one \t (try it). If vi users in
68 ;; your office complain, tell them to use vim, which distinguishes between
69 ;; tabstop and shiftwidth (vi equivalent of our offsets), and also ask them
70 ;; to set smarttab.)
71 ;;
72 ;; All the above have caused (and will cause) unwanted codeline integration and
73 ;; merge problems.
74 ;;
75 ;; whitespace.el will complain if it detects whitespaces on opening a file, and
76 ;; warn you on closing a file also (in case you had inserted any
77 ;; whitespaces during the process of your editing).
78 ;;
79 ;; Exported functions:
80 ;;
81 ;; `whitespace-buffer' - To check the current buffer for whitespace problems.
82 ;; `whitespace-cleanup' - To cleanup all whitespaces in the current buffer.
83 ;; `whitespace-region' - To check between point and mark for whitespace
84 ;; problems.
85 ;; `whitespace-cleanup-region' - To cleanup all whitespaces between point
86 ;; and mark in the current buffer.
87
88 ;;; Code:
89
90 (defvar whitespace-version "3.5" "Version of the whitespace library.")
91
92 (defvar whitespace-all-buffer-files nil
93 "An associated list of buffers and files checked for whitespace cleanliness.
94
95 This is to enable periodic checking of whitespace cleanliness in the files
96 visited by the buffers.")
97
98 (defvar whitespace-rescan-timer nil
99 "Timer object used to rescan the files in buffers that have been modified.")
100
101 ;; Tell Emacs about this new kind of minor mode
102 (defvar whitespace-mode nil
103 "Non-nil when Whitespace mode (a minor mode) is enabled.")
104 (make-variable-buffer-local 'whitespace-mode)
105 (put 'whitespace-mode 'permanent-local nil)
106
107 (defvar whitespace-mode-line nil
108 "String to display in the mode line for Whitespace mode.")
109 (make-variable-buffer-local 'whitespace-mode-line)
110 (put 'whitespace-mode-line 'permanent-local nil)
111
112 (defvar whitespace-check-buffer-leading nil
113 "Test leading whitespace for file in current buffer if t.")
114 (make-variable-buffer-local 'whitespace-check-buffer-leading)
115 (put 'whitespace-check-buffer-leading 'permanent-local nil)
116
117 (defvar whitespace-check-buffer-trailing nil
118 "Test trailing whitespace for file in current buffer if t.")
119 (make-variable-buffer-local 'whitespace-check-buffer-trailing)
120 (put 'whitespace-check-buffer-trailing 'permanent-local nil)
121
122 (defvar whitespace-check-buffer-indent nil
123 "Test indentation whitespace for file in current buffer if t.")
124 (make-variable-buffer-local 'whitespace-check-buffer-indent)
125 (put 'whitespace-check-buffer-indent 'permanent-local nil)
126
127 (defvar whitespace-check-buffer-spacetab nil
128 "Test Space-followed-by-TABS whitespace for file in current buffer if t.")
129 (make-variable-buffer-local 'whitespace-check-buffer-spacetab)
130 (put 'whitespace-check-buffer-spacetab 'permanent-local nil)
131
132 (defvar whitespace-check-buffer-ateol nil
133 "Test end-of-line whitespace for file in current buffer if t.")
134 (make-variable-buffer-local 'whitespace-check-buffer-ateol)
135 (put 'whitespace-check-buffer-ateol 'permanent-local nil)
136
137 (defvar whitespace-highlighted-space nil
138 "The variable to store the extent to highlight.")
139 (make-variable-buffer-local 'whitespace-highlighted-space)
140 (put 'whitespace-highlighted-space 'permanent-local nil)
141
142 ;; For flavors of Emacs which don't define `defgroup' and `defcustom'.
143 (eval-when-compile
144 (if (not (fboundp 'defgroup))
145 (defmacro defgroup (sym memb doc &rest args)
146 "Null macro for `defgroup' in all versions of Emacs that don't define it."
147 t))
148 (if (not (fboundp 'defcustom))
149 (defmacro defcustom (sym val doc &rest args)
150 "Macro to alias `defcustom' to `defvar' in all versions of Emacs that
151 don't define it."
152 `(defvar ,sym ,val ,doc))))
153
154 (defalias 'whitespace-make-overlay
155 (if (featurep 'xemacs) 'make-extent 'make-overlay))
156 (defalias 'whitespace-overlay-put
157 (if (featurep 'xemacs) 'set-extent-property 'overlay-put))
158 (defalias 'whitespace-delete-overlay
159 (if (featurep 'xemacs) 'delete-extent 'delete-overlay))
160 (defalias 'whitespace-overlay-start
161 (if (featurep 'xemacs) 'extent-start 'overlay-start))
162 (defalias 'whitespace-overlay-end
163 (if (featurep 'xemacs) 'extent-end 'overlay-end))
164 (defalias 'whitespace-mode-line-update
165 (if (featurep 'xemacs) 'redraw-modeline 'force-mode-line-update))
166
167 (defgroup whitespace nil
168 "Check for and fix five different types of whitespaces in source code."
169 :version "21.1"
170 :link '(emacs-commentary-link "whitespace.el")
171 ;; Since XEmacs doesn't have a 'convenience group, use the next best group
172 ;; which is 'editing?
173 :group (if (featurep 'xemacs) 'editing 'convenience))
174
175 (defcustom whitespace-check-leading-whitespace t
176 "Flag to check leading whitespace. This is the global for the system.
177 It can be overriden by setting a buffer local variable
178 `whitespace-check-buffer-leading'."
179 :type 'boolean
180 :group 'whitespace)
181
182 (defcustom whitespace-check-trailing-whitespace t
183 "Flag to check trailing whitespace. This is the global for the system.
184 It can be overriden by setting a buffer local variable
185 `whitespace-check-buffer-trailing'."
186 :type 'boolean
187 :group 'whitespace)
188
189 (defcustom whitespace-check-spacetab-whitespace t
190 "Flag to check space followed by a TAB. This is the global for the system.
191 It can be overriden by setting a buffer local variable
192 `whitespace-check-buffer-spacetab'."
193 :type 'boolean
194 :group 'whitespace)
195
196 (defcustom whitespace-spacetab-regexp "[ ]+\t"
197 "Regexp to match a space followed by a TAB."
198 :type 'regexp
199 :group 'whitespace)
200
201 (defcustom whitespace-check-indent-whitespace indent-tabs-mode
202 "Flag to check indentation whitespace. This is the global for the system.
203 It can be overriden by setting a buffer local variable
204 `whitespace-check-buffer-indent'."
205 :type 'boolean
206 :group 'whitespace)
207
208 (defcustom whitespace-indent-regexp (concat "^\\(\t*\\) " " ")
209 "Regexp to match (any TABS followed by) 8/more whitespaces at start of line."
210 :type 'regexp
211 :group 'whitespace)
212
213 (defcustom whitespace-check-ateol-whitespace t
214 "Flag to check end-of-line whitespace. This is the global for the system.
215 It can be overriden by setting a buffer local variable
216 `whitespace-check-buffer-ateol'."
217 :type 'boolean
218 :group 'whitespace)
219
220 ;; (defcustom whitespace-ateol-regexp "[ \t]$"
221 (defcustom whitespace-ateol-regexp "[ \t]+$"
222 "Regexp to match a TAB or a space at the EOL."
223 :type 'regexp
224 :group 'whitespace)
225
226 (defcustom whitespace-errbuf "*Whitespace Errors*"
227 "The name of the buffer where whitespace related messages will be logged."
228 :type 'string
229 :group 'whitespace)
230
231 (defcustom whitespace-clean-msg "clean."
232 "If non-nil, this message will be displayed after a whitespace check
233 determines a file to be clean."
234 :type 'string
235 :group 'whitespace)
236
237 (defcustom whitespace-abort-on-error nil
238 "While writing a file, abort if the file is unclean.
239 If `whitespace-auto-cleanup' is set, that takes precedence over
240 this variable."
241 :type 'boolean
242 :group 'whitespace)
243
244 (defcustom whitespace-auto-cleanup nil
245 "Cleanup a buffer automatically on finding it whitespace unclean."
246 :type 'boolean
247 :group 'whitespace)
248
249 (defcustom whitespace-silent nil
250 "All whitespace errors will be shown only in the modeline when t.
251
252 Note that setting this may cause all whitespaces introduced in a file to go
253 unnoticed when the buffer is killed, unless the user visits the `*Whitespace
254 Errors*' buffer before opening (or closing) another file."
255 :type 'boolean
256 :group 'whitespace)
257
258 (defcustom whitespace-modes '(ada-mode asm-mode autoconf-mode awk-mode
259 c-mode c++-mode cc-mode
260 change-log-mode cperl-mode
261 electric-nroff-mode emacs-lisp-mode
262 f90-mode fortran-mode html-mode
263 html3-mode java-mode jde-mode
264 ksh-mode latex-mode LaTeX-mode
265 lisp-mode m4-mode makefile-mode
266 modula-2-mode nroff-mode objc-mode
267 pascal-mode perl-mode prolog-mode
268 python-mode scheme-mode sgml-mode
269 sh-mode shell-script-mode simula-mode
270 tcl-mode tex-mode texinfo-mode
271 vrml-mode xml-mode)
272
273 "Major modes in which we turn on whitespace checking.
274
275 These are mostly programming and documentation modes. But you may add other
276 modes that you want whitespaces checked in by adding something like the
277 following to your `.emacs':
278
279 \(setq whitespace-modes (cons 'my-mode (cons 'my-other-mode
280 whitespace-modes))\)
281
282 Or, alternately, you can use the Emacs `customize' command to set this."
283 :type '(repeat symbol)
284 :group 'whitespace)
285
286 (defcustom whitespace-rescan-timer-time 600
287 "Period in seconds to rescan modified buffers for whitespace creep.
288
289 This is the period after which the timer will fire causing
290 `whitespace-rescan-files-in-buffers' to check for whitespace creep in
291 modified buffers.
292
293 To disable timer scans, set this to zero."
294 :type 'integer
295 :group 'whitespace)
296
297 (defcustom whitespace-display-in-modeline t
298 "Display whitespace errors on the modeline."
299 :type 'boolean
300 :group 'whitespace)
301
302 (defcustom whitespace-display-spaces-in-color t
303 "Display the bogus whitespaces by coloring them with the face
304 `whitespace-highlight'."
305 :type 'boolean
306 :group 'whitespace)
307
308 (defgroup whitespace-faces nil
309 "Faces used in whitespace."
310 :prefix "whitespace-"
311 :group 'whitespace
312 :group 'faces)
313
314 (defface whitespace-highlight '((((class color) (background light))
315 (:background "green1"))
316 (((class color) (background dark))
317 (:background "sea green"))
318 (((class grayscale mono)
319 (background light))
320 (:background "black"))
321 (((class grayscale mono)
322 (background dark))
323 (:background "white")))
324 "Face used for highlighting the bogus whitespaces that exist in the buffer."
325 :group 'whitespace-faces)
326 ;; backward-compatibility alias
327 (put 'whitespace-highlight-face 'face-alias 'whitespace-highlight)
328
329 (if (not (assoc 'whitespace-mode minor-mode-alist))
330 (setq minor-mode-alist (cons '(whitespace-mode whitespace-mode-line)
331 minor-mode-alist)))
332
333 (set-default 'whitespace-check-buffer-leading
334 whitespace-check-leading-whitespace)
335 (set-default 'whitespace-check-buffer-trailing
336 whitespace-check-trailing-whitespace)
337 (set-default 'whitespace-check-buffer-indent
338 whitespace-check-indent-whitespace)
339 (set-default 'whitespace-check-buffer-spacetab
340 whitespace-check-spacetab-whitespace)
341 (set-default 'whitespace-check-buffer-ateol
342 whitespace-check-ateol-whitespace)
343
344 (defun whitespace-check-whitespace-mode (&optional arg)
345 "Test and set the whitespace-mode in qualifying buffers."
346 (if (null whitespace-mode)
347 (setq whitespace-mode
348 (if (or arg (member major-mode whitespace-modes))
349 t
350 nil))))
351
352 ;;;###autoload
353 (defun whitespace-toggle-leading-check ()
354 "Toggle the check for leading space in the local buffer."
355 (interactive)
356 (let ((current-val whitespace-check-buffer-leading))
357 (setq whitespace-check-buffer-leading (not current-val))
358 (message "Will%s check for leading space in buffer."
359 (if whitespace-check-buffer-leading "" " not"))
360 (if whitespace-check-buffer-leading (whitespace-buffer-leading))))
361
362 ;;;###autoload
363 (defun whitespace-toggle-trailing-check ()
364 "Toggle the check for trailing space in the local buffer."
365 (interactive)
366 (let ((current-val whitespace-check-buffer-trailing))
367 (setq whitespace-check-buffer-trailing (not current-val))
368 (message "Will%s check for trailing space in buffer."
369 (if whitespace-check-buffer-trailing "" " not"))
370 (if whitespace-check-buffer-trailing (whitespace-buffer-trailing))))
371
372 ;;;###autoload
373 (defun whitespace-toggle-indent-check ()
374 "Toggle the check for indentation space in the local buffer."
375 (interactive)
376 (let ((current-val whitespace-check-buffer-indent))
377 (setq whitespace-check-buffer-indent (not current-val))
378 (message "Will%s check for indentation space in buffer."
379 (if whitespace-check-buffer-indent "" " not"))
380 (if whitespace-check-buffer-indent
381 (whitespace-buffer-search whitespace-indent-regexp))))
382
383 ;;;###autoload
384 (defun whitespace-toggle-spacetab-check ()
385 "Toggle the check for space-followed-by-TABs in the local buffer."
386 (interactive)
387 (let ((current-val whitespace-check-buffer-spacetab))
388 (setq whitespace-check-buffer-spacetab (not current-val))
389 (message "Will%s check for space-followed-by-TABs in buffer."
390 (if whitespace-check-buffer-spacetab "" " not"))
391 (if whitespace-check-buffer-spacetab
392 (whitespace-buffer-search whitespace-spacetab-regexp))))
393
394
395 ;;;###autoload
396 (defun whitespace-toggle-ateol-check ()
397 "Toggle the check for end-of-line space in the local buffer."
398 (interactive)
399 (let ((current-val whitespace-check-buffer-ateol))
400 (setq whitespace-check-buffer-ateol (not current-val))
401 (message "Will%s check for end-of-line space in buffer."
402 (if whitespace-check-buffer-ateol "" " not"))
403 (if whitespace-check-buffer-ateol
404 (whitespace-buffer-search whitespace-ateol-regexp))))
405
406
407 ;;;###autoload
408 (defun whitespace-buffer (&optional quiet)
409 "Find five different types of white spaces in buffer.
410 These are:
411 1. Leading space \(empty lines at the top of a file\).
412 2. Trailing space \(empty lines at the end of a file\).
413 3. Indentation space \(8 or more spaces, that should be replaced with TABS\).
414 4. Spaces followed by a TAB. \(Almost always, we never want that\).
415 5. Spaces or TABS at the end of a line.
416
417 Check for whitespace only if this buffer really contains a non-empty file
418 and:
419 1. the major mode is one of the whitespace-modes, or
420 2. `whitespace-buffer' was explicitly called with a prefix argument."
421 (interactive)
422 (let ((whitespace-error nil))
423 (whitespace-check-whitespace-mode current-prefix-arg)
424 (if (and buffer-file-name (> (buffer-size) 0) whitespace-mode)
425 (progn
426 (whitespace-check-buffer-list (buffer-name) buffer-file-name)
427 (whitespace-tickle-timer)
428 (whitespace-unhighlight-the-space)
429 (if whitespace-auto-cleanup
430 (if buffer-read-only
431 (if (not quiet)
432 (message "Can't cleanup: %s is read-only" (buffer-name)))
433 (whitespace-cleanup))
434 (let ((whitespace-leading (if whitespace-check-buffer-leading
435 (whitespace-buffer-leading)
436 nil))
437 (whitespace-trailing (if whitespace-check-buffer-trailing
438 (whitespace-buffer-trailing)
439 nil))
440 (whitespace-indent (if whitespace-check-buffer-indent
441 (whitespace-buffer-search
442 whitespace-indent-regexp)
443 nil))
444 (whitespace-spacetab (if whitespace-check-buffer-spacetab
445 (whitespace-buffer-search
446 whitespace-spacetab-regexp)
447 nil))
448 (whitespace-ateol (if whitespace-check-buffer-ateol
449 (whitespace-buffer-search
450 whitespace-ateol-regexp)
451 nil))
452 (whitespace-errmsg nil)
453 (whitespace-filename buffer-file-name)
454 (whitespace-this-modeline ""))
455
456 ;; Now let's complain if we found any of the above.
457 (setq whitespace-error (or whitespace-leading whitespace-indent
458 whitespace-spacetab whitespace-ateol
459 whitespace-trailing))
460
461 (if whitespace-error
462 (progn
463 (setq whitespace-errmsg
464 (concat whitespace-filename " contains:\n"
465 (if whitespace-leading
466 "Leading whitespace\n")
467 (if whitespace-indent
468 (concat "Indentation whitespace"
469 whitespace-indent "\n"))
470 (if whitespace-spacetab
471 (concat "Space followed by Tab"
472 whitespace-spacetab "\n"))
473 (if whitespace-ateol
474 (concat "End-of-line whitespace"
475 whitespace-ateol "\n"))
476 (if whitespace-trailing
477 "Trailing whitespace\n")
478 "\ntype `M-x whitespace-cleanup' to "
479 "cleanup the file."))
480 (setq whitespace-this-modeline
481 (concat (if whitespace-ateol "e")
482 (if whitespace-indent "i")
483 (if whitespace-leading "l")
484 (if whitespace-spacetab "s")
485 (if whitespace-trailing "t")))))
486 (whitespace-update-modeline whitespace-this-modeline)
487 (if (get-buffer whitespace-errbuf)
488 (kill-buffer whitespace-errbuf))
489 (with-current-buffer (get-buffer-create whitespace-errbuf)
490 (if whitespace-errmsg
491 (progn
492 (insert whitespace-errmsg)
493 (if (not (or quiet whitespace-silent))
494 (display-buffer (current-buffer) t))
495 (if (not quiet)
496 (message "Whitespaces: [%s%s] in %s"
497 whitespace-this-modeline
498 (let ((whitespace-unchecked
499 (whitespace-unchecked-whitespaces)))
500 (if whitespace-unchecked
501 (concat "!" whitespace-unchecked)
502 ""))
503 whitespace-filename)))
504 (if (and (not quiet) (not (equal whitespace-clean-msg "")))
505 (message "%s %s" whitespace-filename
506 whitespace-clean-msg))))))))
507 whitespace-error))
508
509 ;;;###autoload
510 (defun whitespace-region (s e)
511 "Check the region for whitespace errors."
512 (interactive "r")
513 (save-excursion
514 (save-restriction
515 (narrow-to-region s e)
516 (whitespace-buffer))))
517
518 ;;;###autoload
519 (defun whitespace-cleanup ()
520 "Cleanup the five different kinds of whitespace problems.
521
522 Use \\[describe-function] whitespace-describe to read a summary of the
523 whitespace problems."
524 (interactive)
525 ;; If this buffer really contains a file, then run, else quit.
526 (whitespace-check-whitespace-mode current-prefix-arg)
527 (if (and buffer-file-name whitespace-mode)
528 (let ((whitespace-any nil)
529 (whitespace-tabwith 8)
530 (whitespace-tabwith-saved tab-width))
531
532 ;; since all printable TABS should be 8, irrespective of how
533 ;; they are displayed.
534 (setq tab-width whitespace-tabwith)
535
536 (if (and whitespace-check-buffer-leading
537 (whitespace-buffer-leading))
538 (progn
539 (whitespace-buffer-leading-cleanup)
540 (setq whitespace-any t)))
541
542 (if (and whitespace-check-buffer-trailing
543 (whitespace-buffer-trailing))
544 (progn
545 (whitespace-buffer-trailing-cleanup)
546 (setq whitespace-any t)))
547
548 (if (and whitespace-check-buffer-indent
549 (whitespace-buffer-search whitespace-indent-regexp))
550 (progn
551 (whitespace-indent-cleanup)
552 (setq whitespace-any t)))
553
554 (if (and whitespace-check-buffer-spacetab
555 (whitespace-buffer-search whitespace-spacetab-regexp))
556 (progn
557 (whitespace-buffer-cleanup whitespace-spacetab-regexp "\t")
558 (setq whitespace-any t)))
559
560 (if (and whitespace-check-buffer-ateol
561 (whitespace-buffer-search whitespace-ateol-regexp))
562 (progn
563 (whitespace-buffer-cleanup whitespace-ateol-regexp "")
564 (setq whitespace-any t)))
565
566 ;; Call this recursively till everything is taken care of
567 (if whitespace-any
568 (whitespace-cleanup)
569 (progn
570 (if (not whitespace-silent)
571 (message "%s clean" buffer-file-name))
572 (whitespace-update-modeline)))
573 (setq tab-width whitespace-tabwith-saved))))
574
575 ;;;###autoload
576 (defun whitespace-cleanup-region (s e)
577 "Whitespace cleanup on the region."
578 (interactive "r")
579 (save-excursion
580 (save-restriction
581 (narrow-to-region s e)
582 (whitespace-cleanup))
583 (whitespace-buffer t)))
584
585 (defun whitespace-buffer-leading ()
586 "Check to see if there are any empty lines at the top of the file."
587 (save-excursion
588 (let ((pmin nil)
589 (pmax nil))
590 (goto-char (point-min))
591 (beginning-of-line)
592 (setq pmin (point))
593 (end-of-line)
594 (setq pmax (point))
595 (if (equal pmin pmax)
596 (progn
597 (whitespace-highlight-the-space pmin (1+ pmax))
598 t)
599 nil))))
600
601 (defun whitespace-buffer-leading-cleanup ()
602 "Remove any empty lines at the top of the file."
603 (save-excursion
604 (goto-char (point-min))
605 (skip-chars-forward "\n")
606 (delete-region (point-min) (point))))
607
608 (defun whitespace-buffer-trailing ()
609 "Check to see if are is more than one empty line at the bottom."
610 (save-excursion
611 (let ((pmin nil)
612 (pmax nil))
613 (goto-char (point-max))
614 (beginning-of-line)
615 (setq pmin (point))
616 (end-of-line)
617 (setq pmax (point))
618 (if (equal pmin pmax)
619 (progn
620 (goto-char (- (point) 1))
621 (beginning-of-line)
622 (setq pmin (point))
623 (end-of-line)
624 (setq pmax (point))
625 (if (equal pmin pmax)
626 (progn
627 (whitespace-highlight-the-space (- pmin 1) pmax)
628 t)
629 nil))
630 nil))))
631
632 (defun whitespace-buffer-trailing-cleanup ()
633 "Delete all the empty lines at the bottom."
634 (save-excursion
635 (goto-char (point-max))
636 (skip-chars-backward "\n")
637 (if (not (bolp))
638 (forward-char 1))
639 (delete-region (point) (point-max))))
640
641 (defun whitespace-buffer-search (regexp)
642 "Search for any given whitespace REGEXP."
643 (let ((whitespace-retval ""))
644 (save-excursion
645 (goto-char (point-min))
646 (while (re-search-forward regexp nil t)
647 (progn
648 (setq whitespace-retval (format "%s %s" whitespace-retval
649 (match-beginning 0)))
650 (whitespace-highlight-the-space (match-beginning 0) (match-end 0))))
651 (if (equal "" whitespace-retval)
652 nil
653 whitespace-retval))))
654
655 (defun whitespace-buffer-cleanup (regexp newregexp)
656 "Search for any given whitespace REGEXP and replace it with the NEWREGEXP."
657 (save-excursion
658 (goto-char (point-min))
659 (while (re-search-forward regexp nil t)
660 (replace-match newregexp))))
661
662 (defun whitespace-indent-cleanup ()
663 "Search for 8/more spaces at the start of a line and replace it with tabs."
664 (save-excursion
665 (goto-char (point-min))
666 (while (re-search-forward whitespace-indent-regexp nil t)
667 (let ((column (current-column))
668 (indent-tabs-mode t))
669 (delete-region (match-beginning 0) (point))
670 (indent-to column)))))
671
672 (defun whitespace-unchecked-whitespaces ()
673 "Return the list of whitespaces whose testing has been suppressed."
674 (let ((unchecked-spaces
675 (concat (if (not whitespace-check-buffer-ateol) "e")
676 (if (not whitespace-check-buffer-indent) "i")
677 (if (not whitespace-check-buffer-leading) "l")
678 (if (not whitespace-check-buffer-spacetab) "s")
679 (if (not whitespace-check-buffer-trailing) "t"))))
680 (if (not (equal unchecked-spaces ""))
681 unchecked-spaces
682 nil)))
683
684 (defun whitespace-update-modeline (&optional whitespace-err)
685 "Update modeline with whitespace errors.
686 Also with whitespaces whose testing has been turned off."
687 (if whitespace-display-in-modeline
688 (progn
689 (setq whitespace-mode-line nil)
690 ;; Whitespace errors
691 (if (and whitespace-err (not (equal whitespace-err "")))
692 (setq whitespace-mode-line whitespace-err))
693 ;; Whitespace suppressed errors
694 (let ((whitespace-unchecked (whitespace-unchecked-whitespaces)))
695 (if whitespace-unchecked
696 (setq whitespace-mode-line
697 (concat whitespace-mode-line "!" whitespace-unchecked))))
698 ;; Add the whitespace modeline prefix
699 (setq whitespace-mode-line (if whitespace-mode-line
700 (concat " W:" whitespace-mode-line)
701 nil))
702 (whitespace-mode-line-update))))
703
704 (defun whitespace-highlight-the-space (b e)
705 "Highlight the current line, unhighlighting a previously jumped to line."
706 (if whitespace-display-spaces-in-color
707 (let ((ol (whitespace-make-overlay b e)))
708 (push ol whitespace-highlighted-space)
709 (whitespace-overlay-put ol 'face 'whitespace-highlight))))
710 ;; (add-hook 'pre-command-hook 'whitespace-unhighlight-the-space))
711
712 (defun whitespace-unhighlight-the-space()
713 "Unhighlight the currently highlight line."
714 (if (and whitespace-display-spaces-in-color whitespace-highlighted-space)
715 (progn
716 (mapc 'whitespace-delete-overlay whitespace-highlighted-space)
717 (setq whitespace-highlighted-space nil))
718 (remove-hook 'pre-command-hook 'whitespace-unhighlight-the-space)))
719
720 (defun whitespace-check-buffer-list (buf-name buf-file)
721 "Add a buffer and its file to the whitespace monitor list.
722
723 The buffer named BUF-NAME and its associated file BUF-FILE are now monitored
724 periodically for whitespace."
725 (if (and whitespace-mode (not (member (list buf-file buf-name)
726 whitespace-all-buffer-files)))
727 (add-to-list 'whitespace-all-buffer-files (list buf-file buf-name))))
728
729 (defun whitespace-tickle-timer ()
730 "Tickle timer to periodically to scan qualifying files for whitespace creep.
731
732 If timer is not set, then set it to scan the files in
733 `whitespace-all-buffer-files' periodically (defined by
734 `whitespace-rescan-timer-time') for whitespace creep."
735 (if (and whitespace-rescan-timer-time (not whitespace-rescan-timer))
736 (setq whitespace-rescan-timer
737 (add-timeout whitespace-rescan-timer-time
738 'whitespace-rescan-files-in-buffers nil
739 whitespace-rescan-timer-time))))
740
741 (defun whitespace-rescan-files-in-buffers (&optional arg)
742 "Check monitored files for whitespace creep since last scan."
743 (let ((whitespace-all-my-files whitespace-all-buffer-files)
744 buffile bufname thiselt buf)
745 (if (not whitespace-all-my-files)
746 (progn
747 (disable-timeout whitespace-rescan-timer)
748 (setq whitespace-rescan-timer nil))
749 (while whitespace-all-my-files
750 (setq thiselt (car whitespace-all-my-files))
751 (setq whitespace-all-my-files (cdr whitespace-all-my-files))
752 (setq buffile (car thiselt))
753 (setq bufname (cadr thiselt))
754 (setq buf (get-buffer bufname))
755 (if (buffer-live-p buf)
756 (save-excursion
757 ;;(message "buffer %s live" bufname)
758 (set-buffer bufname)
759 (if whitespace-mode
760 (progn
761 ;;(message "checking for whitespace in %s" bufname)
762 (if whitespace-auto-cleanup
763 (progn
764 ;;(message "cleaning up whitespace in %s" bufname)
765 (whitespace-cleanup))
766 (progn
767 ;;(message "whitespace-buffer %s." (buffer-name))
768 (whitespace-buffer t))))
769 ;;(message "Removing %s from refresh list" bufname)
770 (whitespace-refresh-rescan-list buffile bufname)))
771 ;;(message "Removing %s from refresh list" bufname)
772 (whitespace-refresh-rescan-list buffile bufname))))))
773
774 (defun whitespace-refresh-rescan-list (buffile bufname)
775 "Refresh the list of files to be rescaned for whitespace creep."
776 (if whitespace-all-buffer-files
777 (setq whitespace-all-buffer-files
778 (delete (list buffile bufname) whitespace-all-buffer-files))
779 (when whitespace-rescan-timer
780 (disable-timeout whitespace-rescan-timer)
781 (setq whitespace-rescan-timer nil))))
782
783 ;;;###autoload
784 (defalias 'global-whitespace-mode 'whitespace-global-mode)
785
786 ;;;###autoload
787 (define-minor-mode whitespace-global-mode
788 "Toggle using Whitespace mode in new buffers.
789 With ARG, turn the mode on iff ARG is positive.
790
791 When this mode is active, `whitespace-buffer' is added to
792 `find-file-hook' and `kill-buffer-hook'."
793 :global t
794 :group 'whitespace
795 (if whitespace-global-mode
796 (progn
797 (add-hook 'find-file-hook 'whitespace-buffer)
798 (add-hook 'write-file-functions 'whitespace-write-file-hook nil t)
799 (add-hook 'kill-buffer-hook 'whitespace-buffer))
800 (remove-hook 'find-file-hook 'whitespace-buffer)
801 (remove-hook 'write-file-functions 'whitespace-write-file-hook t)
802 (remove-hook 'kill-buffer-hook 'whitespace-buffer)))
803
804 ;;;###autoload
805 (defun whitespace-write-file-hook ()
806 "Hook function to be called on the buffer when whitespace check is enabled.
807 This is meant to be added buffer-locally to `write-file-functions'."
808 (interactive)
809 (let ((werr nil))
810 (if whitespace-auto-cleanup
811 (whitespace-cleanup)
812 (setq werr (whitespace-buffer)))
813 (if (and whitespace-abort-on-error werr)
814 (error (concat "Abort write due to whitespaces in "
815 buffer-file-name))))
816 nil)
817
818 (defun whitespace-unload-hook ()
819 (remove-hook 'find-file-hook 'whitespace-buffer)
820 (remove-hook 'write-file-functions 'whitespace-write-file-hook t)
821 (remove-hook 'kill-buffer-hook 'whitespace-buffer))
822
823 (add-hook 'whitespace-unload-hook 'whitespace-unload-hook)
824
825 (provide 'whitespace)
826
827 ;; arch-tag: 4ff44e87-b63c-402d-95a6-15e51e58bd0c
828 ;;; whitespace.el ends here