| blob | defd18b35aa396751a9befb2ea90487adc3aa01c |
1 ;;; whitespace.el --- warn about and clean bogus whitespaces in the file
3 ;; Copyright (C) 1999-2017 Free Software Foundation, Inc.
5 ;; Author: Rajesh Vaidheeswarran <rv@gnu.org>
6 ;; Keywords: convenience
7 ;; Obsolete-since: 23.1
9 ;; This file is part of GNU Emacs.
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 3 of the License, or
14 ;; (at your option) any later version.
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.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
24 ;;; Commentary:
26 ;; URL: http://www.dsmit.com/lisp/
27 ;;
28 ;; The whitespace library is intended to find and help fix five different types
29 ;; of whitespace problems that commonly exist in source code.
30 ;;
31 ;; 1. Leading space (empty lines at the top of a file).
32 ;; 2. Trailing space (empty lines at the end of a file).
33 ;; 3. Indentation space (8 or more spaces at beginning of line, that should be
34 ;; replaced with TABS).
35 ;; 4. Spaces followed by a TAB. (Almost always, we never want that).
36 ;; 5. Spaces or TABS at the end of a line.
37 ;;
38 ;; Whitespace errors are reported in a buffer, and on the mode line.
39 ;;
40 ;; Mode line will show a W:<x>!<y> to denote a particular type of whitespace,
41 ;; where `x' and `y' can be one (or more) of:
42 ;;
43 ;; e - End-of-Line whitespace.
44 ;; i - Indentation whitespace.
45 ;; l - Leading whitespace.
46 ;; s - Space followed by Tab.
47 ;; t - Trailing whitespace.
48 ;;
49 ;; If any of the whitespace checks is turned off, the mode line will display a
50 ;; !<y>.
51 ;;
52 ;; (since (3) is the most controversial one, here is the rationale: Most
53 ;; terminal drivers and printer drivers have TAB configured or even
54 ;; hardcoded to be 8 spaces. (Some of them allow configuration, but almost
55 ;; always they default to 8.)
56 ;;
57 ;; Changing `tab-width' to other than 8 and editing will cause your code to
58 ;; look different from within Emacs, and say, if you cat it or more it, or
59 ;; even print it.
60 ;;
61 ;; Almost all the popular programming modes let you define an offset (like
62 ;; c-basic-offset or perl-indent-level) to configure the offset, so you
63 ;; should never have to set your `tab-width' to be other than 8 in all
64 ;; these modes. In fact, with an indent level of say, 4, 2 TABS will cause
65 ;; Emacs to replace your 8 spaces with one \t (try it). If vi users in
66 ;; your office complain, tell them to use vim, which distinguishes between
67 ;; tabstop and shiftwidth (vi equivalent of our offsets), and also ask them
68 ;; to set smarttab.)
69 ;;
70 ;; All the above have caused (and will cause) unwanted codeline integration and
71 ;; merge problems.
72 ;;
73 ;; whitespace.el will complain if it detects whitespaces on opening a file, and
74 ;; warn you on closing a file also (in case you had inserted any
75 ;; whitespaces during the process of your editing).
76 ;;
77 ;; Exported functions:
78 ;;
79 ;; `whitespace-buffer' - To check the current buffer for whitespace problems.
80 ;; `whitespace-cleanup' - To cleanup all whitespaces in the current buffer.
81 ;; `whitespace-region' - To check between point and mark for whitespace
82 ;; problems.
83 ;; `whitespace-cleanup-region' - To cleanup all whitespaces between point
84 ;; and mark in the current buffer.
86 ;;; Code:
91 "An associated list of buffers and files checked for whitespace cleanliness.
93 This is to enable periodic checking of whitespace cleanliness in the files
99 ;; Tell Emacs about this new kind of minor mode
111 ;;;###autoload(put 'whitespace-check-buffer-leading 'safe-local-variable 'booleanp)
116 ;;;###autoload(put 'whitespace-check-buffer-trailing 'safe-local-variable 'booleanp)
121 ;;;###autoload(put 'whitespace-check-buffer-indent 'safe-local-variable 'booleanp)
126 ;;;###autoload(put 'whitespace-check-buffer-spacetab 'safe-local-variable 'booleanp)
131 ;;;###autoload(put 'whitespace-check-buffer-ateol 'safe-local-variable 'booleanp)
151 "Check for and fix five different types of whitespaces in source code."
154 ;; Since XEmacs doesn't have a 'convenience group, use the next best group
155 ;; which is 'editing?
159 "Flag to check leading whitespace. This is the global for the system.
160 It can be overridden by setting a buffer local variable
161 `whitespace-check-buffer-leading'."
166 "Flag to check trailing whitespace. This is the global for the system.
167 It can be overridden by setting a buffer local variable
168 `whitespace-check-buffer-trailing'."
173 "Flag to check space followed by a TAB. This is the global for the system.
174 It can be overridden by setting a buffer local variable
175 `whitespace-check-buffer-spacetab'."
180 "Regexp to match one or more spaces followed by a TAB."
185 "Flag to check indentation whitespace. This is the global for the system.
186 It can be overridden by setting a buffer local variable
187 `whitespace-check-buffer-indent'."
192 "Regexp to match multiples of eight spaces near line beginnings.
193 The default value ignores leading TABs."
198 "Flag to check end-of-line whitespace. This is the global for the system.
199 It can be overridden by setting a buffer local variable
200 `whitespace-check-buffer-ateol'."
205 "Regexp to match one or more TABs or spaces at line ends."
210 "The name of the buffer where whitespace related messages will be logged."
215 "If non-nil, this message will be displayed after a whitespace check
216 determines a file to be clean."
221 "While writing a file, abort if the file is unclean.
222 If `whitespace-auto-cleanup' is set, that takes precedence over
223 this variable."
228 "Cleanup a buffer automatically on finding it whitespace unclean."
233 "All whitespace errors will be shown only in the mode line when t.
235 Note that setting this may cause all whitespaces introduced in a file to go
236 unnoticed when the buffer is killed, unless the user visits the `*Whitespace
237 Errors*' buffer before opening (or closing) another file."
242 c-mode c++-mode cc-mode
243 change-log-mode cperl-mode
244 electric-nroff-mode emacs-lisp-mode
245 f90-mode fortran-mode html-mode
246 html3-mode java-mode jde-mode
247 ksh-mode latex-mode LaTeX-mode
248 lisp-mode m4-mode makefile-mode
249 modula-2-mode nroff-mode objc-mode
250 pascal-mode perl-mode prolog-mode
251 python-mode scheme-mode sgml-mode
252 sh-mode shell-script-mode simula-mode
253 tcl-mode tex-mode texinfo-mode
254 vrml-mode xml-mode)
256 "Major modes in which we turn on whitespace checking.
258 These are mostly programming and documentation modes. But you may add other
259 modes that you want whitespaces checked in by adding something like the
260 following to your `.emacs':
263 whitespace-modes))\)
265 Or, alternately, you can use the Emacs `customize' command to set this."
270 "Period in seconds to rescan modified buffers for whitespace creep.
272 This is the period after which the timer will fire causing
273 `whitespace-rescan-files-in-buffers' to check for whitespace creep in
274 modified buffers.
276 To disable timer scans, set this to zero."
281 "Display whitespace errors on the modeline."
286 "Display the bogus whitespaces by coloring them with the face
287 `whitespace-highlight'."
301 "Face used for highlighting the bogus whitespaces that exist in the buffer."
306 minor-mode-alist)))
309 whitespace-check-leading-whitespace)
311 whitespace-check-trailing-whitespace)
313 whitespace-check-indent-whitespace)
315 whitespace-check-spacetab-whitespace)
317 whitespace-check-ateol-whitespace)
320 "Test and set the whitespace-mode in qualifying buffers."
324 t
325 nil))))
327 ;;;###autoload
329 "Toggle the check for leading space in the local buffer."
337 ;;;###autoload
339 "Toggle the check for trailing space in the local buffer."
347 ;;;###autoload
349 "Toggle the check for indentation space in the local buffer."
358 ;;;###autoload
360 "Toggle the check for space-followed-by-TABs in the local buffer."
370 ;;;###autoload
372 "Toggle the check for end-of-line space in the local buffer."
382 ;;;###autoload
384 "Find five different types of white spaces in buffer.
385 These are:
386 1. Leading space \(empty lines at the top of a file\).
387 2. Trailing space \(empty lines at the end of a file\).
388 3. Indentation space \(8 or more spaces, that should be replaced with TABS\).
389 4. Spaces followed by a TAB. \(Almost always, we never want that\).
390 5. Spaces or TABS at the end of a line.
392 Check for whitespace only if this buffer really contains a non-empty file
393 and:
394 1. the major mode is one of the whitespace-modes, or
395 2. `whitespace-buffer' was explicitly called with a prefix argument."
412 nil))
415 nil))
418 whitespace-indent-regexp)
419 nil))
422 whitespace-spacetab-regexp)
423 nil))
426 whitespace-ateol-regexp)
427 nil))
432 ;; Now let's complain if we found any of the above.
434 whitespace-spacetab whitespace-ateol
435 whitespace-trailing))
473 whitespace-this-modeline
479 whitespace-filename)))
482 whitespace-clean-msg))))))))
483 whitespace-error))
485 ;;;###autoload
487 "Check the region for whitespace errors."
494 ;;;###autoload
496 "Cleanup the five different kinds of whitespace problems.
497 It normally applies to the whole buffer, but in Transient Mark mode
498 when the mark is active it applies to the region.
499 See `whitespace-buffer' docstring for a summary of the problems."
506 ;; If this buffer really contains a file, then run, else quit.
513 ;; since all printable TABS should be 8, irrespective of how
514 ;; they are displayed.
547 ;; Call this recursively till everything is taken care of
550 ;; if we are done, talk to the user
559 ;;;###autoload
561 "Whitespace cleanup on the region."
570 "Return t if the current buffer has leading newline characters.
571 If highlighting is enabled, highlight these characters."
577 t)))
580 "Remove any leading newline characters from current buffer."
587 "Return t if the current buffer has extra trailing newline characters.
588 If highlighting is enabled, highlight these characters."
595 t)))
598 "Remove extra trailing newline characters from current buffer."
607 "Search for any given whitespace REGEXP."
619 "Search for any given whitespace REGEXP and replace it with the NEWREGEXP."
626 "Search for 8/more spaces at the start of a line and replace it with tabs."
636 "Return the list of whitespaces whose testing has been suppressed."
644 unchecked-spaces
645 nil)))
648 "Update mode line with whitespace errors.
649 Also with whitespaces whose testing has been turned off."
653 ;; Whitespace errors
656 ;; Whitespace suppressed errors
661 ;; Add the whitespace modeline prefix
664 nil))
668 "Highlight the current line, unhighlighting a previously jumped to line."
674 "Unhighlight the currently highlight line."
681 "Add a buffer and its file to the whitespace monitor list.
683 The buffer named BUF-NAME and its associated file BUF-FILE are now monitored
684 periodically for whitespace."
686 whitespace-all-buffer-files)))
690 "Tickle timer to periodically to scan qualifying files for whitespace creep.
692 If timer is not set, then set it to scan the files in
693 `whitespace-all-buffer-files' periodically (defined by
694 `whitespace-rescan-timer-time') for whitespace creep."
700 'whitespace-rescan-files-in-buffers nil
701 whitespace-rescan-timer-time))))
704 "Check monitored files for whitespace creep since last scan."
706 buffile bufname thiselt buf)
719 ;;(message "buffer %s live" bufname)
722 ;;(message "checking for whitespace in %s" bufname)
725 ;;(message "cleaning up whitespace in %s" bufname)
728 ;;(message "whitespace-buffer %s." (buffer-name))
730 ;;(message "Removing %s from refresh list" bufname)
732 ;;(message "Removing %s from refresh list" bufname)
736 "Refresh the list of files to be rescanned for whitespace creep."
744 ;;;###autoload
747 ;;;###autoload
749 "Toggle using Whitespace mode in new buffers.
750 With ARG, turn the mode on if ARG is positive, otherwise turn it off.
752 When this mode is active, `whitespace-buffer' is added to
753 `find-file-hook' and `kill-buffer-hook'."
754 :global t
765 ;;;###autoload
767 "Hook function to be called on the buffer when whitespace check is enabled.
768 This is meant to be added buffer-locally to `write-file-functions'."
775 buffer-file-name)))
776 nil)
779 "Unload the whitespace library."
781 ;; if whitespace-unload-hook is defined, let's get rid of it
782 ;; and recursively call `unload-feature'
784 ;; this only happens in the recursive call
790 ;; continue standard unloading
791 nil))
802 ;;; whitespace.el ends here