1 ;;; ispell.el --- this is the GNU EMACS interface to GNU ISPELL version 4.
3 ;;Copyright (C) 1990, 1991, 1993 Free Software Foundation, Inc.
7 ;;This file is part of GNU Emacs.
9 ;;GNU Emacs is free software; you can redistribute it and/or modify
10 ;;it under the terms of the GNU General Public License as published by
11 ;;the Free Software Foundation; either version 2, or (at your option)
14 ;;GNU Emacs is distributed in the hope that it will be useful,
15 ;;but WITHOUT ANY WARRANTY; without even the implied warranty of
16 ;;MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 ;;GNU General Public License for more details.
19 ;;You should have received a copy of the GNU General Public License
20 ;;along with GNU Emacs; see the file COPYING. If not, write to
21 ;;the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
25 ;; This package provides a graceful interface to ispell, the GNU
30 (defvar ispell-have-new-look t
31 "Non-nil means use the `-r' option when running `look'.")
33 (defvar ispell-enable-tex-parser nil
34 "Non-nil enables experimental TeX parser in Ispell for TeX-mode buffers.")
36 (defvar ispell-process nil
"The process running Ispell")
37 (defvar ispell-next-message nil
38 "An integer: where in `*ispell*' buffer to find next message from Ispell.")
40 (defvar ispell-command
"ispell"
41 "Command for running Ispell.")
42 (defvar ispell-command-options nil
43 "*String (or list of strings) to pass to Ispell as command arguments.
44 You can specify your private dictionary via the -p <filename> option.
45 The -S option is always passed to Ispell as the last parameter,
46 and need not be mentioned here.")
48 (defvar ispell-look-command
"look"
49 "*Command for running look.")
51 ;Each marker in this list points to the start of a word that
52 ;ispell thought was bad last time it did the :file command.
53 ;Notice that if the user accepts or inserts a word into his
54 ;private dictionary, then some "good" words will be on the list.
55 ;We would like to deal with this by looking up the words again just before
56 ;presenting them to the user, but that is too slow on machines
57 ;without the select system call. Therefore, see the variable
58 ;ispell-recently-accepted.
59 (defvar ispell-bad-words nil
60 "A list of markers reflecting the output of the Ispell `:file' command.")
62 ;list of words that the user has accepted, but that might still
63 ;be on the bad-words list
64 (defvar ispell-recently-accepted nil
)
66 ;; Non-nil means we have started showing an alternatives window.
67 ;; This is the window config from before then.
68 (defvar ispell-window-configuration nil
)
70 ;t when :dump command needed
71 (defvar ispell-dump-needed nil
)
73 (defun ispell-flush-bad-words ()
74 (while ispell-bad-words
75 (if (markerp (car ispell-bad-words
))
76 (set-marker (car ispell-bad-words
) nil
))
77 (setq ispell-bad-words
(cdr ispell-bad-words
)))
78 (setq ispell-recently-accepted nil
))
81 "Kill the Ispell process.
82 Any changes in your private dictionary
83 that have not already been dumped will be lost."
86 (delete-process ispell-process
))
87 (setq ispell-process nil
)
88 (ispell-flush-bad-words))
90 (put 'ispell-startup-error
'error-conditions
91 '(ispell-startup-error error
))
92 (put 'ispell-startup-error
'error-message
93 "Problem starting ispell - see buffer *ispell*")
95 ;; Start an ispell subprocess; check the version; and display the greeting.
97 (defun start-ispell ()
98 (message "Starting ispell ...")
99 (let ((buf (get-buffer "*ispell*")))
104 (apply 'start-process
"ispell" "*ispell*" ispell-command
105 (append (if (listp ispell-command-options
)
106 ispell-command-options
107 (list ispell-command-options
))
109 (file-error (signal 'ispell-startup-error nil
)))
110 (process-kill-without-query ispell-process
)
111 (buffer-disable-undo (process-buffer ispell-process
))
112 (accept-process-output ispell-process
)
115 (set-buffer (process-buffer ispell-process
))
116 (bury-buffer (current-buffer))
117 (setq last-char
(- (point-max) 1))
118 (while (not (eq (char-after last-char
) ?
=))
119 (cond ((not (eq (process-status ispell-process
) 'run
))
121 (signal 'ispell-startup-error nil
)))
122 (accept-process-output ispell-process
)
123 (setq last-char
(- (point-max) 1)))
124 (goto-char (point-min))
125 (let ((greeting (read (current-buffer))))
126 (if (not (= (car greeting
) 1))
127 (error "Bad ispell version: wanted 1, got %d" (car greeting
)))
128 (message (car (cdr greeting
))))
129 (delete-region (point-min) last-char
))))
131 ;; Make sure ispell is ready for a command.
132 ;; Leaves buffer set to *ispell*, point at '='.
134 (defun ispell-sync (intr)
135 (if (or (null ispell-process
)
136 (not (eq (process-status ispell-process
) 'run
)))
139 (interrupt-process ispell-process
))
141 (set-buffer (process-buffer ispell-process
))
142 (bury-buffer (current-buffer))
143 (setq last-char
(- (point-max) 1))
144 (while (not (eq (char-after last-char
) ?
=))
145 (accept-process-output ispell-process
)
146 (setq last-char
(- (point-max) 1)))
147 (goto-char last-char
)))
149 ;; Send a command to ispell. Choices are:
151 ;; WORD Check spelling of WORD. Result is
155 ;; list of strings near misses
157 ;; :file FILENAME scan the named file, and print the file offsets of
158 ;; any misspelled words
160 ;; :insert WORD put word in private dictionary
162 ;; :accept WORD don't complain about word any more this session
164 ;; :dump write out the current private dictionary, if necessary.
166 ;; :reload reread private dictionary (default: `~/ispell.words')
170 ;; :generic set type of parser to use when scanning whole files
172 (defun ispell-cmd (&rest strings
)
175 (set-buffer (process-buffer ispell-process
))
176 (bury-buffer (current-buffer))
178 (setq ispell-next-message
(point-min))
180 (process-send-string ispell-process
(car strings
))
181 (setq strings
(cdr strings
)))
182 (process-send-string ispell-process
"\n")
183 (accept-process-output ispell-process
)
186 (defun ispell-dump ()
187 (cond (ispell-dump-needed
188 (setq ispell-dump-needed nil
)
189 (ispell-cmd ":dump"))))
191 (defun ispell-insert (word)
192 (ispell-cmd ":insert " word
)
194 (setq ispell-recently-accepted
(cons word ispell-recently-accepted
)))
195 (setq ispell-dump-needed t
))
197 (defun ispell-accept (word)
198 (ispell-cmd ":accept " word
)
200 (setq ispell-recently-accepted
(cons word ispell-recently-accepted
))))
202 ;; Return the next message sent by the Ispell subprocess.
204 (defun ispell-next-message ()
206 (set-buffer (process-buffer ispell-process
))
207 (bury-buffer (current-buffer))
209 (goto-char ispell-next-message
)
210 (narrow-to-region (point)
211 (progn (forward-sexp 1) (point)))
212 (setq ispell-next-message
(point))
213 (goto-char (point-min))
214 (read (current-buffer)))))
216 (defun ispell-tex-buffer-p ()
217 (memq major-mode
'(plain-TeX-mode LaTeX-mode
)))
219 (defvar ispell-menu-map
(make-sparse-keymap "Spell"))
220 (defalias 'ispell-menu-map ispell-menu-map
)
222 (define-key ispell-menu-map
[ispell-complete-word-interior-frag
]
223 '("Complete Interior Fragment" . ispell-complete-word-interior-frag
))
225 (define-key ispell-menu-map
[ispell-complete-word
]
226 '("Complete Word" . ispell-complete-word
))
228 (define-key ispell-menu-map
[reload-ispell
]
229 '("Reload Dictionary" . reload-ispell
))
231 (define-key ispell-menu-map
[ispell-next
]
232 '("Continue Check" . ispell-next
))
234 (define-key ispell-menu-map
[ispell-message
]
235 '("Check Message" . ispell-message
))
237 (define-key ispell-menu-map
[ispell-region
]
238 '("Check Region" . ispell-region
))
240 (define-key ispell-menu-map
[ispell-buffer
]
241 '("Check Buffer" . ispell
))
243 (define-key ispell-menu-map
[ispell-word
]
244 '("Check Word" . ispell-word
))
247 (defun ispell (&optional buf start end
)
248 "Run Ispell over current buffer's visited file.
249 First the file is scanned for misspelled words, then Ispell
250 enters a loop with the following commands for every misspelled word:
252 DIGIT Near miss selector. If the misspelled word is close to
253 some words in the dictionary, they are offered as near misses.
254 r Replace. Replace the word with a string you type. Each word
255 of your new string is also checked.
256 i Insert. Insert this word in your private dictionary (by default,
257 `$HOME/ispell.words').
258 a Accept. Accept this word for the rest of this editing session,
259 but don't put it in your private dictionary.
260 l Lookup. Look for a word in the dictionary by fast binary
261 search, or search for a regular expression in the dictionary
263 SPACE Accept the word this time, but complain if it is seen again.
264 q, \\[keyboard-quit] Leave the command loop. You can come back later with \\[ispell-next]."
272 (setq buf
(current-buffer)))
273 (setq buf
(get-buffer buf
))
275 (error "Can't find buffer"))
276 ;; Deactivate the mark, because we'll do it anyway if we change something,
277 ;; and a region highlight while in the Ispell loop is distracting.
281 (let ((filename buffer-file-name
)
285 (cond ((or (null filename
)
286 (find-file-name-handler buffer-file-name nil
))
287 (setq filename
(make-temp-name "/usr/tmp/ispell"))
289 (write-region (point-min) (point-max) filename
))
290 ((and (buffer-modified-p buf
)
291 (y-or-n-p (format "Save file %s? " filename
)))
293 (message "Ispell scanning file...")
294 (if (and ispell-enable-tex-parser
295 (ispell-tex-buffer-p))
297 (ispell-cmd ":generic"))
298 (ispell-cmd (format ":file %s %d %d" filename start end
)))
301 (delete-file filename
)
303 (message "Parsing ispell output ...")
304 (ispell-flush-bad-words)
306 (while (numberp (setq pos
(ispell-next-message)))
307 ;;ispell may check the words on the line following the end
308 ;;of the region - therefore, don't record anything out of range
311 (setq bad-words
(cons (set-marker (make-marker) (+ pos
1))
313 (setq bad-words
(cons pos bad-words
))
314 (setq ispell-bad-words
(nreverse bad-words
))))
315 (cond ((not (markerp (car ispell-bad-words
)))
316 (setq ispell-bad-words nil
)
317 (message "No misspellings.")
320 (message "Ispell parsing done.")
324 (defalias 'ispell-buffer
'ispell
)
326 (defun ispell-next ()
327 "Resume command loop for most recent Ispell command.
328 Return value is t unless exit is due to typing `q'."
330 (setq ispell-window-configuration nil
)
334 ;; There used to be a save-excursion here,
335 ;; but that was annoying: it's better if point doesn't move
338 (while (markerp (setq next
(car ispell-bad-words
)))
339 (switch-to-buffer (marker-buffer next
))
341 (ispell-point next
"at saved position.")
342 (setq ispell-bad-words
(cdr ispell-bad-words
))
343 (set-marker next nil
)))
346 (if ispell-window-configuration
347 (set-window-configuration ispell-window-configuration
))
348 (cond ((null ispell-bad-words
)
349 (error "Ispell has not yet been run"))
350 ((markerp (car ispell-bad-words
))
351 (message (substitute-command-keys
352 "Type \\[ispell-next] to continue")))
353 ((eq (car ispell-bad-words
) nil
)
354 (setq ispell-bad-words nil
)
355 (message "No more misspellings (but checker was interrupted)"))
356 ((eq (car ispell-bad-words
) t
)
357 (setq ispell-bad-words nil
)
358 (message "Ispell done"))
360 (setq ispell-bad-words nil
)
361 (message "Bad ispell internal list"))))
365 (defun ispell-word (&optional resume
)
366 "Check the spelling of the word under the cursor.
367 See the command `ispell' for more information.
368 With a prefix argument, resume handling of the previous Ispell command."
374 (save-window-excursion
375 (ispell-point (point) "at point."))
377 (ispell-startup-error
378 (cond ((y-or-n-p "Problem starting ispell, use old-style spell instead? ")
379 (load-library "spell")
380 (define-key esc-map
"$" 'spell-word
)
383 ;;;###autoload (define-key esc-map "$" 'ispell-word)
386 (defun ispell-region (start &optional end
)
387 "Check the spelling for all of the words in the region."
389 (ispell (current-buffer) start end
))
391 (defun ispell-letterp (c)
393 (or (and (>= c ?A
) (<= c ?Z
))
394 (and (>= c ?a
) (<= c ?z
))
397 (defun ispell-letter-or-quotep (c)
399 (or (and (>= c ?A
) (<= c ?Z
))
400 (and (>= c ?a
) (<= c ?z
))
404 (defun ispell-find-word-start ()
405 ;;backward to a letter
406 (if (not (ispell-letterp (char-after (point))))
407 (while (and (not (bobp))
408 (not (ispell-letterp (char-after (- (point) 1)))))
410 ;;backward to beginning of word
411 (while (ispell-letter-or-quotep (char-after (- (point) 1)))
413 (skip-chars-forward "'"))
415 (defun ispell-find-word-end ()
416 (while (ispell-letter-or-quotep (char-after (point)))
418 (skip-chars-backward "'"))
420 (defun ispell-next-word ()
421 (while (and (not (eobp))
422 (not (ispell-letterp (char-after (point)))))
425 ;if end is nil, then do one word at start
426 ;otherwise, do all words from the beginning of the word where
427 ;start points, to the end of the word where end points
428 (defun ispell-point (start message
)
429 (let ((wend (make-marker))
432 ;; There used to be a save-excursion here,
433 ;; but that was annoying: it's better if point doesn't move
436 (ispell-find-word-start) ;find correct word start
437 (setq start
(point-marker))
438 (ispell-find-word-end) ;now find correct end
439 (setq end
(point-marker))
440 ;; Do nothing if we don't find a word.
444 (ispell-find-word-end) ;find end of current word
445 ;could be before 'end' if
446 ;user typed replacement
447 ;that is more than one word
448 (set-marker wend
(point))
450 (setq word
(buffer-substring start wend
))
451 (cond ((ispell-still-bad word
)
452 ;;; This just causes confusion. -- rms.
453 ;;; (goto-char start)
455 (message (format "Ispell checking %s" word
))
457 (let ((message (ispell-next-message)))
458 (cond ((eq message t
)
459 (message "%s: ok" word
))
463 (ispell-command-loop word start wend message
)))
465 (error "unknown ispell response %s" message
))))))
469 (set-marker start
(point))))))
470 ;;clear the choices buffer; otherwise it's hard for the user to tell
471 ;;when we get back to the command loop
472 (let ((buf (get-buffer "*ispell choices*")))
476 (set-marker start nil
)
478 (set-marker wend nil
)))
480 (defun ispell-still-bad (word)
481 (let ((words ispell-recently-accepted
)
483 (case-fold-search t
))
485 (cond ((eq (string-match (car words
) word
) 0)
488 (setq words
(cdr words
)))
491 (defun ispell-show-choices (word message first-line
)
492 ;;if there is only one window on the frame, make the ispell
493 ;;messages winow be small. otherwise just use the other window
494 (let* ((selwin (selected-window))
495 (resize (eq selwin
(next-window)))
496 (buf (get-buffer-create "*ispell choices*"))
498 (or ispell-window-configuration
499 (setq ispell-window-configuration
(current-window-configuration)))
500 (setq w
(display-buffer buf
))
501 (buffer-disable-undo buf
)
506 (enlarge-window (- 6 (window-height w
))))
507 (select-window selwin
)))
511 (set-window-point w
(point-min))
512 (set-window-start w
(point-min))
514 (insert first-line
"\n")
516 "SPC skip; A accept; I insert; DIGIT select; R replace; \
518 (cond ((not (null message
))
523 (let* ((n (+ (* j
3) i
))
524 (choice (nth n message
)))
526 (let ((str (format "%d %s" n choice
)))
528 (insert-char ?
(- 20 (length str
)))))))
531 (setq i
(+ i
1)))))))))
533 (defun ispell-command-loop (word start end message
)
538 (setq first-line
(concat "No near misses for '" word
"'"))
539 (setq first-line
(concat "Near misses for '" word
"'")))
540 (ispell-highlight start end
)
542 (ispell-show-choices word message first-line
)
543 (message "Ispell command: ")
545 (let ((c (downcase (read-char)))
547 (cond ((and (>= c ?
0)
549 (setq replacement
(nth (- c ?
0) message
)))
550 (ispell-replace start end replacement
)
553 (throw 'ispell-quit nil
))
554 ((= c
(nth 3 (current-input-mode)))
559 (ispell-replace start end
(read-string "Replacement: "))
569 (let ((val (ispell-do-look word
)))
570 (setq first-line
(car val
))
571 (setq message
(cdr val
))))
574 "Type 'C-h d ispell' to the emacs main loop for more help")
577 (message "Bad ispell command")
581 (defun ispell-do-look (bad-word)
582 (let (regex buf words
)
583 (cond ((null ispell-have-new-look
)
584 (setq regex
(read-string "Lookup: ")))
586 (setq regex
(read-string "Lookup (regex): " "^"))))
587 (setq buf
(get-buffer-create "*ispell look*"))
590 (delete-region (point-min) (point-max))
591 (if ispell-have-new-look
592 (call-process ispell-look-command nil buf nil
"-r" regex
)
593 (call-process ispell-look-command nil buf nil regex
))
594 (goto-char (point-min))
596 (delete-region (point) (point-max))
597 (goto-char (point-min))
598 (while (not (= (point-min) (point-max)))
600 (setq words
(cons (buffer-substring (point-min) (point)) words
))
602 (delete-region (point-min) (point)))
604 (cons (format "Lookup '%s'" regex
)
607 (defun ispell-replace (start end new
)
610 (delete-region (point) end
))
612 (defun reload-ispell ()
613 "Tell Ispell to re-read your private dictionary."
615 (ispell-cmd ":reload"))
617 (defun batch-make-ispell ()
618 (byte-compile-file "ispell.el")
619 (find-file "ispell.texinfo")
620 (let ((old-dir default-directory
)
621 (default-directory "/tmp"))
622 (texinfo-format-buffer))
624 (if (get-buffer " *problems in info file*")
626 (write-region (point-min) (point-max) "ispell.info"))
628 (defvar ispell-highlight t
629 "*Non-nil means to highlight ispell words.")
631 (defvar ispell-overlay nil
)
633 (defun ispell-dehighlight ()
636 (delete-overlay ispell-overlay
)
637 (setq ispell-overlay nil
))))
639 (defun ispell-highlight (start end
)
640 (and ispell-highlight
644 (setq ispell-overlay
(make-overlay start end
))
645 (overlay-put ispell-overlay
'face
646 (if (internal-find-face 'ispell
)
648 (move-overlay ispell-overlay start end
(current-buffer)))))
650 ;;;; ispell-complete-word
652 ;;; Brief Description:
653 ;;; Complete word fragment at point using dictionary and replace with full
654 ;;; word. Expansion done in current buffer like lisp-complete-symbol.
655 ;;; Completion of interior word fragments possible with prefix argument.
658 ;;; Does not use private dictionary because GNU `look' does not use it. It
659 ;;; would be nice if GNU `look' took standard input; this would allow gzip'ed
660 ;;; dictionaries to be used. GNU `look' also has a bug, see
661 ;;; `ispell-gnu-look-still-broken-p'.
664 ;;; The `l', "regular expression look up", keymap option of ispell-word
665 ;;; (ispell-do-look) can only be run after finding a misspelled word. So
666 ;;; ispell-do-look can not be used to look for words starting with `cat' to
667 ;;; find `catechetical' since `cat' is a correctly spelled word. Furthermore,
668 ;;; ispell-do-look does not return the entire list returned by `look'.
670 ;;; ispell-complete-word allows you to get a completion list from the system
671 ;;; dictionary and expand a word fragment at the current position in a buffer.
672 ;;; These examples assume ispell-complete-word is bound to M-TAB as it is in
673 ;;; text-mode; the `Complete Word' and `Complete Interior Fragment' entries of
674 ;;; the "Spell" submenu under the "Edit" menu may also be used instead of
675 ;;; M-TAB and C-u M-TAB, respectively.
677 ;;; EXAMPLE 1: The word `Saskatchewan' needs to be spelled. The user may
678 ;;; type `Sas' and hit M-TAB and a completion list will be built using the
679 ;;; shell command `look' and displayed in the *Completions* buffer:
681 ;;; Possible completions are:
685 ;;; Saskatchewan Saskatoon
690 ;;; By viewing this list the user will hopefully be motivated to insert the
691 ;;; letter `k' after the `sas'. When M-TAB is hit again the word `Saskat'
692 ;;; will be inserted in place of `sas' (note case) since this is a unique
693 ;;; substring completion. The narrowed completion list can be viewed with
696 ;;; Possible completions are:
697 ;;; Saskatchewan Saskatoon
699 ;;; Inserting the letter `c' and hitting M-TAB will narrow the completion
700 ;;; possibilities to just `Saskatchewan' and this will be inserted in the
701 ;;; buffer. At any point the user may click the mouse on a completion to
704 ;;; EXAMPLE 2: The user has typed `Sasaquane' and M-$ (ispell-word) gives no
705 ;;; "near-misses" in which case you back up to `Sas' and hit M-TAB and find
706 ;;; the correct word as above. The `Sas' will be replaced by `Saskatchewan'
707 ;;; and the remaining word fragment `aquane' can be deleted.
709 ;;; EXAMPLE 3: If a version of `look' is used that supports regular
710 ;;; expressions, then `ispell-have-new-look' should be t (its default) and
711 ;;; interior word fragments may also be used for the search. The word
712 ;;; `pneumonia' needs to be spelled. The user can only remember the
713 ;;; interior fragment `mon' in which case `C-u M-TAB' on `mon' gives a list
714 ;;; of all words containing the interior word fragment `mon'. Typing `p'
715 ;;; and M-TAB will narrow this list to all the words starting with `p' and
716 ;;; containing `mon' from which `pneumonia' can be found as above.
718 ;;; The user-defined variables are:
720 ;;; ispell-look-command
721 ;;; ispell-look-dictionary
722 ;;; ispell-gnu-look-still-broken-p
724 ;;; Algorithm (some similarity to lisp-complete-symbol):
726 ;;; * call-process on command ispell-look-command (default: "look") to find
727 ;;; words in ispell-look-dictionary matching `string' (or `regexp' if
728 ;;; ispell-have-new-look is t). Parse output and store results in
729 ;;; ispell-lookup-completions-alist.
731 ;;; * Build completion list using try-completion and `string'
733 ;;; * Replace `string' in buffer with matched common substring completion.
735 ;;; * Display completion list only if there is no matched common substring.
737 ;;; * Rebuild ispell-lookup-completions-alist, on a next call, only when
738 ;;; beginning of word fragment has changed.
740 ;;; * Interior fragments searches are performed similarly with the exception
741 ;;; that the entire fragment at point is initially removed from the buffer,
742 ;;; the STRING passed to try-completion and all-completions is just "" and
743 ;;; not the interior fragment; this allows all completions containing the
744 ;;; interior fragment to be shown. The location in the buffer is stored to
745 ;;; decide whether future completion narrowing of the current list should be
746 ;;; done or if a new list should be built. See interior fragment example
749 ;;; * Robust searches are done using a `look' with -r (regular expression)
750 ;;; switch if ispell-have-new-look is t.
752 ;;;; User-defined variables.
754 (defvar ispell-look-dictionary nil
755 "*If non-nil then spelling dictionary as string for `ispell-complete-word'.
756 Overrides default dictionary file such as \"/usr/dict/words\" or GNU look's
757 \"${prefix}/lib/ispell/ispell.words\"")
759 (defvar ispell-gnu-look-still-broken-p nil
760 "*t if GNU look -r can give different results with and without trialing `.*'.
761 Example: `look -dfr \"^ya\" foo' returns nothing, while `look -dfr \"^ya.*\" foo'
762 returns `yacc', where `foo' is a dictionary file containing the three lines
768 Both commands should return `yacc'. If `ispell-complete-word' erroneously
769 states that no completions exist for a string, then setting this variable to t
770 will help find those completions.")
772 ;;;; Internal variables.
774 ;;; Possible completions for last word fragment.
775 (defvar ispell-lookup-completions-alist nil
)
777 ;;; Last word fragment processed by `ispell-complete-word'.
778 (defvar ispell-lookup-last-word nil
)
780 ;;; Buffer local variables.
782 ;;; Value of interior-frag in last call to `ispell-complete-word'.
783 (defvar ispell-lookup-last-interior-p nil
)
784 (make-variable-buffer-local 'ispell-lookup-last-interior-p
)
785 (put 'ispell-lookup-last-interior-p
'permanent-local t
)
787 ;;; Buffer position in last call to `ispell-complete-word'.
788 (defvar ispell-lookup-last-bow nil
)
789 (make-variable-buffer-local 'ispell-lookup-last-bow
)
790 (put 'ispell-lookup-last-bow
'permanent-local t
)
792 ;;;; Interactive functions.
794 (defun ispell-complete-word (&optional interior-frag
)
795 "Complete word using letters at point to word beginning using `look'.
796 With optional argument INTERIOR-FRAG, word fragment at point is assumed to be
797 an interior word fragment in which case `ispell-have-new-look' should be t.
798 See also `ispell-look-dictionary' and `ispell-gnu-look-still-broken-p'."
802 ;; `look' must support regexp expressions in order to perform an interior
804 (if (and interior-frag
(not ispell-have-new-look
))
805 (error (concat "Sorry, `ispell-have-new-look' is nil. "
806 "You also will need GNU Ispell's `look'.")))
808 (let* ((completion-ignore-case t
)
810 ;; Get location of beginning of word fragment.
811 (bow (save-excursion (skip-chars-backward "a-zA-Z'") (point)))
813 ;; Get the string to look up.
814 (string (buffer-substring bow
(point)))
816 ;; Get regexp for which we search and, if necessary, an interior word
818 (regexp (if interior-frag
819 (concat "^.*" string
".*")
820 ;; If possible use fast binary search: no trailing `.*'.
822 (if ispell-gnu-look-still-broken-p
".*"))))
824 ;; We want all completions for case of interior fragments so set
825 ;; prefix to an empty string.
826 (prefix (if interior-frag
"" string
))
828 ;; Are we continuing from a previous interior fragment search?
829 ;; Check last value of interior-word and if the point has moved.
830 (continuing-an-interior-frag-p
831 (and ispell-lookup-last-interior-p
832 (equal ispell-lookup-last-bow bow
)))
834 ;; Are we starting a unique word fragment search? Always t for
835 ;; interior word fragment search.
837 (or interior-frag
(null ispell-lookup-last-word
)
838 (let ((case-fold-search t
))
839 ;; Can we locate last word fragment as a substring of current
840 ;; word fragment? If the last word fragment is larger than
841 ;; the current string then we will have to rebuild the list
844 (concat "^" ispell-lookup-last-word
) string
)))))
848 ;; Check for perfect completion already. That is, maybe the user has hit
849 ;; M-x ispell-complete-word one too many times?
850 (if (string-equal string
"")
851 (if (string-equal (concat ispell-lookup-last-word
" ")
853 (save-excursion (forward-word -
1) (point)) (point)))
854 (error "Perfect match already")
855 (error "No word fragment at point")))
857 ;; Create list of words from system dictionary starting with `string' if
858 ;; new string and not continuing from a previous interior fragment search.
859 (if (and (not continuing-an-interior-frag-p
) new-unique-string-p
)
860 (setq ispell-lookup-completions-alist
861 (ispell-lookup-build-list string regexp
)))
863 ;; Check for a completion of `string' in the list and store `string' and
864 ;; other variables for the next call.
865 (setq completion
(try-completion prefix ispell-lookup-completions-alist
)
866 ispell-lookup-last-word string
867 ispell-lookup-last-interior-p interior-frag
868 ispell-lookup-last-bow bow
)
870 ;; Test the completion status.
873 ;; * Guess is a perfect match.
876 (message "Perfect match."))
878 ;; * No possibilities.
880 (message "Can't find completion for \"%s\"" string
)
883 ;; * Replace string fragment with matched common substring completion.
884 ((and (not (string-equal completion
""))
885 ;; Fold case so a completion list is built when `string' and common
886 ;; substring differ only in case.
887 (let ((case-fold-search t
))
888 (not (string-match (concat "^" completion
"$") string
))))
889 (search-backward string bow
)
890 (replace-match completion nil t
) ; FIXEDCASE doesn't work? or LITERAL?
891 (message "Proposed unique substring. Repeat for completions list."))
893 ;; * String is a common substring completion already. Make list.
895 (message "Making completion list...")
896 (if (string-equal completion
"") (delete-region bow
(point)))
897 (let ((list (all-completions prefix ispell-lookup-completions-alist
)))
898 (with-output-to-temp-buffer " *Completions*"
899 (display-completion-list list
)))
900 (message "Making completion list...done")))))
903 (defun ispell-complete-word-interior-frag ()
904 "Runs `ispell-complete-word' with a non-nil INTERIOR-FRAG.
905 A completion list is built for word fragment at point which is assumed to be
906 an interior word fragment. `ispell-have-new-look' should be t."
908 (ispell-complete-word t
))
910 ;;;; Internal Function.
912 ;;; Build list of words using ispell-look-command from dictionary
913 ;;; ispell-look-dictionary (if this is a non-nil string). Look for words
914 ;;; starting with STRING if ispell-have-new-look is nil or look for REGEXP if
915 ;;; ispell-have-new-look is t. Returns result as an alist suitable for use by
916 ;;; try-completion, all-completions, and completing-read.
917 (defun ispell-lookup-build-list (string regexp
)
919 (message "Building list...")
920 (set-buffer (get-buffer-create " *ispell look*"))
923 (if (stringp ispell-look-dictionary
)
924 (if ispell-have-new-look
925 (call-process ispell-look-command nil t nil
"-fr" regexp
926 ispell-look-dictionary
)
927 (call-process ispell-look-command nil t nil
"-f" string
928 ispell-look-dictionary
))
929 (if ispell-have-new-look
930 (call-process ispell-look-command nil t nil
"-fr" regexp
)
931 (call-process ispell-look-command nil t nil
"-f" string
)))
933 ;; Build list for try-completion and all-completions by storing each line
934 ;; of output starting from bottom of buffer and deleting upwards.
936 (goto-char (point-min))
937 (while (not (= (point-min) (point-max)))
939 (setq list
(cons (buffer-substring (point-min) (point)) list
))
941 (delete-region (point-min) (point)))
945 (message "Building list...done")
947 ;; Make the list into an alist and return.
948 (mapcar 'list
(nreverse list
)))))
950 ;; Return regexp-quote of STRING if STRING is non-empty.
951 ;; Otherwise return an unmatchable regexp.
952 (defun ispell-non-empty-string (string)
953 (if (or (not string
) (string-equal string
""))
954 "\\'\\`" ; An unmatchable string if string is null.
955 (regexp-quote string
)))
957 (defvar ispell-message-cite-regexp
"^ \\|^\t"
958 "*Regular expression to match lines cited from one message into another.")
961 (defun ispell-message ()
962 "Check the spelling of a mail message or news post.
963 Don't check spelling of message headers or included messages.
965 To spell-check whenever a message is sent, include this line in .emacs:
966 (setq news-inews-hook (setq mail-send-hook 'ispell-message))
968 Or you can bind the function to C-c i in gnus or mail with:
969 (setq mail-mode-hook (setq news-reply-mode-hook
970 (function (lambda () (local-set-key \"\\C-ci\" 'ispell-message)))))"
973 (let (non-internal-message
974 (old-case-fold-search case-fold-search
)
975 (case-fold-search nil
))
976 (goto-char (point-min))
977 ;; Don't spell-check the headers.
978 (if (search-forward mail-header-separator nil t
)
979 ;; Move to first body line.
981 (while (and (looking-at "[a-zA-Z-]+:\\|\t\\| ")
984 (setq non-internal-message t
)
986 (let ((cite-regexp ;Prefix of inserted text
988 ((featurep 'supercite
) ; sc 3.0
989 (concat "\\(" (sc-cite-regexp) "\\)" "\\|"
990 (ispell-non-empty-string sc-reference-tag-string
)))
991 ((featurep 'sc
) ; sc 2.3
992 (concat "\\(" sc-cite-regexp
"\\)" "\\|"
993 (ispell-non-empty-string sc-reference-tag-string
)))
994 (non-internal-message ; Assume nn sent us this message.
995 (concat "In [a-zA-Z.]+ you write:" "\\|"
996 "In <[^,;&+=]+> [^,;&+=]+ writes:" "\\|"
998 ((equal major-mode
'news-reply-mode
) ;Gnus
999 (concat "In article <" "\\|"
1000 (if mail-yank-prefix
1001 (ispell-non-empty-string mail-yank-prefix
)
1002 ispell-message-cite-regexp
)))
1003 ((boundp 'vm-included-text-prefix
) ; VM mail message
1004 (concat "[^,;&+=]+ writes:" "\\|"
1005 (ispell-non-empty-string vm-included-text-prefix
)
1007 ((boundp 'mh-ins-buf-prefix
) ; mh mail message
1008 (ispell-non-empty-string mh-ins-buf-prefix
))
1009 (mail-yank-prefix ; vanilla mail message.
1010 (ispell-non-empty-string mail-yank-prefix
))
1011 (t ispell-message-cite-regexp
)))
1014 (while (and (not (eobp)) continue
)
1015 ;; Skip across text cited from other messages.
1016 (while (and (looking-at (concat "^[ \t]*$\\|" cite-regexp
))
1020 ;; Check the next batch of lines that *aren't* cited.
1021 (let ((start (point)))
1022 (if (re-search-forward
1023 (concat "^\\(" cite-regexp
"\\)") nil
'end
)
1024 (beginning-of-line))
1025 (let ((case-fold-search old-case-fold-search
))
1027 (setq continue
(ispell-region (- start
1) (point))))))))))))
1031 ;;; ispell.el ends here