1 ;;; ispell.el --- interface to International Ispell Versions 3.1 and 3.2
3 ;; Copyright (C) 1994-1995, 1997-2012 Free Software Foundation, Inc.
5 ;; Author: Ken Stevens <k.stevens@ieee.org>
6 ;; Maintainer: Ken Stevens <k.stevens@ieee.org>
7 ;; Stevens Mod Date: Mon Jan 7 12:32:44 PST 2003
8 ;; Stevens Revision: 3.6
9 ;; Status : Release with 3.1.12+ and 3.2.0+ ispell.
10 ;; Bug Reports : ispell-el-bugs@itcorp.com
11 ;; Web Site : http://kdstevens.com/~stevens/ispell-page.html
14 ;; This file is part of GNU Emacs.
16 ;; GNU Emacs is free software: you can redistribute it and/or modify
17 ;; it under the terms of the GNU General Public License as published by
18 ;; the Free Software Foundation, either version 3 of the License, or
19 ;; (at your option) any later version.
21 ;; GNU Emacs is distributed in the hope that it will be useful,
22 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
23 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
24 ;; GNU General Public License for more details.
26 ;; You should have received a copy of the GNU General Public License
27 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
29 ;; Note: version numbers and time stamp are not updated
30 ;; when this file is edited for release with GNU Emacs.
36 ;; This code contains a section of user-settable variables that you
37 ;; should inspect prior to installation. Look past the end of the history
38 ;; list. Set them up for your locale and the preferences of the majority
39 ;; of the users. Otherwise the users may need to set a number of variables
41 ;; You particularly may want to change the default dictionary for your
42 ;; country and language.
43 ;; Most dictionary changes should be made in this file so all users can
44 ;; enjoy them. Local or modified dictionaries are supported in your .emacs
45 ;; file. Use the variable `ispell-local-dictionary-alist' to specify
46 ;; your own dictionaries.
48 ;; Depending on the mail system you use, you may want to include these:
49 ;; (add-hook 'news-inews-hook 'ispell-message)
50 ;; (add-hook 'mail-send-hook 'ispell-message)
51 ;; (add-hook 'mh-before-send-letter-hook 'ispell-message)
53 ;; Ispell has a TeX parser and a nroff parser (the default).
54 ;; The parsing is controlled by the variable ispell-parser. Currently
55 ;; it is just a "toggle" between TeX and nroff, but if more parsers are
56 ;; added it will be updated. See the variable description for more info.
65 ;; ispell-comments-and-strings
67 ;; ispell-complete-word
68 ;; ispell-complete-word-interior-frag
69 ;; ispell-change-dictionary
72 ;; ispell-skip-region-alist
74 ;; Commands in ispell-region:
75 ;; Character replacement: Replace word with choice. May query-replace.
76 ;; ` ': Accept word this time.
77 ;; `i': Accept word and insert into private dictionary.
78 ;; `a': Accept word for this session.
79 ;; `A': Accept word and place in buffer-local dictionary.
80 ;; `r': Replace word with typed-in value. Rechecked.
81 ;; `R': Replace word with typed-in value. Query-replaced in buffer. Rechecked.
82 ;; `?': Show these commands
83 ;; `x': Exit spelling buffer. Move cursor to original point.
84 ;; `X': Exit spelling buffer. Leaves cursor at the current point, and permits
85 ;; the check to be completed later.
86 ;; `q': Quit spelling session (Kills ispell process).
87 ;; `l': Look up typed-in replacement in alternate dictionary. Wildcards okay.
88 ;; `u': Like `i', but the word is lower-cased first.
89 ;; `m': Place entered value in personal dictionary, then recheck current word.
90 ;; `C-l': redraws screen
91 ;; `C-r': recursive edit
92 ;; `C-z': suspend Emacs or iconify frame
94 ;; Buffer-Local features:
95 ;; There are a number of buffer-local features that can be used to customize
96 ;; ispell for the current buffer. This includes language dictionaries,
97 ;; personal dictionaries, parsing, and local word spellings. Each of these
98 ;; local customizations are done either through local variables, or by
99 ;; including the keyword and argument(s) at the end of the buffer (usually
100 ;; prefixed by the comment characters). See the end of this file for
101 ;; examples. The local keywords and variables are:
103 ;; ispell-dictionary-keyword language-dictionary
104 ;; uses local variable ispell-local-dictionary
105 ;; ispell-pdict-keyword personal-dictionary
106 ;; uses local variable ispell-local-pdict
107 ;; ispell-parsing-keyword mode-arg extended-char-arg
108 ;; ispell-words-keyword any number of local word spellings
111 ;; Place new regular expression definitions of regions you prefer not to
112 ;; spell check in `ispell-skip-region-alist'. Mode-dependent features can
113 ;; be added to latex by modifying `ispell-tex-skip-alists'.
114 ;; `ispell-message' contains some custom skipping code for e-mail messages.
117 ;; Need a way to select between different character mappings without separate
118 ;; dictionary entries.
119 ;; Multi-byte characters if not defined by current dictionary may result in the
120 ;; evil "misalignment error" in some versions of MULE Emacs.
121 ;; On some versions of Emacs, growing the minibuffer fails.
122 ;; see `ispell-help-in-bufferp'.
123 ;; Recursive edits (?C-r or ?R) inside a keyboard text replacement check (?r)
124 ;; can cause misalignment errors.
128 ;; Modifications made in latest versions:
130 ;; Revision 3.6 2003/01/07 12:32:44 kss
131 ;; Removed extra -d LIB in dictionary defs. (Pavel Janik)
132 ;; Filtered process calls with duplicate dictionary entries.
133 ;; Fixed bug where message-text-end is inside a mime skipped region.
134 ;; Minor fixes to get ispell menus right in XEmacs
135 ;; Fixed skip regexp so it doesn't match stuff like `/.\w'.
136 ;; Detecting dictionary change not working. Fixed. kss
137 ;; function `ispell-change-dictionary' now only completes valid dicts.
139 ;; Revision 3.5 2001/7/11 18:43:57 kss
140 ;; Added fix for aspell to work in XEmacs (ispell-check-version).
141 ;; Added Portuguese dictionary definition.
142 ;; New feature: MIME mail message support, Fcc support.
143 ;; Bug fix: retain comment syntax on lines with region skipping. (TeX $ bug...)
144 ;; Improved allocation for graphic mode lines. (Miles Bader)
145 ;; Support -v flag for old versions of aspell. (Eli Zaretskii)
146 ;; Clear minibuffer on ^G from ispell-help (Tak Ota)
148 ;; Revision 3.4 2000/8/4 09:41:50 kss
149 ;; Support new color display functions.
150 ;; Fixed misalignment offset bug when replacing a string after a shift made.
151 ;; Set to standard Author/Maintainer heading,
152 ;; ensure localwords lists are separated from the text by newline. (Dave Love)
153 ;; Added dictionary definition for Italian (William Deakin)
154 ;; HTML region skipping greatly improved. (Chuck D. Phillips)
155 ;; improved menus. Fixed regexp matching http/email addresses.
156 ;; one arg always for XEmacs sleep-for (gunnar Evermann)
157 ;; support for synchronous processes (Eli Zaretskii)
159 ;; Revision 3.3 1999/11/29 11:38:34 kss
160 ;; Only word replacements entered in from the keyboard are rechecked.
161 ;; This fixes a bug in tex parsing and misalignment.
162 ;; Exceptions exist for recursive edit and query-replace, with tex error
163 ;; condition tested. Recursive editing improved.
164 ;; XEmacs repair for when `enable-multibyte-characters' defined - Didier Verna.
165 ;; ispell-help fixed for XEmacs. Choices minibuffer now displayed in XEmacs.
166 ;; Only list valid dictionaries in Spell menu. Russian dictionary doesn't allow
167 ;; run-together words, and uses koi8-r font. Don't skip text in html <TT>
170 ;; Revision 3.2 1999/5/7 14:25:14 kss
171 ;; Accept ispell versions 3.X.Y where X>=1
172 ;; fine tuned latex region skipping. Fixed bug in ispell-word that did not
173 ;; point in right place on words < 2 chars. Simplified ispell-minor-mode.
174 ;; Fixed bug in TeX parsing when math commands are in the comments.
175 ;; Removed calls to `when' macro.
177 ;; Revision 3.1 1998/12/1 13:21:52 kss
178 ;; Improved and fixed customize support.
179 ;; Improved and fixed comments in variables and messages.
180 ;; A coding system is now required for all languages.
181 ;; casechars improved for castellano, castellano8, and norsk dictionaries.
182 ;; Dictionary norsk7-tex removed. Dictionary polish added.
183 ;; Dictionaries redefined at load-time to support dictionary changes.
184 ;; Menu redefined at load time to support dictionary changes.
185 ;; ispell-check-version added as an alias for `check-ispell-version'.
186 ;; Spelling suggestions returned in order generated by ispell.
187 ;; Small bug fixed in matching ispell error messages.
188 ;; Robustness added to ensure `case-fold-search' doesn't get redefined.
189 ;; Fixed bug that didn't respect case of word in `ispell-complete-word'.
190 ;; Multibyte character coding support added for process interactions.
191 ;; Ensure ispell process has terminated before starting new process.
192 ;; This can otherwise confuse process filters and hang ispell.
193 ;; Improved skipping support for SGML.
194 ;; Fixed bug using ^M rather than \r in `ispell-minor-check'.
195 ;; Improved message reference matching in `ispell-message'.
196 ;; Fixed bug in returning to nroff mode from tex mode.
198 ;;; Compatibility code for XEmacs and (not too) older emacsen:
200 (eval-and-compile ;; Protect against declare-function undefined in XEmacs
201 (unless (fboundp 'declare-function
) (defmacro declare-function
(&rest r
))))
203 (declare-function ispell-check-minver
"ispell" (v1 v2
))
204 (declare-function ispell-looking-back
"ispell"
205 (regexp &optional limit
&rest ignored
))
207 (if (fboundp 'version
<=)
208 (defalias 'ispell-check-minver
'version
<=)
209 (defun ispell-check-minver (minver version
)
210 "Check if string VERSION is at least string MINVER.
211 Both must be in [0-9]+.[0-9]+... format. This is a fallback
212 compatibility function in case `version<=' is not available."
215 start-ver start-mver
)
216 ;; Loop until an absolute greater or smaller condition is reached
217 ;; or until no elements are left in any of version and minver. In
218 ;; this case version is exactly the minimal, so return OK.
221 (if (string-match "[0-9]+" version start-ver
)
222 (setq start-ver
(match-end 0)
223 ver
(string-to-number (match-string 0 version
))))
224 (if (string-match "[0-9]+" minver start-mver
)
225 (setq start-mver
(match-end 0)
226 mver
(string-to-number (match-string 0 minver
))))
230 (or ver
(setq ver
0))
231 (or mver
(setq mver
0))
232 ;; If none of below conditions match, this element is the
233 ;; same. Go checking next element.
239 (setq pending nil
))))
242 ;; XEmacs does not have looking-back
243 (if (fboundp 'looking-back
)
244 (defalias 'ispell-looking-back
'looking-back
)
245 (defun ispell-looking-back (regexp &optional limit
&rest ignored
)
246 "Return non-nil if text before point matches regular expression REGEXP.
247 Like `looking-at' except matches before point, and is slower.
248 LIMIT if non-nil speeds up the search by specifying a minimum
249 starting position, to avoid checking matches that would start
252 This is a stripped down compatibility function for use when
253 full featured `looking-back' function is missing."
255 (re-search-backward (concat "\\(?:" regexp
"\\)\\=") limit t
))))
257 ;;; XEmacs21 does not have `with-no-warnings'. Taken from org mode.
258 (defmacro ispell-with-no-warnings
(&rest body
)
259 (cons (if (fboundp 'with-no-warnings
) 'with-no-warnings
'progn
) body
))
263 (defvar mail-yank-prefix
)
266 "User variables for Emacs ispell interface."
267 :group
'applications
)
269 (if (not (fboundp 'buffer-substring-no-properties
))
270 (defun buffer-substring-no-properties (start end
)
271 (buffer-substring start end
)))
273 (defalias 'check-ispell-version
'ispell-check-version
)
275 ;;; **********************************************************************
276 ;;; The following variables should be set according to personal preference
277 ;;; and location of binaries:
278 ;;; **********************************************************************
281 ;;; ******* THIS FILE IS WRITTEN FOR ISPELL VERSION 3.1+
283 (defcustom ispell-highlight-p
'block
284 "Highlight spelling errors when non-nil.
285 When set to `block', assumes a block cursor with TTY displays."
286 :type
'(choice (const block
) (const :tag
"off" nil
) (const :tag
"on" t
))
289 (defcustom ispell-lazy-highlight
(boundp 'lazy-highlight-cleanup
)
290 "Controls the lazy-highlighting of spelling errors.
291 When non-nil, all text in the buffer matching the current spelling
292 error is highlighted lazily using isearch lazy highlighting (see
293 `lazy-highlight-initial-delay' and `lazy-highlight-interval')."
295 :group
'lazy-highlight
299 (defcustom ispell-highlight-face
(if ispell-lazy-highlight
'isearch
'highlight
)
300 "Face used for Ispell highlighting.
301 This variable can be set by the user to whatever face they desire.
302 It's most convenient if the cursor color and highlight color are
307 (defcustom ispell-check-comments t
308 "Spelling of comments checked when non-nil.
309 When set to `exclusive', ONLY comments are checked. (For code comments).
310 Warning! Not checking comments, when a comment start is embedded in strings,
311 may produce undesired results."
312 :type
'(choice (const exclusive
) (const :tag
"off" nil
) (const :tag
"on" t
))
315 (put 'ispell-check-comments
'safe-local-variable
316 (lambda (a) (memq a
'(nil t exclusive
))))
318 (defcustom ispell-query-replace-choices nil
319 "Corrections made throughout region when non-nil.
320 Uses `query-replace' (\\[query-replace]) for corrections."
324 (defcustom ispell-skip-tib nil
325 "Does not spell check `tib' bibliography references when non-nil.
326 Skips any text between strings matching regular expressions
327 `ispell-tib-ref-beginning' and `ispell-tib-ref-end'.
329 TeX users beware: Any text between [. and .] will be skipped -- even if
330 that's your whole buffer -- unless you set `ispell-skip-tib' to nil.
331 That includes the [.5mm] type of number..."
335 (defvar ispell-tib-ref-beginning
"[[<]\\."
336 "Regexp matching the beginning of a Tib reference.")
338 (defvar ispell-tib-ref-end
"\\.[]>]"
339 "Regexp matching the end of a Tib reference.")
341 (defcustom ispell-keep-choices-win t
342 "If non-nil, keep the `*Choices*' window for the entire spelling session.
343 This minimizes redisplay thrashing."
347 (defcustom ispell-choices-win-default-height
2
348 "The default size of the `*Choices*' window, including the mode line.
349 Must be greater than 1."
353 (defcustom ispell-program-name
354 (or (executable-find "aspell")
355 (executable-find "ispell")
356 (executable-find "hunspell")
358 "Program invoked by \\[ispell-word] and \\[ispell-region] commands."
362 (defcustom ispell-alternate-dictionary
363 (cond ((file-readable-p "/usr/dict/web2") "/usr/dict/web2")
364 ((file-readable-p "/usr/share/dict/web2") "/usr/share/dict/web2")
365 ((file-readable-p "/usr/dict/words") "/usr/dict/words")
366 ((file-readable-p "/usr/lib/dict/words") "/usr/lib/dict/words")
367 ((file-readable-p "/usr/share/dict/words") "/usr/share/dict/words")
368 ((file-readable-p "/usr/share/lib/dict/words")
369 "/usr/share/lib/dict/words")
370 ((file-readable-p "/sys/dict") "/sys/dict"))
371 "Alternate plain word-list dictionary for spelling help."
372 :type
'(choice file
(const :tag
"None" nil
))
375 (defcustom ispell-complete-word-dict nil
376 "Plain word-list dictionary used for word completion if
377 different from `ispell-alternate-dictionary'."
378 :type
'(choice file
(const :tag
"None" nil
))
381 (defcustom ispell-message-dictionary-alist nil
382 "List used by `ispell-message' to select a new dictionary.
383 It consists of pairs (REGEXP . DICTIONARY). If REGEXP is found
384 in the message headers, `ispell-local-dictionary' will be set to
385 DICTIONARY if `ispell-local-dictionary' is not buffer-local.
386 E.g. you may use the following value:
387 '((\"^Newsgroups:[ \\t]*de\\\\.\" . \"deutsch8\")
388 (\"^To:[^\\n,]+\\\\.de[ \\t\\n,>]\" . \"deutsch8\"))"
389 :type
'(repeat (cons regexp string
))
393 (defcustom ispell-message-fcc-skip
50000
394 "Query before saving Fcc message copy if attachment larger than this value.
395 Always stores Fcc copy of message when nil."
396 :type
'(choice integer
(const :tag
"off" nil
))
400 (defcustom ispell-grep-command
401 ;; MS-Windows/MS-DOS have `egrep' as a Unix shell script, so they
402 ;; cannot invoke it. Use "grep -E" instead (see ispell-grep-options
404 (if (memq system-type
'(windows-nt ms-dos
)) "grep" "egrep")
405 "Name of the grep command for search processes."
409 (defcustom ispell-grep-options
410 (if (memq system-type
'(windows-nt ms-dos
)) "-Ei" "-i")
411 "String of options to use when running the program in `ispell-grep-command'.
412 Should probably be \"-i\" or \"-e\".
413 Some machines (like the NeXT) don't support \"-i\"."
417 (defcustom ispell-look-command
418 (cond ((file-exists-p "/bin/look") "/bin/look")
419 ((file-exists-p "/usr/local/bin/look") "/usr/local/bin/look")
420 ((file-exists-p "/usr/bin/look") "/usr/bin/look")
422 "Name of the look command for search processes.
423 This must be an absolute file name."
427 (defcustom ispell-look-p
(file-exists-p ispell-look-command
)
428 "Non-nil means use `look' rather than `grep'.
429 Default is based on whether `look' seems to be available."
433 (defcustom ispell-have-new-look nil
434 "Non-nil means use the `-r' option (regexp) when running `look'."
438 (defcustom ispell-look-options
(if ispell-have-new-look
"-dfr" "-df")
439 "String of command options for `ispell-look-command'."
443 (defcustom ispell-use-ptys-p nil
444 "When non-nil, Emacs uses ptys to communicate with Ispell.
445 When nil, Emacs uses pipes."
449 (defcustom ispell-following-word nil
450 "Non-nil means `ispell-word' checks the word around or after point.
451 Otherwise `ispell-word' checks the preceding word."
455 (defcustom ispell-help-in-bufferp nil
456 "Non-nil means display interactive keymap help in a buffer.
457 The following values are supported:
458 nil Expand the minibuffer and display a short help message
459 there for a couple of seconds.
460 t Pop up a new buffer and display a short help message there
461 for a couple of seconds.
462 electric Pop up a new buffer and display a long help message there.
463 User can browse and then exit the help mode."
464 :type
'(choice (const electric
) (const :tag
"off" nil
) (const :tag
"on" t
))
467 (defcustom ispell-quietly nil
468 "Non-nil means suppress messages in `ispell-word'."
472 (defcustom ispell-format-word-function
(function upcase
)
473 "Formatting function for displaying word being spell checked.
474 The function must take one string argument and return a string."
477 (defvaralias 'ispell-format-word
'ispell-format-word-function
)
479 (defcustom ispell-use-framepop-p nil
480 "When non-nil ispell uses framepop to display choices in a dedicated frame.
481 You can set this variable to dynamically use framepop if you are in a
482 window system by evaluating the following on startup to set this variable:
483 (and window-system (condition-case () (require 'framepop) (error nil)))"
488 (defcustom ispell-personal-dictionary nil
489 "File name of your personal spelling dictionary, or nil.
490 If nil, the default personal dictionary, (\"~/.ispell_DICTNAME\" for ispell or
491 \"~/.aspell.LANG.pws\" for aspell) is used, where DICTNAME is the name of your
492 default dictionary and LANG the two letter language code."
494 (const :tag
"default" nil
))
497 (defcustom ispell-silently-savep nil
498 "When non-nil, save personal dictionary without asking for confirmation."
502 (defvar ispell-local-dictionary-overridden nil
503 "Non-nil means the user has explicitly set this buffer's Ispell dictionary.")
504 (make-variable-buffer-local 'ispell-local-dictionary-overridden
)
506 (defcustom ispell-local-dictionary nil
507 "If non-nil, the dictionary to be used for Ispell commands in this buffer.
508 The value must be a string dictionary name,
509 or nil, which means use the global setting in `ispell-dictionary'.
510 Dictionary names are defined in `ispell-local-dictionary-alist'
511 and `ispell-dictionary-alist'.
513 Setting `ispell-local-dictionary' to a value has the same effect as
514 calling \\[ispell-change-dictionary] with that value. This variable
515 is automatically set when defined in the file with either
516 `ispell-dictionary-keyword' or the Local Variable syntax."
517 :type
'(choice string
518 (const :tag
"default" nil
))
521 (put 'ispell-local-dictionary
'safe-local-variable
'string-or-null-p
)
523 (make-variable-buffer-local 'ispell-local-dictionary
)
525 (defcustom ispell-dictionary nil
526 "Default dictionary to use if `ispell-local-dictionary' is nil."
527 :type
'(choice string
528 (const :tag
"default" nil
))
531 (defcustom ispell-extra-args nil
532 "If non-nil, a list of extra switches to pass to the Ispell program.
533 For example, (\"-W\" \"3\") to cause it to accept all 1-3 character
534 words as correct. See also `ispell-dictionary-alist', which may be used
535 for language-specific arguments."
536 :type
'(repeat string
)
541 (defcustom ispell-skip-html
'use-mode-name
542 "Indicates whether ispell should skip spell checking of SGML markup.
543 If t, always skip SGML markup; if nil, never skip; if non-t and non-nil,
544 guess whether SGML markup should be skipped according to the name of the
545 buffer's major mode."
546 :type
'(choice (const :tag
"always" t
) (const :tag
"never" nil
)
547 (const :tag
"use-mode-name" use-mode-name
))
550 (make-variable-buffer-local 'ispell-skip-html
)
553 (defcustom ispell-local-dictionary-alist nil
554 "List of local or customized dictionary definitions.
555 These can override the values in `ispell-dictionary-alist'.
557 To make permanent changes to your dictionary definitions, you
558 will need to make your changes in this variable, save, and then
560 :type
'(repeat (list (choice :tag
"Dictionary"
561 (string :tag
"Dictionary name")
562 (const :tag
"default" nil
))
563 (regexp :tag
"Case characters")
564 (regexp :tag
"Non case characters")
565 (regexp :tag
"Other characters")
566 (boolean :tag
"Many other characters")
567 (repeat :tag
"Ispell command line args"
569 (choice :tag
"Extended character mode"
570 (const "~tex") (const "~plaintex")
571 (const "~nroff") (const "~list")
572 (const "~latin1") (const "~latin3")
573 (const :tag
"default" nil
))
574 (coding-system :tag
"Coding System")))
578 (defvar ispell-dictionary-base-alist
580 ;; The default dictionary. It may be English.aff, or any other
581 ;; dictionary depending on locale and such things. We should probably
582 ;; ask ispell what dictionary it's using, but until we do that, let's
583 ;; just use a minimal regexp. [:alpha:] will later be set if possible.
584 "[A-Za-z]" "[^A-Za-z]" "[']" nil
("-B") nil iso-8859-1
)
585 ("american" ; Yankee English
586 "[A-Za-z]" "[^A-Za-z]" "[']" nil
("-B") nil iso-8859-1
)
587 ("brasileiro" ; Brazilian mode
588 "[A-Z\301\311\315\323\332\300\310\314\322\331\303\325\307\334\302\312\324a-z\341\351\355\363\372\340\350\354\362\371\343\365\347\374\342\352\364]"
589 "[^A-Z\301\311\315\323\332\300\310\314\322\331\303\325\307\334\302\312\324a-z\341\351\355\363\372\340\350\354\362\371\343\365\347\374\342\352\364]"
590 "[']" nil nil nil iso-8859-1
)
591 ("british" ; British version
592 "[A-Za-z]" "[^A-Za-z]" "[']" nil
("-B") nil iso-8859-1
)
593 ("castellano" ; Spanish mode
594 "[A-Z\301\311\315\321\323\332\334a-z\341\351\355\361\363\372\374]"
595 "[^A-Z\301\311\315\321\323\332\334a-z\341\351\355\361\363\372\374]"
596 "[-]" nil
("-B") "~tex" iso-8859-1
)
597 ("castellano8" ; 8 bit Spanish mode
598 "[A-Z\301\311\315\321\323\332\334a-z\341\351\355\361\363\372\374]"
599 "[^A-Z\301\311\315\321\323\332\334a-z\341\351\355\361\363\372\374]"
600 "[-]" nil
("-B" "-d" "castellano") "~latin1" iso-8859-1
)
602 "[A-Za-z\301\311\314\315\323\332\331\335\256\251\310\330\317\253\322\341\351\354\355\363\372\371\375\276\271\350\370\357\273\362]"
603 "[^A-Za-z\301\311\314\315\323\332\331\335\256\251\310\330\317\253\322\341\351\354\355\363\372\371\375\276\271\350\370\357\273\362]"
604 "" nil
("-B") nil iso-8859-2
)
606 "[A-Z\306\330\305a-z\346\370\345]" "[^A-Z\306\330\305a-z\346\370\345]"
607 "[']" nil
("-C") nil iso-8859-1
)
608 ("deutsch" ; Deutsch.aff
609 "[a-zA-Z\"]" "[^a-zA-Z\"]" "[']" t
("-C") "~tex" iso-8859-1
)
611 "[a-zA-Z\304\326\334\344\366\337\374]"
612 "[^a-zA-Z\304\326\334\344\366\337\374]"
613 "[']" t
("-C" "-d" "deutsch") "~latin1" iso-8859-1
)
614 ("english" ; make English explicitly selectable
615 "[A-Za-z]" "[^A-Za-z]" "[']" nil
("-B") nil iso-8859-1
)
617 "[A-Za-z\246\254\266\274\306\330\335\336\346\370\375\376]"
618 "[^A-Za-z\246\254\266\274\306\330\335\336\346\370\375\376]"
619 "[-']" t
("-C") "~latin3" iso-8859-3
)
621 "[A-Za-z^\\]" "[^A-Za-z^\\]"
622 "[-'`\"]" t
("-C" "-d" "esperanto") "~tex" iso-8859-3
)
624 "[A-Za-z\345\344\366\305\304\326]"
625 "[^A-Za-z\345\344\366\305\304\326]"
626 "[:]" nil
("-C") "~list" iso-8859-1
)
628 "[A-Za-z]" "[^A-Za-z]" "[`'^-]" t nil nil iso-8859-1
)
629 ("francais" ; Francais.aff
630 "[A-Za-z\300\302\306\307\310\311\312\313\316\317\324\331\333\334\340\342\347\350\351\352\353\356\357\364\371\373\374]"
631 "[^A-Za-z\300\302\306\307\310\311\312\313\316\317\324\331\333\334\340\342\347\350\351\352\353\356\357\364\371\373\374]"
632 "[-'.@]" t nil
"~list" iso-8859-1
)
633 ("francais-tex" ; Francais.aff
634 "[A-Za-z\300\302\306\307\310\311\312\313\316\317\324\331\333\334\340\342\347\350\351\352\353\356\357\364\371\373\374\\]"
635 "[^A-Za-z\300\302\306\307\310\311\312\313\316\317\324\331\333\334\340\342\347\350\351\352\353\356\357\364\371\373\374\\]"
636 "[-'^`\".@]" t nil
"~tex" iso-8859-1
)
637 ("german" ; german.aff
638 "[a-zA-Z\"]" "[^a-zA-Z\"]" "[']" t
("-C") "~tex" iso-8859-1
)
639 ("german8" ; german.aff
640 "[a-zA-Z\304\326\334\344\366\337\374]"
641 "[^a-zA-Z\304\326\334\344\366\337\374]"
642 "[']" t
("-C" "-d" "german") "~latin1" iso-8859-1
)
643 ("italiano" ; Italian.aff
644 "[A-Z\300\301\310\311\314\315\322\323\331\332a-z\340\341\350\351\354\355\363\371\372]"
645 "[^A-Z\300\301\310\311\314\315\322\323\331\332a-z\340\341\350\351\354\355\363\371\372]"
646 "[-.]" nil
("-B" "-d" "italian") "~tex" iso-8859-1
)
647 ("nederlands" ; Nederlands.aff
648 "[A-Za-z\300\301\302\303\304\305\307\310\311\312\313\314\315\316\317\322\323\324\325\326\331\332\333\334\340\341\342\343\344\345\347\350\351\352\353\354\355\356\357\361\362\363\364\365\366\371\372\373\374]"
649 "[^A-Za-z\300\301\302\303\304\305\307\310\311\312\313\314\315\316\317\322\323\324\325\326\331\332\333\334\340\341\342\343\344\345\347\350\351\352\353\354\355\356\357\361\362\363\364\365\366\371\372\373\374]"
650 "[']" t
("-C") nil iso-8859-1
)
651 ("nederlands8" ; Dutch8.aff
652 "[A-Za-z\300\301\302\303\304\305\307\310\311\312\313\314\315\316\317\322\323\324\325\326\331\332\333\334\340\341\342\343\344\345\347\350\351\352\353\354\355\356\357\361\362\363\364\365\366\371\372\373\374]"
653 "[^A-Za-z\300\301\302\303\304\305\307\310\311\312\313\314\315\316\317\322\323\324\325\326\331\332\333\334\340\341\342\343\344\345\347\350\351\352\353\354\355\356\357\361\362\363\364\365\366\371\372\373\374]"
654 "[']" t
("-C") nil iso-8859-1
)
655 ("norsk" ; 8 bit Norwegian mode
656 "[A-Za-z\305\306\307\310\311\322\324\330\345\346\347\350\351\362\364\370]"
657 "[^A-Za-z\305\306\307\310\311\322\324\330\345\346\347\350\351\362\364\370]"
658 "[\"]" nil nil
"~list" iso-8859-1
)
659 ("norsk7-tex" ; 7 bit Norwegian TeX mode
660 "[A-Za-z{}\\'^`]" "[^A-Za-z{}\\'^`]"
661 "[\"]" nil
("-d" "norsk") "~plaintex" iso-8859-1
)
662 ("polish" ; Polish mode
663 "[A-Za-z\241\243\246\254\257\261\263\266\274\277\306\312\321\323\346\352\361\363]"
664 "[^A-Za-z\241\243\246\254\257\261\263\266\274\277\306\312\321\323\346\352\361\363]"
665 "[.]" nil nil nil iso-8859-2
)
666 ("portugues" ; Portuguese mode
667 "[a-zA-Z\301\302\307\311\323\340\341\342\351\352\355\363\343\347\372]"
668 "[^a-zA-Z\301\302\307\311\323\340\341\342\351\352\355\363\343\347\372]"
669 "[']" t
("-C") "~latin1" iso-8859-1
)
670 ("russian" ; Russian.aff (KOI8-R charset)
671 "[\341\342\367\347\344\345\263\366\372\351\352\353\354\355\356\357\360\362\363\364\365\346\350\343\376\373\375\370\371\377\374\340\361\301\302\327\307\304\305\243\326\332\311\312\313\314\315\316\317\320\322\323\324\325\306\310\303\336\333\335\330\331\337\334\300\321]"
672 "[^\341\342\367\347\344\345\263\366\372\351\352\353\354\355\356\357\360\362\363\364\365\346\350\343\376\373\375\370\371\377\374\340\361\301\302\327\307\304\305\243\326\332\311\312\313\314\315\316\317\320\322\323\324\325\306\310\303\336\333\335\330\331\337\334\300\321]"
673 "" nil nil nil koi8-r
)
674 ("russianw" ; russianw.aff (CP1251 charset)
675 "[\300\301\302\303\304\305\250\306\307\310\311\312\313\314\315\316\317\320\321\322\323\324\325\326\327\330\331\334\333\332\335\336\337\340\341\342\343\344\345\270\346\347\350\351\352\353\354\355\356\357\360\361\362\363\364\365\366\367\370\371\374\373\372\375\376\377]"
676 "[^\300\301\302\303\304\305\250\306\307\310\311\312\313\314\315\316\317\320\321\322\323\324\325\326\327\330\331\334\333\332\335\336\337\340\341\342\343\344\345\270\346\347\350\351\352\353\354\355\356\357\360\361\362\363\364\365\366\367\370\371\374\373\372\375\376\377]"
677 "" nil nil nil windows-1251
)
678 ("slovak" ; Slovakian
679 "[A-Za-z\301\304\311\315\323\332\324\300\305\245\335\256\251\310\317\253\322\341\344\351\355\363\372\364\340\345\265\375\276\271\350\357\273\362]"
680 "[^A-Za-z\301\304\311\315\323\332\324\300\305\245\335\256\251\310\317\253\322\341\344\351\355\363\372\364\340\345\265\375\276\271\350\357\273\362]"
681 "" nil
("-B") nil iso-8859-2
)
682 ("slovenian" ; Slovenian
683 "[A-Za-z\301\304\311\315\323\332\324\300\305\245\335\256\251\310\317\253\322\341\344\351\355\363\372\364\340\345\265\375\276\271\350\357\273\362]"
684 "[^A-Za-z\301\304\311\315\323\332\324\300\305\245\335\256\251\310\317\253\322\341\344\351\355\363\372\364\340\345\265\375\276\271\350\357\273\362]"
685 "" nil
("-B" "-d" "slovenian") nil iso-8859-2
)
686 ("svenska" ; Swedish mode
687 "[A-Za-z\345\344\366\351\340\374\350\346\370\347\305\304\326\311\300\334\310\306\330\307]"
688 "[^A-Za-z\345\344\366\351\340\374\350\346\370\347\305\304\326\311\300\334\310\306\330\307]"
689 "[']" nil
("-C") "~list" iso-8859-1
)
690 ("hebrew" "[\340\341\342\343\344\345\346\347\350\351\353\352\354\356\355\360\357\361\362\364\363\367\366\365\370\371\372]" "[^\340\341\342\343\344\345\346\347\350\351\353\352\354\356\355\360\357\361\362\364\363\367\366\365\370\371\372]" "" nil
("-B") nil cp1255
))
691 "Base value for `ispell-dictionary-alist'.")
693 (defvar ispell-dictionary-alist nil
694 "An alist of dictionaries and their associated parameters.
696 Each element of this list is also a list:
698 \(DICTIONARY-NAME CASECHARS NOT-CASECHARS OTHERCHARS MANY-OTHERCHARS-P
699 ISPELL-ARGS EXTENDED-CHARACTER-MODE CHARACTER-SET\)
701 DICTIONARY-NAME is a possible string value of variable `ispell-dictionary',
702 nil means the default dictionary.
704 CASECHARS is a regular expression of valid characters that comprise a word.
706 NOT-CASECHARS is the opposite regexp of CASECHARS.
708 OTHERCHARS is a regexp of characters in the NOT-CASECHARS set but which can be
709 used to construct words in some special way. If OTHERCHARS characters follow
710 and precede characters from CASECHARS, they are parsed as part of a word,
711 otherwise they become word-breaks. As an example in English, assume the
712 regular expression \"[']\" for OTHERCHARS. Then \"they're\" and
713 \"Steven's\" are parsed as single words including the \"'\" character, but
714 \"Stevens'\" does not include the quote character as part of the word.
715 If you want OTHERCHARS to be empty, use the empty string.
716 Hint: regexp syntax requires the hyphen to be declared first here.
718 CASECHARS, NOT-CASECHARS, and OTHERCHARS must be unibyte strings
719 containing bytes of CHARACTER-SET. In addition, if they contain
720 non-ASCII bytes, the regular expression must be a single
721 `character set' construct that doesn't specify a character range
724 MANY-OTHERCHARS-P is non-nil when multiple OTHERCHARS are allowed in a word.
725 Otherwise only a single OTHERCHARS character is allowed to be part of any
728 ISPELL-ARGS is a list of additional arguments passed to the ispell
731 EXTENDED-CHARACTER-MODE should be used when dictionaries are used which
732 have been configured in an Ispell affix file. (For example, umlauts
733 can be encoded as \\\"a, a\\\", \"a, ...) Defaults are ~tex and ~nroff
734 in English. This has the same effect as the command-line `-T' option.
735 The buffer Major Mode controls Ispell's parsing in tex or nroff mode,
736 but the dictionary can control the extended character mode.
737 Both defaults can be overruled in a buffer-local fashion. See
738 `ispell-parsing-keyword' for details on this.
740 CHARACTER-SET used to encode text sent to the ispell subprocess
741 when the language uses non-ASCII characters.
743 Note that with \"ispell\" as the speller, the CASECHARS and
744 OTHERCHARS slots of the alist should contain the same character
745 set as casechars and otherchars in the LANGUAGE.aff file \(e.g.,
746 english.aff\). aspell and hunspell don't have this limitation.")
748 (defvar ispell-really-aspell nil
) ; Non-nil if we can use aspell extensions.
749 (defvar ispell-really-hunspell nil
) ; Non-nil if we can use hunspell extensions.
750 (defvar ispell-encoding8-command nil
751 "Command line option prefix to select encoding if supported, nil otherwise.
752 If setting the encoding is supported by spellchecker and is selectable from
753 the command line, this variable will contain \"--encoding=\" for aspell
754 and \"-i \" for hunspell, so the appropriate mime charset can be selected.
755 That will be set in `ispell-check-version' for hunspell >= 1.1.6 and
758 For aspell, non-nil also means to try to automatically find its dictionaries.
760 Earlier aspell versions do not consistently support charset encoding. Handling
761 this would require some extra guessing in `ispell-aspell-find-dictionary'.")
763 (defvar ispell-aspell-supports-utf8 nil
764 "Non-nil if aspell has consistent command line UTF-8 support. Obsolete.
765 ispell.el and flyspell.el will use for this purpose the more generic
766 variable `ispell-encoding8-command' for both aspell and hunspell. Is left
767 here just for backwards compatibility.")
769 (make-obsolete-variable 'ispell-aspell-supports-utf8
770 'ispell-encoding8-command
"23.1")
772 (defvar ispell-emacs-alpha-regexp
773 (if (string-match "^[[:alpha:]]+$" "abcde")
776 "[[:alpha:]] if Emacs supports [:alpha:] regexp, nil
777 otherwise (current XEmacs does not support it).")
779 ;;; **********************************************************************
780 ;;; The following are used by ispell, and should not be changed.
781 ;;; **********************************************************************
785 ;; The version must be 3.1 or greater for this version of ispell.el
786 ;; There is an incompatibility between version 3.1.12 and lower versions.
787 (defconst ispell-required-version
'(3 1 12)
788 "Ispell versions with which this version of ispell.el is known to work.")
789 (defvar ispell-offset -
1
790 "Offset that maps protocol differences between ispell 3.1 versions.")
792 (defconst ispell-version
"ispell.el 3.6 - 7-Jan-2003")
795 (defun ispell-check-version (&optional interactivep
)
796 "Ensure that `ispell-program-name' is valid and has the correct version.
797 Returns version number if called interactively.
798 Otherwise returns the library directory name, if that is defined."
799 ;; This is a little wasteful as we actually launch ispell twice: once
800 ;; to make sure it's the right version, and once for real. But people
801 ;; get confused by version mismatches *all* the time (and I've got the
802 ;; email to prove it) so I think this is worthwhile. And the -v[ersion]
803 ;; option is the only way I can think of to do this that works with
804 ;; all versions, since versions earlier than 3.0.09 didn't identify
805 ;; themselves on startup.
807 (let ((default-directory (or (and (boundp 'temporary-file-directory
)
808 temporary-file-directory
)
810 result status ispell-program-version
)
813 (setq status
(ispell-call-process
814 ispell-program-name nil t nil
815 ;; aspell doesn't accept the -vv switch.
816 (let ((case-fold-search
817 (memq system-type
'(ms-dos windows-nt
)))
819 (file-name-nondirectory ispell-program-name
)))
820 ;; Assume anything that isn't `aspell' is Ispell.
821 (if (string-match "\\`aspell" speller
) "-v" "-vv"))))
822 (goto-char (point-min))
824 ;; report version information of ispell and ispell.el
827 (setq result
(concat (buffer-substring-no-properties (point-min)
831 (message "%s" result
))
832 ;; return library directory.
833 (if (re-search-forward "LIBDIR = \\\"\\([^ \t\n]*\\)\\\"" nil t
)
834 (setq result
(match-string 1))))
835 (goto-char (point-min))
836 (if (not (memq status
'(0 nil
)))
837 (error "%s exited with %s %s" ispell-program-name
838 (if (stringp status
) "signal" "code") status
))
840 ;; Get relevant version strings. Only xx.yy.... format works well
841 (let (case-fold-search)
842 (setq ispell-program-version
843 (and (search-forward-regexp "\\([0-9]+\\.[0-9\\.]+\\)" nil t
)
846 ;; Make sure these variables are (re-)initialized to the default value
847 (setq ispell-really-aspell nil
848 ispell-aspell-supports-utf8 nil
849 ispell-really-hunspell nil
850 ispell-encoding8-command nil
)
852 (goto-char (point-min))
853 (or (setq ispell-really-aspell
854 (and (search-forward-regexp
855 "(but really Aspell \\([0-9]+\\.[0-9\\.-]+\\)?)" nil t
)
857 (setq ispell-really-hunspell
858 (and (search-forward-regexp
859 "(but really Hunspell \\([0-9]+\\.[0-9\\.-]+\\)?)"
863 (let ((aspell-minver "0.50")
864 (aspell8-minver "0.60")
865 (ispell0-minver "3.1.0")
866 (ispell-minver "3.1.12")
867 (hunspell8-minver "1.1.6"))
869 (if (ispell-check-minver ispell0-minver ispell-program-version
)
870 (or (ispell-check-minver ispell-minver ispell-program-version
)
871 (setq ispell-offset
0))
872 (error "%s release %s or greater is required"
877 (ispell-really-aspell
878 (if (ispell-check-minver aspell-minver ispell-really-aspell
)
879 (if (ispell-check-minver aspell8-minver ispell-really-aspell
)
881 (setq ispell-aspell-supports-utf8 t
)
882 (setq ispell-encoding8-command
"--encoding=")))
883 (setq ispell-really-aspell nil
)))
884 (ispell-really-hunspell
885 (if (ispell-check-minver hunspell8-minver ispell-really-hunspell
)
886 (setq ispell-encoding8-command
"-i")
887 (setq ispell-really-hunspell nil
))))))
890 (defun ispell-call-process (&rest args
)
891 "Like `call-process' but defend against bad `default-directory'."
892 (let ((default-directory default-directory
))
893 (unless (and (file-directory-p default-directory
)
894 (file-readable-p default-directory
))
895 (setq default-directory
(expand-file-name "~/")))
896 (apply 'call-process args
)))
898 (defun ispell-call-process-region (&rest args
)
899 "Like `call-process-region' but defend against bad `default-directory'."
900 (let ((default-directory default-directory
))
901 (unless (and (file-directory-p default-directory
)
902 (file-readable-p default-directory
))
903 (setq default-directory
(expand-file-name "~/")))
904 (apply 'call-process-region args
)))
908 ;; The preparation of the menu bar menu must be autoloaded
909 ;; because otherwise this file gets autoloaded every time Emacs starts
910 ;; so that it can set up the menus and determine keyboard equivalents.
913 (defvar ispell-menu-map nil
"Key map for ispell menu.")
914 ;; Redo menu when loading ispell to get dictionary modifications
915 (setq ispell-menu-map nil
)
918 (defvar ispell-menu-xemacs nil
919 "Spelling menu for XEmacs.
920 If nil when package is loaded, a standard menu will be set,
921 and added as a submenu of the \"Edit\" menu.")
923 ;; Break out XEmacs menu and split into several calls to avoid having
924 ;; long lines in loaddefs.el. Detect need off following constant.
926 ;;; Set up dictionary
928 (defvar ispell-menu-map-needed
929 ;; only needed when not version 18 and not XEmacs.
930 (and (not ispell-menu-map
)
931 (not (featurep 'xemacs
))
934 (defvar ispell-library-directory
(condition-case ()
935 (ispell-check-version)
937 "Directory where ispell dictionaries reside.")
939 (defvar ispell-process nil
940 "The process object for Ispell.")
942 (defvar ispell-async-processp
(and (fboundp 'delete-process
)
943 (fboundp 'process-send-string
)
944 (fboundp 'accept-process-output
)
945 ;;(fboundp 'start-process)
946 ;;(fboundp 'set-process-filter)
947 ;;(fboundp 'process-kill-without-query)
949 "Non-nil means that the OS supports asynchronous processes.")
951 ;; Make ispell.el work better with aspell.
953 (defvar ispell-aspell-dictionary-alist nil
954 "An alist of parsed aspell dicts and associated parameters.
957 (defun ispell-find-aspell-dictionaries ()
958 "Find Aspell's dictionaries, and record in `ispell-dictionary-alist'."
959 (unless (and ispell-really-aspell ispell-encoding8-command
)
960 (error "This function only works with aspell >= 0.60"))
964 (ispell-call-process ispell-program-name nil t nil
"dicts")
966 ;; Search for the named dictionaries.
969 (mapcar #'ispell-aspell-find-dictionary dictionaries
))))
970 ;; Ensure aspell's alias dictionary will override standard
972 (setq found
(ispell-aspell-add-aliases found
))
973 ;; Merge into FOUND any elements from the standard ispell-dictionary-base-alist
974 ;; which have no element in FOUND at all.
975 (dolist (dict ispell-dictionary-base-alist
)
976 (unless (assoc (car dict
) found
)
977 (setq found
(nconc found
(list dict
)))))
978 (setq ispell-aspell-dictionary-alist found
)
979 ;; Add a default entry
981 '(nil "[[:alpha:]]" "[^[:alpha:]]" "[']" nil
("-B") nil utf-8
)))
982 (push default-dict ispell-aspell-dictionary-alist
))))
984 (defvar ispell-aspell-data-dir nil
985 "Data directory of Aspell.")
987 (defvar ispell-aspell-dict-dir nil
988 "Dictionary directory of Aspell.")
990 (defun ispell-get-aspell-config-value (key)
991 "Return value of Aspell configuration option KEY.
992 Assumes that value contains no whitespace."
994 (ispell-call-process ispell-program-name nil t nil
"config" key
)
995 (car (split-string (buffer-string)))))
997 (defun ispell-aspell-find-dictionary (dict-name)
998 "For aspell dictionary DICT-NAME, return a list of parameters if an
999 associated data file is found or nil otherwise. List format is that
1000 of `ispell-dictionary-base-alist' elements."
1001 ;; Make sure `ispell-aspell-data-dir' is defined
1002 (or ispell-aspell-data-dir
1003 (setq ispell-aspell-data-dir
1004 (ispell-get-aspell-config-value "data-dir")))
1005 ;; Try finding associated datafile
1007 (concat ispell-aspell-data-dir
"/"
1008 ;; Strip out variant, country code, etc.
1009 (and (string-match "^[[:alpha:]]+" dict-name
)
1010 (match-string 0 dict-name
)) ".dat"))
1012 (concat ispell-aspell-data-dir
"/"
1013 ;; Strip out anything but xx_YY.
1014 (and (string-match "^[[:alpha:]_]+" dict-name
)
1015 (match-string 0 dict-name
)) ".dat"))
1017 (if (file-readable-p datafile1
)
1019 (if (file-readable-p datafile2
)
1025 (insert-file-contents data-file
)
1026 ;; There is zero or one line with special characters declarations.
1027 (when (search-forward-regexp "^special" nil t
)
1028 (let ((specials (split-string
1029 (buffer-substring (point)
1030 (progn (end-of-line) (point))))))
1031 ;; The line looks like: special ' -** - -** . -** : -*-
1032 ;; -** means that this character
1033 ;; - doesn't appear at word start
1034 ;; * may appear in the middle of a word
1035 ;; * may appear at word end
1036 ;; `otherchars' is about the middle case.
1038 (when (eq (aref (cadr specials
) 1) ?
*)
1039 (push (car specials
) otherchars
))
1040 (setq specials
(cddr specials
)))))
1044 (regexp-opt otherchars
)
1045 t
; We can't tell, so set this to t
1046 (list "-d" dict-name
)
1047 nil
; aspell doesn't support this
1048 ;; Here we specify the encoding to use while communicating with
1049 ;; aspell. This doesn't apply to command line arguments, so
1050 ;; just don't pass words to spellcheck as arguments...
1053 (defun ispell-aspell-add-aliases (alist)
1054 "Find aspell's dictionary aliases and add them to dictionary ALIST.
1055 Return the new dictionary alist."
1057 (file-expand-wildcards
1058 (concat (or ispell-aspell-dict-dir
1059 (setq ispell-aspell-dict-dir
1060 (ispell-get-aspell-config-value "dict-dir")))
1062 (dolist (alias-file aliases
)
1064 (insert-file-contents alias-file
)
1065 ;; Look for a line "add FOO.multi", extract FOO
1066 (when (search-forward-regexp "^add \\([^.]+\\)\\.multi" nil t
)
1067 (let* ((aliasname (file-name-sans-extension
1068 (file-name-nondirectory alias-file
)))
1069 (already-exists-p (assoc aliasname alist
))
1070 (realname (match-string 1))
1071 (realdict (assoc realname alist
)))
1072 (when (and realdict
(not already-exists-p
))
1073 (push (cons aliasname
(cdr realdict
)) alist
))))))
1076 ;; Set params according to the selected spellchecker
1078 (defvar ispell-last-program-name nil
1079 "Last value of `ispell-program-name'. Internal use.")
1081 (defvar ispell-initialize-spellchecker-hook nil
1082 "Normal hook run on spellchecker initialization.
1083 This hook is run when a spellchecker is used for the first
1084 time, before `ispell-dictionary-alist' is set. It is intended for
1085 sysadmins to override entries in `ispell-dictionary-base-alist'
1086 by putting those overrides in `ispell-base-dicts-override-alist', which is
1087 a dynamically scoped var with same format as `ispell-dictionary-alist'.
1088 This alist will not override the auto-detected values (e.g. if a recent
1089 aspell is used along with Emacs).")
1091 (defun ispell-set-spellchecker-params ()
1092 "Initialize some spellchecker parameters when changed or first used."
1093 (unless (eq ispell-last-program-name ispell-program-name
)
1094 (setq ispell-last-program-name ispell-program-name
)
1095 (ispell-kill-ispell t
)
1096 (if (and (condition-case ()
1098 (setq ispell-library-directory
(ispell-check-version))
1101 ispell-really-aspell
1102 ispell-encoding8-command
1103 ispell-emacs-alpha-regexp
)
1104 (unless ispell-aspell-dictionary-alist
1105 (ispell-find-aspell-dictionaries)))
1107 ;; Substitute ispell-dictionary-alist with the list of dictionaries
1108 ;; corresponding to the given spellchecker. If a recent aspell, use
1109 ;; the list of really installed dictionaries and add to it elements
1110 ;; of the original list that are not present there. Allow distro info.
1111 (let ((found-dicts-alist
1112 (if (and ispell-really-aspell
1113 ispell-encoding8-command
)
1114 ispell-aspell-dictionary-alist
1116 ispell-base-dicts-override-alist
; Override only base-dicts-alist
1119 (run-hooks 'ispell-initialize-spellchecker-hook
)
1121 ;; Add dicts to ``ispell-dictionary-alist'' unless already present.
1122 (dolist (dict (append found-dicts-alist
1123 ispell-base-dicts-override-alist
1124 ispell-dictionary-base-alist
))
1125 (unless (assoc (car dict
) all-dicts-alist
)
1126 (add-to-list 'all-dicts-alist dict
)))
1127 (setq ispell-dictionary-alist all-dicts-alist
))
1129 ;; If Emacs flavor supports [:alpha:] use it for global dicts. If
1130 ;; spellchecker also supports UTF-8 via command-line option use it
1131 ;; in communication. This does not affect definitions in ~/.emacs.
1132 (if ispell-emacs-alpha-regexp
1133 (let (tmp-dicts-alist)
1134 (dolist (adict ispell-dictionary-alist
)
1135 (add-to-list 'tmp-dicts-alist
1137 (nth 0 adict
) ; dict name
1138 "[[:alpha:]]" ; casechars
1139 "[^[:alpha:]]" ; not-casechars
1140 (nth 3 adict
) ; otherchars
1141 (nth 4 adict
) ; many-otherchars-p
1142 (nth 5 adict
) ; ispell-args
1143 (nth 6 adict
) ; extended-character-mode
1144 (if ispell-encoding8-command
1147 (setq ispell-dictionary-alist tmp-dicts-alist
)))))
1149 (defun ispell-valid-dictionary-list ()
1150 "Return a list of valid dictionaries.
1151 The variable `ispell-library-directory' defines their location."
1152 ;; Initialize variables and dictionaries alists for desired spellchecker.
1153 ;; Make sure ispell.el is loaded to avoid some autoload loops in XEmacs
1154 ;; (and may be others)
1155 (if (featurep 'ispell
)
1156 (ispell-set-spellchecker-params))
1158 (let ((dicts (append ispell-local-dictionary-alist ispell-dictionary-alist
))
1159 (dict-list (cons "default" nil
))
1161 (dolist (dict dicts
)
1162 (setq name
(car dict
)
1163 dict-bname
(or (car (cdr (member "-d" (nth 5 dict
))))
1165 ;; Include if the dictionary is in the library, or dir not defined.
1168 ;; For Aspell, we already know which dictionaries exist.
1169 (or ispell-really-aspell
1170 ;; Include all dictionaries if lib directory not known.
1171 ;; Same for Hunspell, where ispell-library-directory is nil.
1172 (not ispell-library-directory
)
1173 (file-exists-p (concat ispell-library-directory
1174 "/" dict-bname
".hash"))
1175 (file-exists-p (concat ispell-library-directory
1176 "/" dict-bname
".has"))))
1177 (push name dict-list
)))
1180 ;; Define commands in menu in opposite order you want them to appear.
1182 (if ispell-menu-map-needed
1184 (setq ispell-menu-map
(make-sparse-keymap "Spell"))
1185 (define-key ispell-menu-map
[ispell-change-dictionary
]
1186 `(menu-item ,(purecopy "Change Dictionary...") ispell-change-dictionary
1187 :help
,(purecopy "Supply explicit dictionary file name")))
1188 (define-key ispell-menu-map
[ispell-kill-ispell
]
1189 `(menu-item ,(purecopy "Kill Process")
1190 (lambda () (interactive) (ispell-kill-ispell nil
'clear
))
1191 :enable
(and (boundp 'ispell-process
) ispell-process
1192 (eq (ispell-process-status) 'run
))
1193 :help
,(purecopy "Terminate Ispell subprocess")))
1194 (define-key ispell-menu-map
[ispell-pdict-save
]
1195 `(menu-item ,(purecopy "Save Dictionary")
1196 (lambda () (interactive) (ispell-pdict-save t t
))
1197 :help
,(purecopy "Save personal dictionary")))
1198 (define-key ispell-menu-map
[ispell-customize
]
1199 `(menu-item ,(purecopy "Customize...")
1200 (lambda () (interactive) (customize-group 'ispell
))
1201 :help
,(purecopy "Customize spell checking options")))
1202 (define-key ispell-menu-map
[ispell-help
]
1203 ;; use (x-popup-menu last-nonmenu-event(list "" ispell-help-list)) ?
1204 `(menu-item ,(purecopy "Help")
1205 (lambda () (interactive) (describe-function 'ispell-help
))
1206 :help
,(purecopy "Show standard Ispell keybindings and commands")))
1207 (define-key ispell-menu-map
[flyspell-mode
]
1208 `(menu-item ,(purecopy "Automatic spell checking (Flyspell)")
1210 :help
,(purecopy "Check spelling while you edit the text")
1211 :button
(:toggle .
(bound-and-true-p flyspell-mode
))))
1212 (define-key ispell-menu-map
[ispell-complete-word
]
1213 `(menu-item ,(purecopy "Complete Word") ispell-complete-word
1214 :help
,(purecopy "Complete word at cursor using dictionary")))
1215 (define-key ispell-menu-map
[ispell-complete-word-interior-frag
]
1216 `(menu-item ,(purecopy "Complete Word Fragment")
1217 ispell-complete-word-interior-frag
1218 :help
,(purecopy "Complete word fragment at cursor")))))
1221 (if ispell-menu-map-needed
1223 (define-key ispell-menu-map
[ispell-continue
]
1224 `(menu-item ,(purecopy "Continue Spell-Checking") ispell-continue
1225 :enable
(and (boundp 'ispell-region-end
)
1226 (marker-position ispell-region-end
)
1227 (equal (marker-buffer ispell-region-end
)
1229 :help
,(purecopy "Continue spell checking last region")))
1230 (define-key ispell-menu-map
[ispell-word
]
1231 `(menu-item ,(purecopy "Spell-Check Word") ispell-word
1232 :help
,(purecopy "Spell-check word at cursor")))
1233 (define-key ispell-menu-map
[ispell-comments-and-strings
]
1234 `(menu-item ,(purecopy "Spell-Check Comments")
1235 ispell-comments-and-strings
1236 :help
,(purecopy "Spell-check only comments and strings")))))
1239 (if ispell-menu-map-needed
1241 (define-key ispell-menu-map
[ispell-region
]
1242 `(menu-item ,(purecopy "Spell-Check Region") ispell-region
1244 :help
,(purecopy "Spell-check text in marked region")))
1245 (define-key ispell-menu-map
[ispell-message
]
1246 `(menu-item ,(purecopy "Spell-Check Message") ispell-message
1247 :visible
(eq major-mode
'mail-mode
)
1248 :help
,(purecopy "Skip headers and included message text")))
1249 (define-key ispell-menu-map
[ispell-buffer
]
1250 `(menu-item ,(purecopy "Spell-Check Buffer") ispell-buffer
1251 :help
,(purecopy "Check spelling of selected buffer")))
1252 ;;(put 'ispell-region 'menu-enable 'mark-active)
1253 (fset 'ispell-menu-map
(symbol-value 'ispell-menu-map
))))
1255 ;;; XEmacs versions 19 & 20
1256 (if (and (featurep 'xemacs
)
1258 ;;(null ispell-menu-xemacs)
1259 (not (and (boundp 'infodock-version
) infodock-version
)))
1260 (let ((dicts (if (fboundp 'ispell-valid-dictionary-list
)
1261 (reverse (ispell-valid-dictionary-list))))
1262 (current-menubar (or current-menubar default-menubar
))
1264 '(["Help" (describe-function 'ispell-help
) t
]
1265 ;;["Help" (popup-menu ispell-help-list) t]
1266 ["Check Message" ispell-message t
]
1267 ["Check Buffer" ispell-buffer t
]
1268 ["Check Comments" ispell-comments-and-strings t
]
1269 ["Check Word" ispell-word t
]
1270 ["Check Region" ispell-region
(or (not zmacs-regions
) (mark))]
1271 ["Continue Check" ispell-continue t
]
1272 ["Complete Word Frag"ispell-complete-word-interior-frag t
]
1273 ["Complete Word" ispell-complete-word t
]
1274 ["Kill Process" (ispell-kill-ispell nil
'clear
) t
]
1275 ["Customize..." (customize-group 'ispell
) t
]
1276 ;; flyspell-mode may not be bound...
1277 ;;["flyspell" flyspell-mode
1278 ;; :style toggle :selected flyspell-mode ]
1280 ["Save Personal Dict"(ispell-pdict-save t t
) t
]
1281 ["Change Dictionary" ispell-change-dictionary t
])))
1283 (setq dicts
(cons "default" nil
)))
1284 (dolist (name dicts
)
1285 (setq menu
(append menu
1288 (concat "Select " (capitalize name
))
1289 (list 'ispell-change-dictionary name
)
1291 (setq ispell-menu-xemacs menu
)
1294 (if (car (find-menu-item current-menubar
'("Cmds")))
1297 (delete-menu-item '("Cmds" "Spell-Check"))
1298 (add-menu '("Cmds") "Spell-Check" ispell-menu-xemacs
))
1300 (delete-menu-item '("Edit" "Spell")) ; in case already defined
1301 (add-menu '("Edit") "Spell" ispell-menu-xemacs
))))))
1303 (defalias 'ispell-int-char
1304 ;; Allow incrementing characters as integers in XEmacs 20
1305 (if (and (featurep 'xemacs
)
1306 (fboundp 'int-char
))
1308 ;; Emacs and XEmacs 19 or earlier
1312 ;;; **********************************************************************
1314 (defvar ispell-current-dictionary nil
1315 "The name of the current dictionary, or nil for the default.
1316 This is passed to the ispell process using the `-d' switch and is
1317 used as key in `ispell-local-dictionary-alist' and `ispell-dictionary-alist'.")
1319 (defvar ispell-current-personal-dictionary nil
1320 "The name of the current personal dictionary, or nil for the default.
1321 This is passed to the ispell process using the `-p' switch.")
1323 (defun ispell-decode-string (str)
1324 "Decodes multibyte character strings.
1325 Protects against bogus binding of `enable-multibyte-characters' in XEmacs."
1326 ;; FIXME: enable-multibyte-characters is read-only, so bogus bindings are
1327 ;; really nasty (they signal an error in Emacs): Who does that? --Stef
1328 (if (and (or (featurep 'xemacs
)
1329 (and (boundp 'enable-multibyte-characters
)
1330 enable-multibyte-characters
))
1331 (fboundp 'decode-coding-string
)
1332 (ispell-get-coding-system))
1333 (decode-coding-string str
(ispell-get-coding-system))
1336 ;; Return a string decoded from Nth element of the current dictionary.
1337 (defun ispell-get-decoded-string (n)
1338 "Get the decoded string in slot N of the descriptor of the current dict."
1340 (assoc ispell-current-dictionary ispell-local-dictionary-alist
)
1341 (assoc ispell-current-dictionary ispell-dictionary-alist
)
1342 (error "No data for dictionary \"%s\", neither in `ispell-local-dictionary-alist' nor in `ispell-dictionary-alist'"
1343 ispell-current-dictionary
)))
1345 (when (and (> (length str
) 0)
1346 (not (multibyte-string-p str
)))
1347 (setq str
(ispell-decode-string str
))
1348 (or (multibyte-string-p str
)
1349 (setq str
(string-to-multibyte str
))))
1352 (defun ispell-get-casechars ()
1353 (ispell-get-decoded-string 1))
1354 (defun ispell-get-not-casechars ()
1355 (ispell-get-decoded-string 2))
1356 (defun ispell-get-otherchars ()
1357 (ispell-get-decoded-string 3))
1358 (defun ispell-get-many-otherchars-p ()
1359 (nth 4 (or (assoc ispell-current-dictionary ispell-local-dictionary-alist
)
1360 (assoc ispell-current-dictionary ispell-dictionary-alist
))))
1361 (defun ispell-get-ispell-args ()
1362 (nth 5 (or (assoc ispell-current-dictionary ispell-local-dictionary-alist
)
1363 (assoc ispell-current-dictionary ispell-dictionary-alist
))))
1364 (defun ispell-get-extended-character-mode ()
1365 (if ispell-really-hunspell
;; hunspell treats ~word as ordinary words
1366 nil
;; in pipe mode. Disable extended-char-mode
1367 (nth 6 (or (assoc ispell-current-dictionary ispell-local-dictionary-alist
)
1368 (assoc ispell-current-dictionary ispell-dictionary-alist
)))))
1369 (defun ispell-get-coding-system ()
1370 (nth 7 (or (assoc ispell-current-dictionary ispell-local-dictionary-alist
)
1371 (assoc ispell-current-dictionary ispell-dictionary-alist
))))
1374 (defvar ispell-pdict-modified-p nil
1375 "Non-nil means personal dictionary has modifications to be saved.")
1377 ;; If you want to save the dictionary when quitting, must do so explicitly.
1378 ;; When non-nil, the spell session is terminated.
1379 ;; When numeric, contains cursor location in buffer, and cursor remains there.
1380 (defvar ispell-quit nil
)
1382 (defvar ispell-process-directory nil
1383 "The directory where `ispell-process' was started.")
1385 (defvar ispell-filter nil
1386 "Output filter from piped calls to Ispell.")
1388 (defvar ispell-filter-continue nil
1389 "Control variable for Ispell filter function.")
1391 (defvar ispell-output-buffer nil
1392 "Buffer used for reading output of a synchronous Ispell subprocess.")
1394 (defvar ispell-session-buffer nil
1395 "Buffer used for passing input to a synchronous Ispell subprocess.")
1397 (defvar ispell-cmd-args nil
1398 "Command-line arguments to pass to a synchronous Ispell subprocess.")
1400 (defvar ispell-query-replace-marker
(make-marker)
1401 "Marker for `query-replace' processing.")
1403 (defvar ispell-recursive-edit-marker
(make-marker)
1404 "Marker for return point from recursive edit.")
1406 (defvar ispell-checking-message nil
1407 "Non-nil when we're checking a mail message.
1408 Set to the MIME boundary locations when checking messages.")
1410 (defconst ispell-choices-buffer
"*Choices*")
1412 (defvar ispell-overlay nil
"Overlay variable for Ispell highlighting.")
1414 ;;; *** Buffer Local Definitions ***
1416 (defconst ispell-words-keyword
"LocalWords: "
1417 "The keyword for local oddly-spelled words to accept.
1418 The keyword will be followed by any number of local word spellings.
1419 There can be multiple instances of this keyword in the file.")
1421 (defconst ispell-dictionary-keyword
"Local IspellDict: "
1422 "The keyword for a local dictionary to use.
1423 The keyword must be followed by a valid dictionary name, defined in
1424 `ispell-local-dictionary-alist' or `ispell-dictionary-alist'.
1425 When multiple occurrences exist, the last keyword
1426 definition is used.")
1428 (defconst ispell-pdict-keyword
"Local IspellPersDict: "
1429 "The keyword for defining buffer local dictionaries.
1430 Keyword must be followed by the filename of a personal dictionary.
1431 The last occurring definition in the buffer will be used.")
1433 (defconst ispell-parsing-keyword
"Local IspellParsing: "
1434 "The keyword for overriding default Ispell parsing.
1435 The above keyword string should be followed by `latex-mode' or
1436 `nroff-mode' to put the current buffer into the desired parsing mode.
1438 Extended character mode can be changed for this buffer by placing
1439 a `~' followed by an extended-character mode -- such as `~.tex'.
1440 The last occurring definition in the buffer will be used.")
1443 (defvar ispell-skip-region-alist
1444 `((ispell-words-keyword forward-line
)
1445 (ispell-dictionary-keyword forward-line
)
1446 (ispell-pdict-keyword forward-line
)
1447 (ispell-parsing-keyword forward-line
)
1448 (,(purecopy "^---*BEGIN PGP [A-Z ]*--*")
1449 .
,(purecopy "^---*END PGP [A-Z ]*--*"))
1450 ;; assume multiline uuencoded file? "\nM.*$"?
1451 (,(purecopy "^begin [0-9][0-9][0-9] [^ \t]+$") .
,(purecopy "\nend\n"))
1452 (,(purecopy "^%!PS-Adobe-[123].0") .
,(purecopy "\n%%EOF\n"))
1453 (,(purecopy "^---* \\(Start of \\)?[Ff]orwarded [Mm]essage")
1454 .
,(purecopy "^---* End of [Ff]orwarded [Mm]essage"))
1455 ;; Matches e-mail addresses, file names, http addresses, etc. The
1456 ;; `-+' `_+' patterns are necessary for performance reasons when
1457 ;; `-' or `_' part of word syntax.
1458 (,(purecopy "\\(--+\\|_+\\|\\(/\\w\\|\\(\\(\\w\\|[-_]\\)+[.:@]\\)\\)\\(\\w\\|[-_]\\)*\\([.:/@]+\\(\\w\\|[-_~=?&]\\)+\\)+\\)"))
1459 ;; above checks /.\w sequences
1460 ;;("\\(--+\\|\\(/\\|\\(\\(\\w\\|[-_]\\)+[.:@]\\)\\)\\(\\w\\|[-_]\\)*\\([.:/@]+\\(\\w\\|[-_~=?&]\\)+\\)+\\)")
1461 ;; This is a pretty complex regexp. It can be simplified to the following:
1462 ;; "\\(\\w\\|[-_]\\)*\\([.:/@]+\\(\\w\\|[-_]\\|~\\)+\\)+"
1463 ;; but some valid text will be skipped, e.g. "his/her". This could be
1464 ;; fixed up (at the expense of a moderately more complex regexp)
1465 ;; by not allowing "/" to be the character which triggers the
1466 ;; identification of the computer name, e.g.:
1467 ;; "\\(\\w\\|[-_]\\)+[.:@]\\(\\w\\|[-_]\\)*\\([.:/@]+\\(\\w\\|[-_]\\|~\\)+\\)+"
1469 "Alist expressing beginning and end of regions not to spell check.
1470 The alist key must be a regular expression.
1471 Valid forms include:
1472 (KEY) - just skip the key.
1473 (KEY . REGEXP) - skip to the end of REGEXP. REGEXP may be string or symbol.
1474 (KEY REGEXP) - skip to end of REGEXP. REGEXP must be a string.
1475 (KEY FUNCTION ARGS) - FUNCTION called with ARGS returns end of region.")
1476 (put 'ispell-skip-region-alist
'risky-local-variable t
)
1480 (defvar ispell-tex-skip-alists
1482 '((;;("%\\[" . "%\\]") ; AMStex block comment...
1483 ;; All the standard LaTeX keywords from L. Lamport's guide:
1484 ;; \cite, \hspace, \hspace*, \hyphenation, \include, \includeonly, \input,
1485 ;; \label, \nocite, \rule (in ispell - rest included here)
1486 ("\\\\addcontentsline" ispell-tex-arg-end
2)
1487 ("\\\\add\\(tocontents\\|vspace\\)" ispell-tex-arg-end
)
1488 ("\\\\\\([aA]lph\\|arabic\\)" ispell-tex-arg-end
)
1489 ;;("\\\\author" ispell-tex-arg-end)
1490 ("\\\\bibliographystyle" ispell-tex-arg-end
)
1491 ("\\\\makebox" ispell-tex-arg-end
0)
1492 ("\\\\e?psfig" ispell-tex-arg-end
)
1493 ("\\\\document\\(class\\|style\\)" .
1494 "\\\\begin[ \t\n]*{[ \t\n]*document[ \t\n]*}"))
1495 (;; delimited with \begin. In ispell: displaymath, eqnarray, eqnarray*,
1496 ;; equation, minipage, picture, tabular, tabular* (ispell)
1497 ("\\(figure\\|table\\)\\*?" ispell-tex-arg-end
0)
1498 ("list" ispell-tex-arg-end
2)
1499 ("program" .
"\\\\end[ \t\n]*{[ \t\n]*program[ \t\n]*}")
1500 ("verbatim\\*?" .
"\\\\end[ \t\n]*{[ \t\n]*verbatim\\*?[ \t\n]*}"))))
1501 "Lists of regions to be skipped in TeX mode.
1502 First list is used raw.
1503 Second list has key placed inside \\begin{}.
1505 Delete or add any regions you want to be automatically selected
1506 for skipping in latex mode.")
1507 (put 'ispell-tex-skip-alist
'risky-local-variable t
)
1511 (defconst ispell-html-skip-alists
1512 '(("<[cC][oO][dD][eE]\\>[^>]*>" "</[cC][oO][dD][eE]*>")
1513 ("<[sS][cC][rR][iI][pP][tT]\\>[^>]*>" "</[sS][cC][rR][iI][pP][tT]>")
1514 ("<[aA][pP][pP][lL][eE][tT]\\>[^>]*>" "</[aA][pP][pP][lL][eE][tT]>")
1515 ("<[vV][eE][rR][bB]\\>[^>]*>" "<[vV][eE][rR][bB]\\>[^>]*>")
1516 ;;("<[tT][tT]\\>[^>]*>" "<[tT][tT]\\>[^>]*>")
1519 ("&[^ \t\n;]" "[; \t\n]"))
1520 "Lists of start and end keys to skip in HTML buffers.
1521 Same format as `ispell-skip-region-alist'.
1522 Note - substrings of other matches must come last
1523 (e.g. \"<[tT][tT]/\" and \"<[^ \\t\\n>]\").")
1524 (put 'ispell-html-skip-alists
'risky-local-variable t
)
1526 (defvar ispell-local-pdict ispell-personal-dictionary
1527 "A buffer local variable containing the current personal dictionary.
1528 If non-nil, the value must be a string, which is a file name.
1530 If you specify a personal dictionary for the current buffer which is
1531 different from the current personal dictionary, the effect is similar
1532 to calling \\[ispell-change-dictionary]. This variable is automatically
1533 set when defined in the file with either `ispell-pdict-keyword' or the
1534 local variable syntax.")
1536 (make-variable-buffer-local 'ispell-local-pdict
)
1537 ;;;###autoload(put 'ispell-local-pdict 'safe-local-variable 'stringp)
1539 (defvar ispell-buffer-local-name nil
1540 "Contains the buffer name if local word definitions were used.
1541 Ispell is then restarted because the local words could conflict.")
1543 (defvar ispell-buffer-session-localwords nil
1544 "List of words accepted for session in this buffer.")
1546 (make-variable-buffer-local 'ispell-buffer-session-localwords
)
1548 (defvar ispell-parser
'use-mode-name
1549 "Indicates whether ispell should parse the current buffer as TeX Code.
1550 Special value `use-mode-name' tries to guess using the name of `major-mode'.
1551 Default parser is `nroff'.
1552 Currently the only other valid parser is `tex'.
1554 You can set this variable in hooks in your init file -- eg:
1556 \(add-hook 'tex-mode-hook (lambda () (setq ispell-parser 'tex)))")
1558 (defvar ispell-region-end
(make-marker)
1559 "Marker that allows spelling continuations.")
1561 (defvar ispell-check-only nil
1562 "If non-nil, `ispell-word' does not try to correct the word.")
1565 ;;; **********************************************************************
1566 ;;; **********************************************************************
1570 ;;;###autoload (define-key esc-map "$" 'ispell-word)
1573 (defun ispell-accept-output (&optional timeout-secs timeout-msecs
)
1574 "Wait for output from ispell process, or TIMEOUT-SECS and TIMEOUT-MSECS.
1575 If asynchronous subprocesses are not supported, call `ispell-filter' and
1576 pass it the output of the last ispell invocation."
1577 (if ispell-async-processp
1578 (accept-process-output ispell-process timeout-secs timeout-msecs
)
1579 (if (null ispell-process
)
1580 (error "No Ispell process to read output from!")
1581 (let ((buf ispell-output-buffer
)
1583 (if (not (bufferp buf
))
1584 (setq ispell-filter nil
)
1585 (with-current-buffer buf
1586 (setq ispell-output
(buffer-substring-no-properties
1587 (point-min) (point-max))))
1588 (ispell-filter t ispell-output
)
1589 (with-current-buffer buf
1590 (erase-buffer)))))))
1592 (defun ispell-send-replacement (misspelled replacement
)
1593 "Notify aspell that MISSPELLED should be spelled REPLACEMENT.
1594 This allows it to improve the suggestion list based on actual misspellings."
1595 (and ispell-really-aspell
1596 (ispell-send-string (concat "$$ra " misspelled
"," replacement
"\n"))))
1599 (defun ispell-send-string (string)
1600 "Send the string STRING to the Ispell process."
1601 (if ispell-async-processp
1602 (process-send-string ispell-process string
)
1603 ;; Asynchronous subprocesses aren't supported on this losing system.
1604 ;; We keep all the directives passed to Ispell during the entire
1605 ;; session in a buffer, and pass them anew each time we invoke
1606 ;; Ispell to process another chunk of text. (Yes, I know this is a
1607 ;; terrible kludge, and it's a bit slow, but it does get the work done.)
1608 (let ((cmd (aref string
0))
1609 ;; The following commands are not passed to Ispell until
1610 ;; we have a *real* reason to invoke it.
1611 (cmds-to-defer '(?
* ?
@ ?~ ?
+ ?- ?
! ?%
))
1612 (session-buf ispell-session-buffer
)
1613 (output-buf ispell-output-buffer
)
1614 (ispell-args ispell-cmd-args
)
1615 (defdir ispell-process-directory
)
1617 (with-current-buffer session-buf
1618 (setq prev-pos
(point))
1619 (setq default-directory defdir
)
1621 (if (not (memq cmd cmds-to-defer
))
1622 (let (coding-system-for-read coding-system-for-write status
)
1623 (if (and (boundp 'enable-multibyte-characters
)
1624 enable-multibyte-characters
)
1625 (setq coding-system-for-read
(ispell-get-coding-system)
1626 coding-system-for-write
(ispell-get-coding-system)))
1627 (set-buffer output-buf
)
1629 (set-buffer session-buf
)
1631 (apply 'ispell-call-process-region
1632 (point-min) (point-max)
1633 ispell-program-name nil
1636 ;; hunspell -m option means something different
1637 (if ispell-really-hunspell
"" "-m")
1639 (set-buffer output-buf
)
1640 (goto-char (point-min))
1642 (if (not (looking-at "@(#) "))
1643 (error "Ispell error: %s"
1644 (buffer-substring-no-properties
1645 (point) (progn (end-of-line) (point)))))
1646 ;; If STRING is "^Z\n", we just started Ispell and need
1647 ;; to retain its version ID line in the output buffer.
1648 ;; Otherwise, remove the ID line, as it will confuse
1650 (or (string= string
"\032\n")
1653 (delete-region (point-min) (point))))
1654 ;; If STRING begins with ^ or any normal character, we need
1655 ;; to remove the last line from the session buffer, since it
1656 ;; was just spell-checked, and we don't want to check it again.
1657 ;; The same goes for the # command, since Ispell already saved
1658 ;; the personal dictionary.
1659 (set-buffer session-buf
)
1660 (delete-region prev-pos
(point))
1661 ;; Ispell run synchronously saves the personal dictionary
1662 ;; after each successful command. So we can remove any
1663 ;; lines in the session buffer that insert words into the
1665 (if (memq status
'(0 nil
))
1666 (let ((more-lines t
))
1667 (goto-char (point-min))
1669 (if (looking-at "^\\*")
1670 (let ((start (point)))
1672 (delete-region start
(point)))
1673 (setq more-lines
(= 0 (forward-line))))))))))))))
1677 (defun ispell-word (&optional following quietly continue region
)
1678 "Check spelling of word under or before the cursor.
1679 If the word is not found in dictionary, display possible corrections
1680 in a window allowing you to choose one.
1682 If optional argument FOLLOWING is non-nil or if `ispell-following-word'
1683 is non-nil when called interactively, then the following word
1684 \(rather than preceding\) is checked when the cursor is not over a word.
1685 When the optional argument QUIETLY is non-nil or `ispell-quietly' is non-nil
1686 when called interactively, non-corrective messages are suppressed.
1688 With a prefix argument (or if CONTINUE is non-nil),
1689 resume interrupted spell-checking of a buffer or region.
1691 Interactively, in Transient Mark mode when the mark is active, call
1692 `ispell-region' to check the active region for spelling errors.
1694 Word syntax is controlled by the definition of the chosen dictionary,
1695 which is in `ispell-local-dictionary-alist' or `ispell-dictionary-alist'.
1697 This will check or reload the dictionary. Use \\[ispell-change-dictionary]
1698 or \\[ispell-region] to update the Ispell process.
1701 nil word is correct or spelling is accepted.
1702 0 word is inserted into buffer-local definitions.
1703 \"word\" word corrected from word list.
1704 \(\"word\" arg\) word is hand entered.
1705 quit spell session exited."
1706 (interactive (list ispell-following-word ispell-quietly current-prefix-arg t
))
1709 (if (featurep 'emacs
)
1711 (and (boundp 'transient-mark-mode
) transient-mark-mode
1712 (boundp 'mark-active
) mark-active
1713 (not (eq (region-beginning) (region-end))))))
1714 (ispell-region (region-beginning) (region-end)))
1715 (continue (ispell-continue))
1717 (ispell-set-spellchecker-params) ; Initialize variables and dicts alists
1718 (ispell-accept-buffer-local-defs) ; use the correct dictionary
1719 (let ((cursor-location (point)) ; retain cursor location
1720 (word (ispell-get-word following
))
1721 start end poss new-word replace
)
1722 ;; De-structure return word info list.
1723 (setq start
(car (cdr word
))
1724 end
(car (cdr (cdr word
)))
1727 ;; At this point it used to ignore 2-letter words.
1728 ;; But that is silly; if the user asks for it, we should do it. - rms.
1730 (message "Checking spelling of %s..."
1731 (funcall ispell-format-word-function word
)))
1732 (ispell-send-string "%\n") ; put in verbose mode
1733 (ispell-send-string (concat "^" word
"\n"))
1734 ;; wait until ispell has processed word
1736 (ispell-accept-output)
1737 (not (string= "" (car ispell-filter
)))))
1738 ;;(ispell-send-string "!\n") ;back to terse mode.
1739 (setq ispell-filter
(cdr ispell-filter
)) ; remove extra \n
1740 (if (and ispell-filter
(listp ispell-filter
))
1741 (if (> (length ispell-filter
) 1)
1742 (error "Ispell and its process have different character maps")
1743 (setq poss
(ispell-parse-output (car ispell-filter
)))))
1746 (message "%s is correct"
1747 (funcall ispell-format-word-function word
)))
1748 (and (featurep 'xemacs
)
1750 (and (fboundp 'delete-extent
)
1751 (delete-extent (extent-at start
)))))
1754 (message "%s is correct because of root %s"
1755 (funcall ispell-format-word-function word
)
1756 (funcall ispell-format-word-function poss
)))
1757 (and (featurep 'xemacs
)
1759 (and (fboundp 'delete-extent
)
1760 (delete-extent (extent-at start
)))))
1762 (message "Error checking word %s using %s with %s dictionary"
1763 (funcall ispell-format-word-function word
)
1764 (file-name-nondirectory ispell-program-name
)
1765 (or ispell-current-dictionary
"default")))
1766 (ispell-check-only ; called from ispell minor mode.
1767 (if (fboundp 'make-extent
)
1768 (if (fboundp 'set-extent-property
)
1769 (let ((ext (make-extent start end
)))
1770 (set-extent-property ext
'face ispell-highlight-face
)
1771 (set-extent-property ext
'priority
2000)))
1773 (message "%s is incorrect"
1774 (funcall ispell-format-word-function word
))))
1775 (t ; prompt for correct word.
1776 (save-window-excursion
1777 (setq replace
(ispell-command-loop
1778 (car (cdr (cdr poss
)))
1779 (car (cdr (cdr (cdr poss
))))
1780 (car poss
) start end
)))
1781 (cond ((equal 0 replace
)
1782 (ispell-add-per-file-word-list (car poss
)))
1784 (setq new-word
(if (atom replace
) replace
(car replace
))
1785 cursor-location
(+ (- (length word
) (- end start
))
1787 (if (not (equal new-word
(car poss
)))
1790 ;; Insert first and then delete,
1791 ;; to avoid collapsing markers before and after
1792 ;; into a single place.
1794 (delete-region (point) end
)
1795 ;; It is meaningless to preserve the cursor position
1796 ;; inside a word that has changed.
1797 (setq cursor-location
(point))
1798 (setq end
(point))))
1799 (if (not (atom replace
)) ;recheck spelling of replacement
1801 (if (car (cdr replace
)) ; query replace requested
1802 (save-window-excursion
1803 (query-replace word new-word t
)))
1805 ;; single word could be split into multiple words
1806 (setq ispell-quit
(not (ispell-region start end
)))
1808 ;; keep if rechecking word and we keep choices win.
1809 (if (get-buffer ispell-choices-buffer
)
1810 (kill-buffer ispell-choices-buffer
))))
1811 (ispell-pdict-save ispell-silently-savep
)
1812 ;; NB: Cancels ispell-quit incorrectly if called from ispell-region
1813 (if ispell-quit
(setq ispell-quit nil replace
'quit
))
1814 (goto-char cursor-location
) ; return to original location
1818 (defun ispell-get-word (following &optional extra-otherchars
)
1819 "Return the word for spell-checking according to ispell syntax.
1820 If optional argument FOLLOWING is non-nil or if `ispell-following-word'
1821 is non-nil when called interactively, then the following word
1822 \(rather than preceding\) is checked when the cursor is not over a word.
1823 Optional second argument contains otherchars that can be included in word
1824 many times (see the doc string of `ispell-dictionary-alist' for details
1827 Word syntax is controlled by the definition of the chosen dictionary,
1828 which is in `ispell-local-dictionary-alist' or `ispell-dictionary-alist'."
1829 (ispell-set-spellchecker-params) ; Initialize variables and dicts alists
1830 (let* ((ispell-casechars (ispell-get-casechars))
1831 (ispell-not-casechars (ispell-get-not-casechars))
1832 (ispell-otherchars (ispell-get-otherchars))
1833 (ispell-many-otherchars-p (ispell-get-many-otherchars-p))
1834 (word-regexp (concat ispell-casechars
1836 (if (not (string= "" ispell-otherchars
))
1837 (concat ispell-otherchars
"?"))
1838 (if extra-otherchars
1839 (concat extra-otherchars
"?"))
1842 (if (or ispell-many-otherchars-p
1848 (if (not (looking-at ispell-casechars
))
1850 (re-search-forward ispell-casechars
(point-max) t
)
1851 (re-search-backward ispell-casechars
(point-min) t
)))
1852 ;; move to front of word
1853 (re-search-backward ispell-not-casechars
(point-min) 'start
)
1854 (while (and (or (and (not (string= "" ispell-otherchars
))
1855 (looking-at ispell-otherchars
))
1856 (and extra-otherchars
(looking-at extra-otherchars
)))
1858 (or (not did-it-once
)
1859 ispell-many-otherchars-p
)
1860 (not (eq prevpt
(point))))
1861 (if (and extra-otherchars
(looking-at extra-otherchars
))
1864 (if (looking-at ispell-casechars
)
1865 (re-search-backward ispell-not-casechars
(point-min) 'move
)))
1869 (if (looking-at ispell-casechars
)
1870 (re-search-backward ispell-not-casechars
(point-min) 'move
)
1871 (backward-char -
1))))
1872 ;; Now mark the word and save to string.
1873 (if (not (re-search-forward word-regexp
(point-max) t
))
1874 (if ispell-check-only
1875 ;; return dummy word when just flagging misspellings
1876 (list "" (point) (point))
1877 (error "No word found to check!"))
1878 (setq start
(copy-marker (match-beginning 0))
1880 word
(buffer-substring-no-properties start end
))
1881 (list word start end
))))
1884 ;; Global ispell-pdict-modified-p is set by ispell-command-loop and
1885 ;; tracks changes in the dictionary. The global may either be
1886 ;; a value or a list, whose value is the state of whether the
1887 ;; dictionary needs to be saved.
1890 (defun ispell-pdict-save (&optional no-query force-save
)
1891 "Check to see if the personal dictionary has been modified.
1892 If so, ask if it needs to be saved."
1893 (interactive (list ispell-silently-savep t
))
1894 (if (and ispell-pdict-modified-p
(listp ispell-pdict-modified-p
))
1895 (setq ispell-pdict-modified-p
(car ispell-pdict-modified-p
)))
1896 (if (or ispell-pdict-modified-p force-save
)
1897 (if (or no-query
(y-or-n-p "Personal dictionary modified. Save? "))
1899 (ispell-send-string "#\n") ; save dictionary
1900 (message "Personal dictionary saved."))))
1901 ;; unassert variable, even if not saved to avoid questioning.
1902 (setq ispell-pdict-modified-p nil
))
1905 (defun ispell-command-loop (miss guess word start end
)
1906 "Display possible corrections from list MISS.
1907 GUESS lists possibly valid affix construction of WORD.
1908 Returns nil to keep word.
1909 Returns 0 to insert locally into buffer-local dictionary.
1910 Returns string for new chosen word.
1911 Returns list for new replacement word (will be rechecked).
1912 Query-replace when list length is 2.
1913 Automatic query-replace when second element is `query-replace'.
1914 Highlights the word, which is assumed to run from START to END.
1915 Global `ispell-pdict-modified-p' becomes a list where the only value
1916 indicates whether the dictionary has been modified when option `a'
1918 Global `ispell-quit' set to start location to continue spell session."
1920 (line ispell-choices-win-default-height
)
1921 ;; ensure 4 context lines.
1922 (max-lines (- (ispell-adjusted-window-height) 4))
1924 (window-min-height (min window-min-height
1925 ispell-choices-win-default-height
))
1926 (command-characters '( ? ?i ?a ?A ?r ?R ?? ?x ?X ?q ?l ?u ?m
))
1927 (dedicated (window-dedicated-p (selected-window)))
1929 char num result textwin dedicated-win
)
1931 ;; setup the *Choices* buffer with valid data.
1932 (with-current-buffer (get-buffer-create ispell-choices-buffer
)
1933 (setq mode-line-format
1935 "-- %b -- word: " word
1936 " -- dict: " (or ispell-current-dictionary
"default")
1937 " -- prog: " (file-name-nondirectory ispell-program-name
)))
1938 ;; XEmacs: no need for horizontal scrollbar in choices window
1939 (ispell-with-no-warnings
1940 (and (fboundp 'set-specifier
)
1941 (boundp 'horizontal-scrollbar-visible-p
)
1942 (set-specifier horizontal-scrollbar-visible-p nil
1943 (cons (current-buffer) nil
))))
1947 (insert "Affix rules generate and capitalize "
1948 "this word as shown below:\n\t")
1950 (if (> (+ 4 (current-column) (length (car guess
)))
1954 (setq line
(1+ line
))))
1955 (insert (car guess
) " ")
1956 (setq guess
(cdr guess
)))
1957 (insert "\nUse option `i' to accept this spelling and put it in your private dictionary.\n")
1958 (setq line
(+ line
(if choices
3 2)))))
1960 (< (if (> (+ 7 (current-column) (length (car choices
))
1961 (if (> count ?~
) 3 0))
1965 (setq line
(1+ line
)))
1968 ;; not so good if there are over 20 or 30 options, but then, if
1969 ;; there are that many you don't want to scan them all anyway...
1970 (while (memq count command-characters
) ; skip command characters.
1971 (setq count
(ispell-int-char (1+ count
))
1972 skipped
(1+ skipped
)))
1973 (insert "(" count
") " (car choices
) " ")
1974 (setq choices
(cdr choices
)
1975 count
(ispell-int-char (1+ count
))))
1976 (setq count
(ispell-int-char (- count ?
0 skipped
))))
1978 ;; ensure word is visible
1979 (if (not (pos-visible-in-window-p end
))
1982 ;; allow temporary split of dedicated windows...
1985 (setq dedicated-win
(selected-window))
1986 (set-window-dedicated-p dedicated-win nil
)))
1988 ;; Display choices for misspelled word.
1989 (ispell-show-choices line end
)
1990 (select-window (setq textwin
(next-window)))
1992 ;; highlight word, protecting current buffer status
1995 (and ispell-highlight-p
1996 (ispell-highlight-spelling-error start end t
))
1997 ;; Loop until a valid choice is made.
2005 (let (message-log-max)
2006 (message (concat "C-h or ? for more options; SPC to leave "
2007 "unchanged, Character to replace word")))
2008 (let ((inhibit-quit t
)
2010 (setq char nil skipped
0)
2011 ;; If the user types C-g, or generates some other
2012 ;; non-character event (such as a frame switch
2013 ;; event), stop ispell. As a special exception,
2014 ;; ignore mouse events occurring in the same frame.
2015 (while (and input-valid
(not (characterp char
)))
2016 (setq char
(read-key))
2018 (or (characterp char
)
2019 (and (mouse-event-p char
)
2020 (eq (selected-frame)
2022 (posn-window (event-start char
))))))))
2023 (when (or quit-flag
(not input-valid
) (= char ?\C-g
))
2024 (setq char ?X quit-flag nil
)))
2025 ;; Adjust num to array offset skipping command characters.
2026 (let ((com-chars command-characters
))
2028 (if (and (> (car com-chars
) ?
0) (< (car com-chars
) char
))
2029 (setq skipped
(1+ skipped
)))
2030 (setq com-chars
(cdr com-chars
)))
2031 (setq num
(- char ?
0 skipped
)))
2034 ((= char ?
) nil
) ; accept word this time only
2035 ((= char ?i
) ; accept and insert word into pers dict
2036 (ispell-send-string (concat "*" word
"\n"))
2037 (setq ispell-pdict-modified-p
'(t)) ; dictionary modified!
2039 ((or (= char ?a
) (= char ?A
)) ; accept word without insert
2040 (ispell-send-string (concat "@" word
"\n"))
2041 (add-to-list 'ispell-buffer-session-localwords word
)
2042 (or ispell-buffer-local-name
; session localwords might conflict
2043 (setq ispell-buffer-local-name
(buffer-name)))
2044 (if (null ispell-pdict-modified-p
)
2045 (setq ispell-pdict-modified-p
2046 (list ispell-pdict-modified-p
)))
2047 (if (= char ?A
) 0)) ; return 0 for ispell-add buffer-local
2048 ((or (= char ?r
) (= char ?R
)) ; type in replacement
2049 (and (eq 'block ispell-highlight-p
) ; refresh tty's
2050 (ispell-highlight-spelling-error start end nil t
))
2052 (if (or (= char ?R
) ispell-query-replace-choices
)
2054 (format "Query-replacement for %s: "word
)
2057 (cons (read-string "Replacement for: " word
)
2059 (and (eq 'block ispell-highlight-p
)
2060 (ispell-highlight-spelling-error start end nil
2063 ((or (= char ??
) (= char help-char
) (= char ?\C-h
))
2064 (and (eq 'block ispell-highlight-p
)
2065 (ispell-highlight-spelling-error start end nil t
))
2067 (and (eq 'block ispell-highlight-p
)
2068 (ispell-highlight-spelling-error start end nil
2071 ;; Quit and move point back.
2073 (ispell-pdict-save ispell-silently-savep
)
2074 (message "Exited spell-checking")
2075 (setq ispell-quit t
)
2077 ;; Quit and preserve point.
2079 (ispell-pdict-save ispell-silently-savep
)
2081 (substitute-command-keys
2082 (concat "Spell-checking suspended;"
2083 " use C-u \\[ispell-word] to resume")))
2084 (setq ispell-quit start
)
2087 (if (y-or-n-p "Really kill Ispell process? ")
2089 (ispell-kill-ispell t
) ; terminate process.
2090 (setq ispell-quit
(or (not ispell-checking-message
)
2092 ispell-pdict-modified-p nil
))
2093 t
)) ; continue if they don't quit.
2095 (and (eq 'block ispell-highlight-p
) ; refresh tty displays
2096 (ispell-highlight-spelling-error start end nil t
))
2097 (let ((new-word (read-string
2098 "Lookup string (`*' is wildcard): "
2102 (with-current-buffer (get-buffer-create
2103 ispell-choices-buffer
)
2107 mode-line-format
;; setup the *Choices* buffer with valid data.
2108 (concat "-- %b -- word: " new-word
2110 (or ispell-complete-word-dict
2111 ispell-alternate-dictionary
))
2112 miss
(lookup-words new-word
)
2114 line ispell-choices-win-default-height
)
2115 (while (and choices
; adjust choices window.
2116 (< (if (> (+ 7 (current-column)
2117 (length (car choices
))
2118 (if (> count ?~
) 3 0))
2122 (setq line
(1+ line
)))
2125 (while (memq count command-characters
)
2126 (setq count
(ispell-int-char (1+ count
))
2127 skipped
(1+ skipped
)))
2128 (insert "(" count
") " (car choices
) " ")
2129 (setq choices
(cdr choices
)
2130 count
(ispell-int-char (1+ count
))))
2131 (setq count
(ispell-int-char
2132 (- count ?
0 skipped
))))
2133 (ispell-show-choices line end
)
2134 (select-window (next-window)))))
2135 (and (eq 'block ispell-highlight-p
)
2136 (ispell-highlight-spelling-error start end nil
2138 t
) ; reselect from new choices
2139 ((= char ?u
) ; insert lowercase into dictionary
2140 (ispell-send-string (concat "*" (downcase word
) "\n"))
2141 (setq ispell-pdict-modified-p
'(t)) ; dictionary modified!
2143 ((= char ?m
) ; type in what to insert
2145 (concat "*" (read-string "Insert: " word
) "\n"))
2146 (setq ispell-pdict-modified-p
'(t))
2148 ((and (>= num
0) (< num count
))
2149 (if ispell-query-replace-choices
; Query replace flag
2150 (list (nth num miss
) 'query-replace
)
2155 ;; This may have alignment errors if current line is edited
2156 (if (marker-position ispell-recursive-edit-marker
)
2158 (message "Only one recursive edit session supported")
2161 (set-marker ispell-recursive-edit-marker start
)
2162 ;;(set-marker ispell-region-end reg-end)
2163 (and ispell-highlight-p
; unhighlight
2164 (ispell-highlight-spelling-error start end
))
2169 (substitute-command-keys
2170 (concat "Exit recursive edit with"
2171 " \\[exit-recursive-edit]")))
2172 (save-window-excursion (save-excursion
2175 (goto-char ispell-recursive-edit-marker
)
2176 (if (not (equal (marker-buffer
2177 ispell-recursive-edit-marker
)
2180 (set-marker ispell-recursive-edit-marker nil
)
2182 "Cannot continue ispell from this buffer.")))
2183 (set-marker ispell-recursive-edit-marker nil
)))
2184 (list word nil
)) ; recheck starting at this word.
2186 (funcall (key-binding "\C-z"))
2191 (and ispell-highlight-p
; unhighlight
2192 (save-window-excursion
2193 (select-window textwin
)
2194 (ispell-highlight-spelling-error start end
)))
2196 (set-window-dedicated-p dedicated-win t
)))))
2200 (defun ispell-show-choices (line end
)
2201 "Show the choices in another buffer or frame."
2202 (if (and ispell-use-framepop-p
(fboundp 'framepop-display-buffer
))
2204 (framepop-display-buffer (get-buffer ispell-choices-buffer
))
2205 ;; (get-buffer-window ispell-choices-buffer t)
2206 (select-window (previous-window))) ; *Choices* window
2207 ;; standard selection by splitting a small buffer out of this window.
2208 (let ((choices-window (get-buffer-window ispell-choices-buffer
)))
2210 (if (= line
(ispell-adjusted-window-height choices-window
))
2211 (select-window choices-window
)
2212 ;; *Choices* window changed size. Adjust the choices window
2213 ;; without scrolling the spelled window when possible
2215 (- line
(ispell-adjusted-window-height choices-window
)))
2216 (visible (progn (vertical-motion -
1) (point))))
2217 (if (< line ispell-choices-win-default-height
)
2218 (setq window-line
(+ window-line
2219 (- ispell-choices-win-default-height
2221 (move-to-window-line 0)
2222 (vertical-motion window-line
)
2223 (set-window-start (selected-window)
2224 (if (> (point) visible
) visible
(point)))
2226 (select-window choices-window
)
2227 (enlarge-window window-line
)))
2228 ;; Overlay *Choices* window when it isn't showing
2229 (ispell-overlay-window (max line ispell-choices-win-default-height
)))
2230 (switch-to-buffer ispell-choices-buffer
)
2231 (goto-char (point-min)))))
2235 (defun ispell-help ()
2236 "Display a list of the options available when a misspelling is encountered.
2240 DIGIT: Replace the word with a digit offered in the *Choices* buffer.
2241 SPC: Accept word this time.
2242 `i': Accept word and insert into private dictionary.
2243 `a': Accept word for this session.
2244 `A': Accept word and place in `buffer-local dictionary'.
2245 `r': Replace word with typed-in value. Rechecked.
2246 `R': Replace word with typed-in value. Query-replaced in buffer. Rechecked.
2247 `?': Show these commands.
2248 `x': Exit spelling buffer. Move cursor to original point.
2249 `X': Exit spelling buffer. Leaves cursor at the current point, and permits
2250 the aborted check to be completed later.
2251 `q': Quit spelling session (Kills ispell process).
2252 `l': Look up typed-in replacement in alternate dictionary. Wildcards okay.
2253 `u': Like `i', but the word is lower-cased first.
2254 `m': Place typed-in value in personal dictionary, then recheck current word.
2255 `C-l': Redraw screen.
2256 `C-r': Recursive edit.
2257 `C-z': Suspend Emacs or iconify frame."
2259 (if (equal ispell-help-in-bufferp
'electric
)
2263 (function (lambda ()
2264 ;;This shouldn't be necessary: with-electric-help needs
2265 ;; an optional argument telling it about the smallest
2266 ;; acceptable window-height of the help buffer.
2267 ;;(if (< (window-height) 15)
2269 ;; (- 15 (ispell-adjusted-window-height))))
2270 (princ "Selections are:
2272 DIGIT: Replace the word with a digit offered in the *Choices* buffer.
2273 SPC: Accept word this time.
2274 `i': Accept word and insert into private dictionary.
2275 `a': Accept word for this session.
2276 `A': Accept word and place in `buffer-local dictionary'.
2277 `r': Replace word with typed-in value. Rechecked.
2278 `R': Replace word with typed-in value. Query-replaced in buffer. Rechecked.
2279 `?': Show these commands.
2280 `x': Exit spelling buffer. Move cursor to original point.
2281 `X': Exit spelling buffer. Leaves cursor at the current point, and permits
2282 the aborted check to be completed later.
2283 `q': Quit spelling session (Kills ispell process).
2284 `l': Look up typed-in replacement in alternate dictionary. Wildcards okay.
2285 `u': Like `i', but the word is lower-cased first.
2286 `m': Place typed-in value in personal dictionary, then recheck current word.
2287 `C-l': Redraw screen.
2288 `C-r': Recursive edit.
2289 `C-z': Suspend Emacs or iconify frame.")
2293 (let ((help-1 (concat "[r/R]eplace word; [a/A]ccept for this session; "
2294 "[i]nsert into private dictionary"))
2295 (help-2 (concat "[l]ook a word up in alternate dictionary; "
2296 "e[x/X]it; [q]uit session"))
2297 (help-3 (concat "[u]ncapitalized insert into dict. "
2298 "Type 'x C-h f ispell-help' for more help")))
2299 (save-window-excursion
2300 (if ispell-help-in-bufferp
2302 (ispell-overlay-window 4)
2303 (switch-to-buffer (get-buffer-create "*Ispell Help*"))
2304 (insert (concat help-1
"\n" help-2
"\n" help-3
))
2306 (kill-buffer "*Ispell Help*"))
2308 (let ((resize-mini-windows 'grow-only
))
2309 (select-window (minibuffer-window))
2312 ;;(set-minibuffer-window (selected-window))
2314 (insert (concat help-1
"\n" help-2
"\n" help-3
))
2316 (erase-buffer)))))))
2319 (defun lookup-words (word &optional lookup-dict
)
2320 "Look up WORD in optional word-list dictionary LOOKUP-DICT.
2321 A `*' serves as a wild card. If no wild cards, `look' is used if it exists.
2322 Otherwise the variable `ispell-grep-command' contains the command used to
2323 search for the words (usually egrep).
2325 Optional second argument contains the dictionary to use; the default is
2326 `ispell-alternate-dictionary', overridden by `ispell-complete-word-dict'
2328 ;; We don't use the filter for this function, rather the result is written
2329 ;; into a buffer. Hence there is no need to save the filter values.
2330 (if (null lookup-dict
)
2331 (setq lookup-dict
(or ispell-complete-word-dict
2332 ispell-alternate-dictionary
)))
2335 (unless (file-readable-p lookup-dict
)
2336 (error "lookup-words error: Unreadable or missing plain word-list %s."
2338 (error (concat "lookup-words error: No plain word-list found at system"
2339 "default locations. "
2340 "Customize `ispell-alternate-dictionary' to set yours.")))
2342 (let* ((process-connection-type ispell-use-ptys-p
)
2343 (wild-p (string-match "\\*" word
))
2344 (look-p (and ispell-look-p
; Only use look for an exact match.
2345 (or ispell-have-new-look
(not wild-p
))))
2346 (prog (if look-p ispell-look-command ispell-grep-command
))
2347 (args (if look-p ispell-look-options ispell-grep-options
))
2350 (message "Starting \"%s\" process..." (file-name-nondirectory prog
))
2354 (insert "^" word
"$")
2355 (while (search-backward "*" nil t
) (insert "."))
2356 (setq word
(buffer-string))
2358 (setq status
(apply 'ispell-call-process prog nil t nil
2359 (nconc (if (and args
(> (length args
) 0))
2364 (if lookup-dict
(list lookup-dict
)))))
2365 ;; `grep' returns status 1 and no output when word not found, which
2366 ;; is a perfectly normal thing.
2367 (if (stringp status
)
2368 (error "error: %s exited with signal %s"
2369 (file-name-nondirectory prog
) status
)
2370 ;; Else collect words into `results' in FIFO order.
2371 (goto-char (point-max))
2372 ;; Assure we've ended with \n.
2373 (or (bobp) (= (preceding-char) ?
\n) (insert ?
\n))
2377 (push (buffer-substring-no-properties (point)
2380 (if (and results
(string-match ".+: " (car results
)))
2381 (error "%s error: %s" ispell-grep-command
(car results
)))
2385 ;; "ispell-filter" is a list of output lines from the generating function.
2386 ;; Each full line (ending with \n) is a separate item on the list.
2387 ;; "output" can contain multiple lines, part of a line, or both.
2388 ;; "start" and "end" are used to keep bounds on lines when "output" contains
2390 ;; "ispell-filter-continue" is true when we have received only part of a
2391 ;; line as output from a generating function ("output" did not end with \n)
2392 ;; THIS FUNCTION WILL FAIL IF THE PROCESS OUTPUT DOESN'T END WITH \n!
2393 ;; This is the case when a process dies or fails. The default behavior
2394 ;; in this case treats the next input received as fresh input.
2396 (defun ispell-filter (process output
)
2397 "Output filter function for ispell, grep, and look."
2402 (setq end
(string-match "\n" output start
)) ; get text up to the newline.
2403 ;; If we get out of sync and ispell-filter-continue is asserted when we
2404 ;; are not continuing, treat the next item as a separate list. When
2405 ;; ispell-filter-continue is asserted, ispell-filter *should* always be a
2408 ;; Continue with same line (item)?
2409 (if (and ispell-filter-continue ispell-filter
(listp ispell-filter
))
2410 ;; Yes. Add it to the prev item
2411 (setcar ispell-filter
2412 (concat (car ispell-filter
) (substring output start end
)))
2413 ;; No. This is a new line and item.
2415 (cons (substring output start end
) ispell-filter
)))
2417 ;; We've completed reading the output, but didn't finish the line.
2418 (setq ispell-filter-continue t continue nil
)
2419 ;; skip over newline, this line complete.
2420 (setq ispell-filter-continue nil end
(1+ end
))
2421 (if (= end
(length output
)) ; No more lines in output
2422 (setq continue nil
) ; so we can exit the filter.
2423 (setq start end
)))))) ; else move start to next line of input
2426 ;; This function destroys the mark location if it is in the word being
2428 (defun ispell-highlight-spelling-error-generic (start end
&optional highlight
2430 "Highlight the word from START to END with a kludge using `inverse-video'.
2431 When the optional third arg HIGHLIGHT is set, the word is highlighted;
2432 otherwise it is displayed normally.
2433 Uses block cursor to highlight one character.
2434 Optional REFRESH will unhighlighted then highlight, using block cursor
2435 highlighting when REFRESH is equal to `block'."
2436 (and (eq 'block ispell-highlight-p
)
2437 (or (eq 'block refresh
)
2438 (setq start
(1+ start
)))) ; On block non-refresh, inc start.
2439 (let ((modified (buffer-modified-p)) ; don't allow this fn to modify buffer
2440 (buffer-read-only nil
) ; Allow highlighting read-only buffers.
2441 (text (buffer-substring-no-properties start end
))
2442 ; Save highlight region.
2443 (inhibit-quit t
) ; inhibit interrupt processing here.
2444 (buffer-undo-list t
)) ; don't clutter the undo list.
2446 (delete-region start end
)
2447 (insert-char ?
(- end start
)) ; minimize amount of redisplay
2448 (sit-for 0) ; update display
2449 (if highlight
(setq inverse-video
(not inverse-video
))) ; toggle video
2450 (delete-region start end
) ; delete whitespace
2451 (insert text
) ; insert text in inverse video.
2452 (sit-for 0) ; update display showing inverse video.
2455 (setq inverse-video
(not inverse-video
)) ; toggle video
2456 (and (eq 'block ispell-highlight-p
)
2457 (goto-char (1- start
)))) ; use block cursor to "highlight" char
2458 (set-buffer-modified-p modified
) ; don't modify if flag not set.
2459 (and refresh
; re-highlight
2460 (ispell-highlight-spelling-error-generic
2461 (if (eq 'block refresh
) start
(- start
2)) end t
))))
2464 (defun ispell-highlight-spelling-error-xemacs (start end
&optional highlight
)
2465 "Highlight the word from START to END using `isearch-highlight'.
2466 When the optional third arg HIGHLIGHT is set, the word is highlighted,
2467 otherwise it is displayed normally."
2469 (isearch-highlight start end
)
2470 (isearch-dehighlight))
2475 (defun ispell-highlight-spelling-error-overlay (start end
&optional highlight
)
2476 "Highlight the word from START to END using overlays.
2477 When the optional third arg HIGHLIGHT is set, the word is highlighted
2478 otherwise it is displayed normally.
2480 The variable `ispell-highlight-face' selects the face to use for highlighting."
2483 (move-overlay ispell-overlay start end
(current-buffer))
2484 (setq ispell-overlay
(make-overlay start end
))
2485 (overlay-put ispell-overlay
'priority
1001) ;higher than lazy overlays
2486 (overlay-put ispell-overlay
'face ispell-highlight-face
))
2488 (delete-overlay ispell-overlay
)))
2489 (if (and ispell-lazy-highlight
(boundp 'lazy-highlight-cleanup
))
2491 (let ((isearch-string
2494 (regexp-quote (buffer-substring-no-properties start end
))
2497 (isearch-case-fold-search nil
))
2498 (isearch-lazy-highlight-new-loop
2499 (if (boundp 'reg-start
) reg-start
)
2500 (if (boundp 'reg-end
) reg-end
)))
2501 (lazy-highlight-cleanup lazy-highlight-cleanup
)
2502 (setq isearch-lazy-highlight-last-string nil
))))
2505 (defun ispell-highlight-spelling-error (start end
&optional highlight refresh
)
2508 (ispell-highlight-spelling-error-xemacs start end highlight
))
2509 ((and (featurep 'faces
)
2510 (or (and (fboundp 'display-color-p
) (display-color-p))
2512 (ispell-highlight-spelling-error-overlay start end highlight
))
2513 (t (ispell-highlight-spelling-error-generic start end highlight refresh
))))
2515 (defun ispell-adjusted-window-height (&optional window
)
2516 "Like `window-height', adjusted to correct for the effect of tall mode-lines.
2517 The value returned is actually the nominal number of text-lines in the
2518 window plus 1. On a terminal, this is the same value returned by
2519 `window-height', but if the window has a mode-line is taller than a normal
2520 text line, the returned value may be smaller than that from
2522 (cond ((fboundp 'window-text-height
)
2523 (1+ (window-text-height window
)))
2524 ((or (and (fboundp 'display-graphic-p
) (display-graphic-p))
2525 (and (featurep 'xemacs
) window-system
))
2526 (1- (window-height window
)))
2528 (window-height window
))))
2530 (defun ispell-overlay-window (height)
2531 "Create a window covering the top HEIGHT lines of the current window.
2532 Ensure that the line above point is still visible but otherwise avoid
2533 scrolling the current window. Leave the new window selected."
2535 (let ((oldot (save-excursion (vertical-motion -
1) (point)))
2536 (top (save-excursion (move-to-window-line height
) (point))))
2537 ;; If line above old point (line starting at oldot) would be
2538 ;; hidden by new window, scroll it to just below new win
2539 ;; otherwise set top line of other win so it doesn't scroll.
2540 (if (< oldot top
) (setq top oldot
))
2541 ;; if frame is unsplittable, temporarily disable that...
2542 (if (cdr (assq 'unsplittable
(frame-parameters (selected-frame))))
2543 (let ((frame (selected-frame)))
2544 (modify-frame-parameters frame
'((unsplittable . nil
)))
2545 (split-window nil height
)
2546 (modify-frame-parameters frame
'((unsplittable . t
))))
2547 (split-window nil height
))
2548 (let ((deficit (- height
(ispell-adjusted-window-height))))
2550 ;; Number of lines the window is still too short. We ensure that
2551 ;; there are at least (1- HEIGHT) lines visible in the window.
2552 (enlarge-window deficit
)
2554 (vertical-motion deficit
)
2555 (setq top
(min (point) oldot
))))
2556 (set-window-start (next-window) top
))))
2559 ;; Should we add a compound word match return value?
2560 (defun ispell-parse-output (output &optional accept-list shift
)
2561 "Parse the OUTPUT string from Ispell process and return:
2562 1: t for an exact match.
2563 2: A string containing the root word matched via suffix removal.
2564 3: A list of possible correct spellings of the format:
2565 (\"ORIGINAL-WORD\" OFFSET MISS-LIST GUESS-LIST)
2566 ORIGINAL-WORD is a string of the possibly misspelled word.
2567 OFFSET is an integer giving the line offset of the word.
2568 MISS-LIST and GUESS-LIST are possibly null lists of guesses and misses.
2569 4: nil when an error has occurred.
2571 Optional second arg ACCEPT-LIST is list of words already accepted.
2572 Optional third arg SHIFT is an offset to apply based on previous corrections."
2574 ((string= output
"") t
) ; for startup with pipes...
2575 ((string= output
"*") t
) ; exact match
2576 ((string= output
"-") t
) ; compound word match
2577 ((eq (aref output
0) ?
+) ; found because of root word
2578 (substring output
2)) ; return root word
2579 ((equal 0 (string-match "[\ra-zA-Z]" output
))
2580 (ding) ; error message from ispell!
2581 (message "Ispell error: %s" output
)
2584 (t ; need to process &, ?, and #'s
2585 (let ((type (aref output
0)) ; &, ?, or #
2586 (original-word (substring output
2 (string-match " " output
2)))
2587 (cur-count 0) ; contains number of misses + guesses
2588 count miss-list guess-list offset
)
2589 (setq output
(substring output
(match-end 0))) ; skip over misspelling
2591 (setq count
0) ; no misses for type #
2592 (setq count
(string-to-number output
) ; get number of misses.
2593 output
(substring output
(1+ (string-match " " output
1)))))
2594 (setq offset
(string-to-number output
))
2595 (setq output
(if (eq type ?
#) ; No miss or guess list.
2597 (substring output
(1+ (string-match " " output
1)))))
2599 (let ((end (string-match ", \\|\\($\\)" output
))) ; end of miss/guess.
2600 (setq cur-count
(1+ cur-count
))
2601 (if (> cur-count count
)
2602 (push (substring output
0 end
) guess-list
)
2603 (push (substring output
0 end
) miss-list
))
2604 (setq output
(if (match-end 1) ; True only when at end of line.
2605 nil
; No more misses or guesses.
2606 (substring output
(+ end
2))))))
2607 ;; return results. Accept word if it was already accepted.
2609 (if (member original-word accept-list
)
2612 (if (numberp shift
) (+ shift offset
) offset
)
2613 (nreverse miss-list
) (nreverse guess-list
)))))))
2616 (defun ispell-process-status ()
2617 "Return the status of the Ispell process.
2618 When asynchronous processes are not supported, `run' is always returned."
2619 (if ispell-async-processp
2620 (process-status ispell-process
)
2621 (and ispell-process
'run
)))
2624 (defun ispell-start-process ()
2625 "Start the Ispell process, with support for no asynchronous processes.
2626 Keeps argument list for future Ispell invocations for no async support."
2627 ;; Local dictionary becomes the global dictionary in use.
2628 (setq ispell-current-dictionary
2629 (or ispell-local-dictionary ispell-dictionary
))
2630 (setq ispell-current-personal-dictionary
2631 (or ispell-local-pdict ispell-personal-dictionary
))
2632 (let* ((default-directory
2633 (if (and (file-directory-p default-directory
)
2634 (file-readable-p default-directory
))
2636 ;; Defend against bad `default-directory'.
2637 (expand-file-name "~/")))
2638 (orig-args (ispell-get-ispell-args))
2641 (if (and ispell-current-dictionary
; Not for default dict (nil)
2642 (not (member "-d" orig-args
))) ; Only define if not overridden.
2643 (list "-d" ispell-current-dictionary
))
2645 (if ispell-current-personal-dictionary
; Use specified pers dict.
2647 (expand-file-name ispell-current-personal-dictionary
)))
2648 ;; If we are using recent aspell or hunspell, make sure we use the
2649 ;; right encoding for communication. ispell or older aspell/hunspell
2650 ;; does not support this.
2651 (if ispell-encoding8-command
2652 (if ispell-really-hunspell
2653 (list ispell-encoding8-command
2654 (upcase (symbol-name (ispell-get-coding-system))))
2656 (concat ispell-encoding8-command
2657 (symbol-name (ispell-get-coding-system))))))
2658 ispell-extra-args
)))
2660 ;; Initially we don't know any buffer's local words.
2661 (setq ispell-buffer-local-name nil
)
2663 (if ispell-async-processp
2664 (let ((process-connection-type ispell-use-ptys-p
))
2665 (apply 'start-process
2666 "ispell" nil ispell-program-name
2667 "-a" ; Accept single input lines.
2668 ;; Make root/affix combos not in dict.
2669 ;; hunspell -m option means different.
2670 (if ispell-really-hunspell
"" "-m")
2672 (setq ispell-cmd-args args
2673 ispell-output-buffer
(generate-new-buffer " *ispell-output*")
2674 ispell-session-buffer
(generate-new-buffer " *ispell-session*"))
2675 (ispell-send-string "\032\n") ; so Ispell prints version and exits
2679 (defun ispell-init-process ()
2680 "Check status of Ispell process and start if necessary."
2681 (let* (;; Basename of dictionary used by the spell-checker
2682 (dict-bname (or (car (cdr (member "-d" (ispell-get-ispell-args))))
2683 ispell-current-dictionary
))
2684 ;; Use "~/" as default-directory unless using Ispell with per-dir
2685 ;; personal dictionaries and not in a minibuffer under XEmacs
2687 (if (or ispell-really-aspell
2688 ispell-really-hunspell
2689 ;; Protect against bad default-directory
2690 (not (and (file-directory-p default-directory
)
2691 (file-readable-p default-directory
)))
2692 ;; Ispell and per-dir personal dicts available
2693 (not (or (file-readable-p (concat default-directory
2695 (file-readable-p (concat default-directory
2699 ;; Ispell, in a minibuffer, and XEmacs
2700 (and (window-minibuffer-p)
2701 (not (fboundp 'minibuffer-selected-window
))))
2702 (expand-file-name "~/")
2703 (expand-file-name default-directory
))))
2704 ;; Check if process needs restart
2705 (if (and ispell-process
2706 (eq (ispell-process-status) 'run
)
2707 ;; Unless we are using an explicit personal dictionary, ensure
2708 ;; we're in the same default directory! Restart check for
2709 ;; personal dictionary is done in
2710 ;; `ispell-internal-change-dictionary', called from
2711 ;; `ispell-buffer-local-dict'
2712 (or (or ispell-local-pdict ispell-personal-dictionary
)
2713 (equal ispell-process-directory default-directory
)))
2714 (setq ispell-filter nil ispell-filter-continue nil
)
2715 ;; may need to restart to select new personal dictionary.
2716 (ispell-kill-ispell t
)
2717 (message "Starting new Ispell process [%s::%s] ..."
2719 (or ispell-local-dictionary ispell-dictionary
"default"))
2721 (setq ispell-library-directory
(ispell-check-version)
2722 ispell-process
(ispell-start-process)
2724 ispell-filter-continue nil
2725 ispell-process-directory default-directory
)
2727 (unless (equal ispell-process-directory
(expand-file-name "~/"))
2728 ;; At this point, `ispell-process-directory' will be "~/" unless using
2729 ;; Ispell with directory-specific dicts and not in XEmacs minibuffer.
2730 ;; If not, kill ispell process when killing buffer. It may be in a
2731 ;; removable device that would otherwise become un-mountable.
2732 (with-current-buffer
2733 (if (and (window-minibuffer-p) ;; In minibuffer
2734 (fboundp 'minibuffer-selected-window
)) ;; Not XEmacs.
2735 ;; In this case kill ispell only when parent buffer is killed
2736 ;; to avoid over and over ispell kill.
2737 (window-buffer (minibuffer-selected-window))
2739 ;; 'local does not automatically make hook buffer-local in XEmacs.
2740 (if (featurep 'xemacs
)
2741 (make-local-hook 'kill-buffer-hook
))
2742 (add-hook 'kill-buffer-hook
2743 (lambda () (ispell-kill-ispell t
)) nil
'local
)))
2745 (if ispell-async-processp
2746 (set-process-filter ispell-process
'ispell-filter
))
2747 ;; Protect against XEmacs bogus binding of `enable-multibyte-characters'.
2748 (if (and (or (featurep 'xemacs
)
2749 (and (boundp 'enable-multibyte-characters
)
2750 enable-multibyte-characters
))
2751 (fboundp 'set-process-coding-system
))
2752 (set-process-coding-system ispell-process
(ispell-get-coding-system)
2753 (ispell-get-coding-system)))
2754 ;; Get version ID line
2755 (ispell-accept-output 3)
2756 ;; get more output if filter empty?
2757 (if (null ispell-filter
) (ispell-accept-output 3))
2758 (cond ((null ispell-filter
)
2759 (error "%s did not output version line" ispell-program-name
))
2761 (stringp (car ispell-filter
))
2762 (if (string-match "warning: " (car ispell-filter
))
2764 (ispell-accept-output 3) ; was warn msg.
2765 (stringp (car ispell-filter
)))
2766 (null (cdr ispell-filter
)))
2767 (string-match "^@(#) " (car ispell-filter
)))
2768 ;; got the version line as expected (we already know it's the right
2769 ;; version, so don't bother checking again.)
2772 ;; Otherwise, it must be an error message. Show the user.
2773 ;; But first wait to see if some more output is going to arrive.
2774 ;; Otherwise we get cool errors like "Can't open ".
2776 (ispell-accept-output 3)
2777 (error "%s" (mapconcat 'identity ispell-filter
"\n"))))
2778 (setq ispell-filter nil
) ; Discard version ID line
2779 (let ((extended-char-mode (ispell-get-extended-character-mode)))
2780 (if extended-char-mode
; ~ extended character mode
2781 (ispell-send-string (concat extended-char-mode
"\n"))))
2782 (if ispell-async-processp
2783 (if (featurep 'emacs
)
2784 (set-process-query-on-exit-flag ispell-process nil
)
2785 (if (fboundp 'set-process-query-on-exit-flag
)
2786 (set-process-query-on-exit-flag ispell-process nil
)
2787 (process-kill-without-query ispell-process
)))))))
2790 (defun ispell-kill-ispell (&optional no-error clear
)
2791 "Kill current Ispell process (so that you may start a fresh one).
2792 With NO-ERROR, just return non-nil if there was no Ispell running.
2793 With CLEAR, buffer session localwords are cleaned."
2795 ;; This hook is typically used by flyspell to flush some variables used
2796 ;; to optimize the common cases.
2797 (run-hooks 'ispell-kill-ispell-hook
)
2799 (if (featurep 'xemacs
)
2801 (called-interactively-p 'interactive
)))
2802 (setq ispell-buffer-session-localwords nil
))
2803 (if (not (and ispell-process
2804 (eq (ispell-process-status) 'run
)))
2806 (error "There is no Ispell process running!"))
2807 (if ispell-async-processp
2808 (delete-process ispell-process
)
2809 ;; Synchronous processes.
2810 (ispell-send-string "\n") ; Make sure side effects occurred.
2811 (kill-buffer ispell-output-buffer
)
2812 (kill-buffer ispell-session-buffer
)
2813 (setq ispell-output-buffer nil
2814 ispell-session-buffer nil
))
2815 (setq ispell-process nil
)
2816 (message "Ispell process killed")
2819 ;; ispell-change-dictionary is set in some people's hooks. Maybe this should
2820 ;; call ispell-init-process rather than wait for a spell checking command?
2823 (defun ispell-change-dictionary (dict &optional arg
)
2824 "Change to dictionary DICT for Ispell.
2825 With a prefix arg, set it \"globally\", for all buffers.
2826 Without a prefix arg, set it \"locally\", just for this buffer.
2828 By just answering RET you can find out what the current dictionary is."
2830 (list (completing-read
2831 "Use new dictionary (RET for current, SPC to complete): "
2832 (and (fboundp 'ispell-valid-dictionary-list
)
2833 (mapcar 'list
(ispell-valid-dictionary-list)))
2835 current-prefix-arg
))
2836 (ispell-set-spellchecker-params) ; Initialize variables and dicts alists
2837 (unless arg
(ispell-buffer-local-dict 'no-reload
))
2838 (if (equal dict
"default") (setq dict nil
))
2839 ;; This relies on completing-read's bug of returning "" for no match
2840 (cond ((equal dict
"")
2841 (ispell-internal-change-dictionary)
2842 (message "Using %s dictionary"
2843 (or (and (not arg
) ispell-local-dictionary
)
2844 ispell-dictionary
"default")))
2845 ((equal dict
(or (and (not arg
) ispell-local-dictionary
)
2846 ispell-dictionary
"default"))
2847 ;; Specified dictionary is the default already. Could reload
2848 ;; the dictionaries if needed.
2849 (ispell-internal-change-dictionary)
2850 (and (if (featurep 'xemacs
)
2852 (called-interactively-p 'interactive
))
2853 (message "No change, using %s dictionary" dict
)))
2854 (t ; reset dictionary!
2855 (if (or (assoc dict ispell-local-dictionary-alist
)
2856 (assoc dict ispell-dictionary-alist
))
2858 ;; set default dictionary
2859 (setq ispell-dictionary dict
)
2860 ;; set local dictionary
2861 (setq ispell-local-dictionary dict
)
2862 (setq ispell-local-dictionary-overridden t
))
2863 (error "Undefined dictionary: %s" dict
))
2864 (ispell-internal-change-dictionary)
2865 (setq ispell-buffer-session-localwords nil
)
2866 (message "%s Ispell dictionary set to %s"
2867 (if arg
"Global" "Local")
2870 (defun ispell-internal-change-dictionary ()
2871 "Update the dictionary and the personal dictionary used by Ispell.
2872 This may kill the Ispell process; if so, a new one will be started
2874 (let ((dict (or ispell-local-dictionary ispell-dictionary
))
2875 (pdict (or ispell-local-pdict ispell-personal-dictionary
)))
2876 (unless (and (equal ispell-current-dictionary dict
)
2877 (equal ispell-current-personal-dictionary pdict
))
2878 (ispell-kill-ispell t
)
2879 (setq ispell-current-dictionary dict
2880 ispell-current-personal-dictionary pdict
))))
2882 ;; Avoid error messages when compiling for these dynamic variables.
2883 (defvar ispell-start
)
2886 ;; Spelling of comments are checked when ispell-check-comments is non-nil.
2889 (defun ispell-region (reg-start reg-end
&optional recheckp shift
)
2890 "Interactively check a region for spelling errors.
2891 Return nil if spell session was terminated, otherwise returns shift offset
2892 amount for last line processed."
2893 (interactive "r") ; Don't flag errors on read-only bufs.
2894 (ispell-set-spellchecker-params) ; Initialize variables and dicts alists
2896 (ispell-accept-buffer-local-defs)) ; set up dictionary, local words, etc.
2897 (let ((skip-region-start (make-marker))
2898 (rstart (make-marker)))
2901 (message "Spell-checking %s using %s with %s dictionary..."
2902 (if (and (= reg-start
(point-min)) (= reg-end
(point-max)))
2903 (buffer-name) "region")
2904 (file-name-nondirectory ispell-program-name
)
2905 (or ispell-current-dictionary
"default"))
2906 ;; Returns cursor to original location.
2907 (save-window-excursion
2908 (goto-char reg-start
)
2909 (let ((transient-mark-mode)
2910 (case-fold-search case-fold-search
)
2913 (let (message-log-max)
2914 (message "searching for regions to skip"))
2915 (if (re-search-forward (ispell-begin-skip-region-regexp) reg-end t
)
2917 (setq key
(match-string-no-properties 0))
2918 (set-marker skip-region-start
(- (point) (length key
)))
2919 (goto-char reg-start
)))
2920 (let (message-log-max)
2922 "Continuing spelling check using %s with %s dictionary..."
2923 (file-name-nondirectory ispell-program-name
)
2924 (or ispell-current-dictionary
"default")))
2925 (set-marker rstart reg-start
)
2926 (set-marker ispell-region-end reg-end
)
2927 (while (and (not ispell-quit
)
2928 (< (point) ispell-region-end
))
2929 ;; spell-check region with skipping
2930 (if (and (marker-position skip-region-start
)
2931 (<= skip-region-start
(point)))
2933 ;; If region inside line comment, must keep comment start.
2934 (setq in-comment
(point)
2937 (or (null comment-end
) (string= "" comment-end
))
2940 (re-search-forward comment-start in-comment t
))
2942 ;; Can change skip-regexps (in ispell-message)
2943 (ispell-skip-region key
) ; moves pt past region.
2944 (set-marker rstart
(point))
2945 ;; check for saving large attachments...
2946 (setq query-fcc
(and query-fcc
2947 (ispell-ignore-fcc skip-region-start
2949 (if (and (< rstart ispell-region-end
)
2951 (ispell-begin-skip-region-regexp)
2952 ispell-region-end t
))
2954 (setq key
(match-string-no-properties 0))
2955 (set-marker skip-region-start
2956 (- (point) (length key
)))
2958 (set-marker skip-region-start nil
))))
2959 (setq reg-end
(max (point)
2960 (if (marker-position skip-region-start
)
2961 (min skip-region-start ispell-region-end
)
2962 (marker-position ispell-region-end
))))
2963 (let* ((ispell-start (point))
2964 (ispell-end (min (point-at-eol) reg-end
))
2965 (string (ispell-get-line
2966 ispell-start ispell-end in-comment
)))
2967 (if in-comment
; account for comment chars added
2968 (setq ispell-start
(- ispell-start
(length in-comment
))
2970 (setq ispell-end
(point)) ; "end" tracks region retrieved.
2971 (if string
; there is something to spell check!
2972 ;; (special start end)
2973 (setq shift
(ispell-process-line string
2974 (and recheckp shift
))))
2975 (goto-char ispell-end
)))))
2980 (if (and (not (and recheckp ispell-keep-choices-win
))
2981 (get-buffer ispell-choices-buffer
))
2982 (kill-buffer ispell-choices-buffer
))
2983 (set-marker skip-region-start nil
)
2984 (set-marker rstart nil
)
2987 ;; preserve or clear the region for ispell-continue.
2988 (if (not (numberp ispell-quit
))
2989 (set-marker ispell-region-end nil
)
2990 ;; Ispell-continue enabled - ispell-region-end is set.
2991 (goto-char ispell-quit
))
2992 ;; Check for aborting
2993 (if (and ispell-checking-message
(numberp ispell-quit
))
2995 (setq ispell-quit nil
)
2996 (error "Message send aborted")))
2997 (if (not recheckp
) (setq ispell-quit nil
)))
2998 (if (not recheckp
) (set-marker ispell-region-end nil
))
2999 ;; Only save if successful exit.
3000 (ispell-pdict-save ispell-silently-savep
)
3001 (message "Spell-checking %s using %s with %s dictionary...done"
3002 (if (and (= reg-start
(point-min)) (= reg-end
(point-max)))
3003 (buffer-name) "region")
3004 (file-name-nondirectory ispell-program-name
)
3005 (or ispell-current-dictionary
"default"))))))
3008 (defun ispell-begin-skip-region-regexp ()
3009 "Return a regexp of the search keys for region skipping.
3010 Includes `ispell-skip-region-alist' plus tex, tib, html, and comment keys.
3011 Must be called after `ispell-buffer-local-parsing' due to dependence on mode."
3017 (if (and ispell-checking-message
3018 (not (eq t ispell-checking-message
)))
3019 (mapconcat #'car ispell-checking-message
"\\|"))
3021 (if (eq ispell-parser
'tex
)
3022 (ispell-begin-tex-skip-regexp))
3024 (if ispell-skip-html
3025 (ispell-begin-skip-region ispell-html-skip-alists
))
3027 (if ispell-skip-tib ispell-tib-ref-beginning
)
3029 (if (and (eq 'exclusive ispell-check-comments
) comment-start
)
3030 ;; search from end of current comment to start of next comment.
3031 (if (string= "" comment-end
) "^" (regexp-quote comment-end
)))
3032 (if (and (null ispell-check-comments
) comment-start
)
3033 (regexp-quote comment-start
))
3034 (ispell-begin-skip-region ispell-skip-region-alist
)))
3038 (defun ispell-begin-skip-region (skip-alist)
3039 "Regular expression for start of regions to skip generated from SKIP-ALIST.
3040 Each selection should be a key of SKIP-ALIST;
3041 otherwise, the current line is skipped."
3042 (mapconcat (lambda (lst) (if (stringp (car lst
)) (car lst
) (eval (car lst
))))
3047 (defun ispell-begin-tex-skip-regexp ()
3048 "Regular expression of tex commands to skip.
3049 Generated from `ispell-tex-skip-alists'."
3052 (mapconcat (function (lambda (lst) (car lst
)))
3053 (car ispell-tex-skip-alists
)
3056 ;; keys wrapped in begin{}
3057 (mapconcat (function (lambda (lst)
3058 (concat "\\\\begin[ \t\n]*{[ \t\n]*"
3061 (car (cdr ispell-tex-skip-alists
))
3065 (defun ispell-skip-region-list ()
3066 "Return a list describing key and body regions to skip for this buffer.
3067 Includes regions defined by `ispell-skip-region-alist', tex mode,
3068 `ispell-html-skip-alists', and `ispell-checking-message'.
3069 Manual checking must include comments and tib references.
3070 The list is of the form described by variable `ispell-skip-region-alist'.
3071 Must be called after `ispell-buffer-local-parsing' due to dependence on mode."
3072 (let ((skip-alist ispell-skip-region-alist
))
3073 ;; only additional explicit region definition is tex.
3074 (if (eq ispell-parser
'tex
)
3075 (setq case-fold-search nil
3076 skip-alist
(append (car ispell-tex-skip-alists
)
3077 (car (cdr ispell-tex-skip-alists
))
3079 (if ispell-skip-html
3080 (setq skip-alist
(append ispell-html-skip-alists skip-alist
)))
3081 (if (and ispell-checking-message
3082 (not (eq t ispell-checking-message
)))
3083 (setq skip-alist
(append ispell-checking-message skip-alist
)))
3087 (defun ispell-tex-arg-end (&optional arg
)
3088 "Skip across ARG number of braces."
3091 (while (looking-at "[ \t\n]*\\[") (forward-sexp))
3092 (forward-sexp (or arg
1)))
3094 (message "Error skipping s-expressions at point %d." (point))
3099 (defun ispell-ignore-fcc (start end
)
3100 "Delete the Fcc: message header when large attachments are included.
3101 Return value `nil' if file with large attachments is saved.
3102 This can be used to avoid multiple questions for multiple large attachments.
3103 Returns point to starting location afterwards."
3105 (if (and ispell-checking-message ispell-message-fcc-skip
)
3106 (if (< ispell-message-fcc-skip
(- end start
))
3107 (let (case-fold-search head-end
)
3108 (goto-char (point-min))
3110 (or (re-search-forward
3111 (concat "^" (regexp-quote mail-header-separator
) "$")
3113 (re-search-forward "^$" nil t
)
3115 (goto-char (point-min))
3116 (if (re-search-forward "^Fcc:" head-end t
)
3118 "Save copy of this message with large attachments? ")
3126 (defun ispell-skip-region (key)
3127 "Skip across KEY and then to end of region.
3128 Key lookup determines region to skip.
3129 Point is placed at end of skipped region."
3130 ;; move over key to begin checking.
3131 (forward-char (length key
))
3132 (let ((start (point))
3133 ;; Regenerate each call... This function can change region definition.
3134 (alist (ispell-skip-region-list))
3135 alist-key null-skip
)
3137 ;; what about quoted comment, or comment inside strings?
3138 ((and (null ispell-check-comments
) comment-start
3139 (string= key comment-start
))
3140 (if (string= "" comment-end
)
3142 (search-forward comment-end ispell-region-end t
)))
3143 ((and (eq 'exclusive ispell-check-comments
) comment-start
3144 (string= key comment-end
))
3145 (search-forward comment-start ispell-region-end
:end
))
3146 ((and ispell-skip-tib
(string-match ispell-tib-ref-beginning key
))
3147 (re-search-forward ispell-tib-ref-end ispell-region-end t
))
3148 ;; markings from alist
3151 (setq alist-key
(eval (car (car alist
))))
3152 (if (string-match alist-key key
)
3154 (setq alist
(cdr (car alist
)))
3156 ((null alist
) (setq null-skip t
)) ; done! Just skip key.
3157 ((not (consp alist
))
3158 ;; Search past end of spell region to find this region end.
3159 (re-search-forward (eval alist
) (point-max) t
))
3160 ((and (= 1 (length alist
))
3161 (stringp (car alist
)))
3162 (re-search-forward (car alist
) (point-max) t
))
3164 (setq null-skip t
) ; error handling in functions!
3165 (if (consp (cdr alist
))
3166 (apply (car alist
) (cdr alist
))
3167 (funcall (car alist
)))))
3169 (setq alist
(cdr alist
))))))
3170 (if (and (= start
(point)) (null null-skip
))
3172 (message "Matching region end for `%s' point %d not found"
3178 (defun ispell-get-line (start end in-comment
)
3179 "Grab the next line of data.
3180 Returns a string with the line data."
3181 (let ((ispell-casechars (ispell-get-casechars))
3183 (cond ; LOOK AT THIS LINE AND SKIP OR PROCESS
3184 ((eolp) ; END OF LINE, just go to next line.
3186 ;;((looking-at "[-#@*+!%~^]") ; SKIP SPECIAL ISPELL CHARACTERS
3187 ;; (forward-char 1)) ; not needed as quoted below.
3188 ((or (re-search-forward ispell-casechars end t
) ; TEXT EXISTS
3189 (re-search-forward "[][()${}]" end t
)) ; or MATH COMMANDS
3190 (setq string
(concat "^" in-comment
3191 (buffer-substring-no-properties start end
)
3194 (t (goto-char end
))) ; EMPTY LINE, skip it.
3198 (defun ispell-looking-at (string)
3199 (let ((coding (ispell-get-coding-system))
3200 (len (length string
)))
3201 (and (<= (+ (point) len
) (point-max))
3202 (equal (encode-coding-string string coding
)
3203 (encode-coding-string (buffer-substring-no-properties
3204 (point) (+ (point) len
))
3207 (defun ispell-process-line (string shift
)
3208 "Send STRING, a line of text, to ispell and process the result.
3209 This will modify the buffer for spelling errors.
3210 Requires variables ISPELL-START and ISPELL-END to be defined in its
3212 Returns the sum SHIFT due to changes in word replacements."
3213 ;;(declare special ispell-start ispell-end)
3214 (let (poss accept-list
)
3215 (if (not (numberp shift
))
3217 ;; send string to spell process and get input.
3218 (ispell-send-string string
)
3220 (ispell-accept-output)
3221 ;; Last item of output contains a blank line.
3222 (not (string= "" (car ispell-filter
)))))
3223 ;; parse all inputs from the stream one word at a time.
3224 ;; Place in FIFO order and remove the blank item.
3225 (setq ispell-filter
(nreverse (cdr ispell-filter
)))
3226 (while (and (not ispell-quit
) ispell-filter
)
3227 ;; get next word, accounting for accepted words and start shifts
3228 (setq poss
(ispell-parse-output (car ispell-filter
)
3230 (if (and poss
(listp poss
)) ; spelling error occurred.
3231 ;; Whenever we have misspellings, we can change
3232 ;; the buffer. Keep boundaries as markers.
3233 ;; Markers can move with highlighting! This destroys
3234 ;; end of region markers line-end and ispell-region-end
3236 (copy-marker (+ ispell-start ispell-offset
(car (cdr poss
)))))
3237 (word-len (length (car poss
)))
3238 (line-end (copy-marker ispell-end
))
3239 (line-start (copy-marker ispell-start
))
3240 recheck-region replace
)
3241 (goto-char word-start
)
3242 ;; Adjust the horizontal scroll & point
3243 (ispell-horiz-scroll)
3244 (goto-char (+ word-len word-start
))
3245 (ispell-horiz-scroll)
3246 (goto-char word-start
)
3247 (ispell-horiz-scroll)
3249 ;; Alignment cannot be tracked and this error will occur when
3250 ;; `query-replace' makes multiple corrections on the starting line.
3251 (or (ispell-looking-at (car poss
))
3252 ;; This occurs due to filter pipe problems
3253 (error (concat "Ispell misalignment: word "
3254 "`%s' point %d; probably incompatible versions")
3255 (car poss
) (marker-position word-start
)))
3256 ;; ispell-cmd-loop can go recursive & change buffer
3257 (if ispell-keep-choices-win
3258 (setq replace
(ispell-command-loop
3259 (car (cdr (cdr poss
)))
3260 (car (cdr (cdr (cdr poss
))))
3261 (car poss
) (marker-position word-start
)
3262 (+ word-len
(marker-position word-start
))))
3263 (save-window-excursion
3264 (setq replace
(ispell-command-loop
3265 (car (cdr (cdr poss
)))
3266 (car (cdr (cdr (cdr poss
))))
3267 (car poss
) (marker-position word-start
)
3268 (+ word-len
(marker-position word-start
))))))
3270 (goto-char word-start
)
3271 ;; Recheck when query replace edit changes misspelled word.
3272 ;; Error in tex mode when a potential math mode change exists.
3273 (if (and replace
(listp replace
) (= 2 (length replace
)))
3274 (if (and (eq ispell-parser
'tex
)
3275 (string-match "[\\\\][]()[]\\|\\\\begin\\|\\$"
3276 (regexp-quote string
)))
3278 "Don't start query replace on a line with math characters"
3280 (set-marker line-end
(point))
3281 (setq ispell-filter nil
3284 ;; insert correction if needed
3287 (equal 0 replace
)) ; ACCEPT/INSERT
3288 (if (equal 0 replace
) ; BUFFER-LOCAL DICT ADD
3289 (ispell-add-per-file-word-list (car poss
)))
3290 ;; do not recheck accepted word on this line
3291 (setq accept-list
(cons (car poss
) accept-list
)))
3292 (t ; replacement word selected or entered
3293 (delete-region (point) (+ word-len
(point)))
3294 (if (not (listp replace
))
3296 (insert replace
) ; insert dictionary word
3297 (ispell-send-replacement (car poss
) replace
)
3298 (setq accept-list
(cons replace accept-list
)))
3299 (let ((replace-word (car replace
)))
3300 ;; Recheck hand entered replacement word
3301 (insert replace-word
)
3302 (ispell-send-replacement (car poss
) replace-word
)
3303 (if (car (cdr replace
))
3304 (save-window-excursion
3305 (delete-other-windows) ; to correctly show help.
3306 ;; Assume case-replace &
3307 ;; case-fold-search correct?
3308 (query-replace (car poss
) (car replace
) t
)))
3309 (goto-char word-start
)
3310 ;; do not recheck if already accepted
3311 (if (member replace-word accept-list
)
3312 (setq accept-list
(cons replace-word accept-list
)
3313 replace replace-word
)
3314 (let ((region-end (copy-marker ispell-region-end
)))
3315 (setq recheck-region ispell-filter
3316 ispell-filter nil
; save filter
3317 shift
0 ; already accounted
3318 shift
(ispell-region
3320 (+ word-start
(length replace-word
))
3322 (if (null shift
) ; quitting check.
3324 (set-marker ispell-region-end region-end
)
3325 (set-marker region-end nil
)
3326 (setq ispell-filter recheck-region
3328 replace replace-word
)))))
3330 (setq shift
(+ shift
(- (length replace
) word-len
)))
3332 ;; Move line-start across word...
3333 ;; new shift function does this now...
3334 ;;(set-marker line-start (+ line-start
3335 ;; (- (length replace)
3336 ;; (length (car poss)))))
3338 (if (not ispell-quit
)
3339 ;; FIXME: remove redundancy with identical code above.
3340 (let (message-log-max)
3342 "Continuing spelling check using %s with %s dictionary..."
3343 (file-name-nondirectory ispell-program-name
)
3344 (or ispell-current-dictionary
"default"))))
3346 (setq ispell-start
(marker-position line-start
)
3347 ispell-end
(marker-position line-end
))
3348 ;; Adjust markers when end of region lost from highlighting.
3349 (if (and (not recheck-region
)
3350 (< ispell-end
(+ word-start word-len
)))
3351 (setq ispell-end
(+ word-start word-len
)))
3352 (if (= word-start ispell-region-end
)
3353 (set-marker ispell-region-end
(+ word-start word-len
)))
3354 ;; going out of scope - unneeded
3355 (set-marker line-start nil
)
3356 (set-marker word-start nil
)
3357 (set-marker line-end nil
)))
3358 ;; finished with misspelling!
3359 (setq ispell-filter
(cdr ispell-filter
)))
3364 (defun ispell-comments-and-strings ()
3365 "Check comments and strings in the current buffer for spelling errors."
3367 (goto-char (point-min))
3371 (setq state
(parse-partial-sexp (point) (point-max)
3372 nil nil state
'syntax-table
))
3373 (if (or (nth 3 state
) (nth 4 state
))
3374 (let ((start (point)))
3375 (setq state
(parse-partial-sexp start
(point-max)
3376 nil nil state
'syntax-table
))
3377 (if (or (nth 3 state
) (nth 4 state
))
3378 (error "Unterminated string or comment"))
3380 (setq done
(not (ispell-region start
(point))))))))))
3384 (defun ispell-buffer ()
3385 "Check the current buffer for spelling errors interactively."
3387 (ispell-region (point-min) (point-max)))
3391 (defun ispell-continue ()
3392 "Continue a halted spelling session beginning with the current word."
3394 (if (not (marker-position ispell-region-end
))
3395 (message "No session to continue. Use 'X' command when checking!")
3396 (if (not (equal (marker-buffer ispell-region-end
) (current-buffer)))
3397 (message "Must continue ispell from buffer %s"
3398 (buffer-name (marker-buffer ispell-region-end
)))
3400 ;; find beginning of current word:
3401 (car (cdr (ispell-get-word t
)))
3402 (marker-position ispell-region-end
)))))
3405 ;;; Horizontal scrolling
3406 (defun ispell-horiz-scroll ()
3407 "Place point within the horizontal visibility of its window area."
3408 (if truncate-lines
; display truncating lines?
3409 ;; See if display needs to be scrolled.
3410 (let ((column (- (current-column) (max (window-hscroll) 1))))
3411 (if (and (< column
0) (> (window-hscroll) 0))
3412 (scroll-right (max (- column
) 10))
3413 (if (>= column
(- (window-width) 2))
3414 (scroll-left (max (- column
(window-width) -
3) 10)))))))
3417 ;;; Interactive word completion.
3418 ;; Forces "previous-word" processing. Do we want to make this selectable?
3421 (defun ispell-complete-word (&optional interior-frag
)
3422 "Try to complete the word before or under point (see `lookup-words').
3423 If optional INTERIOR-FRAG is non-nil then the word may be a character
3424 sequence inside of a word.
3426 Standard ispell choices are then available."
3427 ;; FIXME: completion-at-point-function.
3429 (let ((cursor-location (point))
3430 (case-fold-search-val case-fold-search
)
3431 (word (ispell-get-word nil
"\\*")) ; force "previous-word" processing.
3432 start end possibilities replacement
)
3433 (setq start
(car (cdr word
))
3434 end
(car (cdr (cdr word
)))
3437 (or (string= word
"") ; Will give you every word
3438 (lookup-words (concat (and interior-frag
"*") word
3439 (if (or interior-frag
(null ispell-look-p
))
3441 (or ispell-complete-word-dict
3442 ispell-alternate-dictionary
))))
3443 (cond ((eq possibilities t
)
3444 (message "No word to complete"))
3445 ((null possibilities
)
3446 (message "No match for \"%s\"" word
))
3447 (t ; There is a modification...
3448 (setq case-fold-search nil
) ; Try and respect case of word.
3450 ((string-equal (upcase word
) word
)
3451 (setq possibilities
(mapcar 'upcase possibilities
)))
3452 ((eq (upcase (aref word
0)) (aref word
0))
3453 (setq possibilities
(mapcar (function
3455 (if (eq (aref word
0) (aref pos
0))
3459 (setq case-fold-search case-fold-search-val
)
3460 (save-window-excursion
3462 (ispell-command-loop possibilities nil word start end
)))
3464 ((equal 0 replacement
) ; BUFFER-LOCAL ADDITION
3465 (ispell-add-per-file-word-list word
))
3466 (replacement ; REPLACEMENT WORD
3467 (delete-region start end
)
3468 (setq word
(if (atom replacement
) replacement
(car replacement
))
3469 cursor-location
(+ (- (length word
) (- end start
))
3472 (if (not (atom replacement
)) ; recheck spelling of replacement.
3474 (goto-char cursor-location
)
3475 (ispell-word nil t
)))))
3476 (if (get-buffer ispell-choices-buffer
)
3477 (kill-buffer ispell-choices-buffer
))))
3478 (ispell-pdict-save ispell-silently-savep
)
3479 (goto-char cursor-location
)))
3483 (defun ispell-complete-word-interior-frag ()
3484 "Completes word matching character sequence inside a word."
3486 (ispell-complete-word t
))
3491 "Interactively check a region or buffer for spelling errors.
3492 If `transient-mark-mode' is on, and a region is active, spell-check
3493 that region. Otherwise spell-check the buffer.
3495 Ispell dictionaries are not distributed with Emacs. If you are
3496 looking for a dictionary, please see the distribution of the GNU ispell
3497 program, or do an Internet search; there are various dictionaries
3498 available on the net."
3500 (if (and (boundp 'transient-mark-mode
) transient-mark-mode
3501 (boundp 'mark-active
) mark-active
)
3502 (ispell-region (region-beginning) (region-end))
3506 ;;; **********************************************************************
3507 ;;; Ispell Minor Mode
3508 ;;; **********************************************************************
3510 (defvar ispell-minor-keymap
3511 (let ((map (make-sparse-keymap)))
3512 (define-key map
" " 'ispell-minor-check
)
3513 (define-key map
"\r" 'ispell-minor-check
)
3515 "Keymap used for Ispell minor mode.")
3518 (define-minor-mode ispell-minor-mode
3519 "Toggle last-word spell checking (Ispell minor mode).
3520 With a prefix argument ARG, enable Ispell minor mode if ARG is
3521 positive, and disable it otherwise. If called from Lisp, enable
3522 the mode if ARG is omitted or nil.
3524 Ispell minor mode is a buffer-local minor mode. When enabled,
3525 typing SPC or RET warns you if the previous word is incorrectly
3528 All the buffer-local variables and dictionaries are ignored. To
3529 read them into the running ispell process, type \\[ispell-word]
3532 For spell-checking \"on the fly\", not just after typing SPC or
3533 RET, use `flyspell-mode'."
3534 nil
" Spell" ispell-minor-keymap
)
3536 (defun ispell-minor-check ()
3537 "Check previous word, then continue with the normal binding of this key.
3538 Don't check previous word when character before point is a space or newline.
3539 Don't read buffer-local settings or word lists."
3541 (let ((ispell-minor-mode nil
)
3542 (ispell-check-only t
)
3543 (last-char (char-after (1- (point)))))
3544 (command-execute (key-binding (this-command-keys)))
3545 (if (not (or (eq last-char ?\
) (eq last-char ?
\n)
3546 (and ispell-skip-html
(eq last-char ?
>))
3547 (and ispell-skip-html
(eq last-char ?\
;))))
3548 (ispell-word nil t
))))
3551 ;;; **********************************************************************
3553 ;;; **********************************************************************
3555 (defvar ispell-message-text-end
3556 (mapconcat (function identity
)
3558 ;; Don't spell check signatures
3560 ;; Matches PostScript files.
3561 ;;"^%!PS-Adobe-[123].0"
3562 ;; Matches uuencoded text
3563 ;;"^begin [0-9][0-9][0-9] .*\nM.*\nM.*\nM"
3564 ;; Matches shell files (especially auto-decoding)
3566 ;; Matches context difference listing
3567 "\\(\\(^cd .*\n\\)?diff -c .*\\)?\n\\*\\*\\* .*\n--- .*\n\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*"
3568 ;; Matches unidiff difference listing
3569 "\\(diff -u .*\\)?\n--- .*\n\\+\\+\\+ .*\n@@ [-+][0-9]+,[0-9]+ [-+][0-9]+,[0-9]+ @@"
3570 ;; Matches reporter.el bug report
3571 "^current state:\n==============\n"
3572 ;; Matches commonly used "cut" boundaries
3573 "^\\(- \\)?[-=_]+\\s ?\\(cut here\\|Environment Follows\\)")
3575 "Text beyond which `ispell-message' will not spell-check.
3576 If it is a string, limit is the first occurrence of that regular expression.
3577 Otherwise, it must be a function which is called to get the limit.")
3578 (put 'ispell-message-text-end
'risky-local-variable t
)
3581 (defun ispell-mime-multipartp (&optional limit
)
3582 "Return multipart message start boundary or nil if none."
3583 ;; caller must ensure `case-fold-search' is set to `t'
3586 "Content-Type: *multipart/\\([^ \t\n]*;[ \t]*[\n]?[ \t]*\\)+boundary="
3589 (if (looking-at "\"")
3592 (setq start
(point))
3593 (while (not (looking-at "\""))
3595 (setq boundary
(buffer-substring-no-properties start
(point))))
3596 (let ((start (point)))
3597 (while (looking-at "[-0-9a-zA-Z'()+_,./:=?]")
3599 (setq boundary
(buffer-substring-no-properties start
(point)))))
3600 (if (< (length boundary
) 1)
3602 (concat "--" boundary
)))))
3605 (defun ispell-mime-skip-part (boundary)
3606 "Move point across header, or entire MIME part if message is encoded.
3607 All specified types except `7bit' `8bit' and `quoted-printable' are considered
3608 encoded and therefore skipped. See rfc 1521, 2183, ...
3609 If no boundary is given, then entire message is skipped.
3611 This starts one line ABOVE the MIME content messages, on the boundary marker,
3612 for operation with the generic region-skipping code.
3613 This places new MIME boundaries into variable `ispell-checking-message'."
3614 (forward-line) ; skip over boundary to headers
3615 (let ((save-case-fold-search case-fold-search
)
3618 (setq case-fold-search t
3619 ispell-skip-html nil
)
3621 (setq continuep nil
)
3622 (if (looking-at "Content-Type: *text/")
3624 (goto-char (match-end 0))
3625 (if (looking-at "html")
3626 (setq ispell-skip-html t
))
3629 (re-search-forward "\\(.*;[ \t]*[\n]\\)*.*$" nil t
)
3631 (if (looking-at "Content-Transfer-Encoding: *\\([^ \t\n]*\\)")
3632 (let ((match (buffer-substring (match-beginning 1) (match-end 1))))
3633 (setq textp
(member (upcase match
)
3634 ;; only spell check the following encodings:
3635 '("7BIT" "8BIT" "QUOTED-PRINTABLE" "BINARY"))
3637 (goto-char (match-end 0))
3638 (re-search-forward "\\(.*;[ \t]*[\n]\\)*.*$" nil t
)
3640 ;; hierarchical boundary definition
3641 (if (looking-at "Content-Type: *multipart/")
3642 (let ((new-boundary (ispell-mime-multipartp)))
3643 (if (string-match new-boundary boundary
)
3645 ;; first pass redefine skip function to include new boundary
3646 ;;(re-search-backward boundary nil t)
3648 (setq ispell-checking-message
3650 (list new-boundary
'ispell-mime-skip-part new-boundary
)
3651 (if (eq t ispell-checking-message
) nil
3652 ispell-checking-message
))
3655 ;; Skip all MIME headers that don't affect spelling
3656 (if (looking-at "Content-[^ \t]*: *\\(.*;[ \t]*[\n]\\)*.*$")
3659 (goto-char (match-end 0))
3662 (setq case-fold-search save-case-fold-search
)
3665 ;; encoded message. Skip to boundary, or entire message.
3667 (goto-char (point-max))
3668 (re-search-forward boundary nil t
)
3674 (defun ispell-message ()
3675 "Check the spelling of a mail message or news post.
3676 Don't check spelling of message headers except the Subject field.
3677 Don't check included messages.
3679 To abort spell checking of a message region and send the message anyway,
3680 use the `x' command. (Any subsequent regions will be checked.)
3681 The `X' command aborts sending the message so that you can edit the buffer.
3683 To spell-check whenever a message is sent, include the appropriate lines
3684 in your .emacs file:
3685 (add-hook 'message-send-hook 'ispell-message) ;; GNUS 5
3686 (add-hook 'news-inews-hook 'ispell-message) ;; GNUS 4
3687 (add-hook 'mail-send-hook 'ispell-message)
3688 (add-hook 'mh-before-send-letter-hook 'ispell-message)
3690 You can bind this to the key C-c i in GNUS or mail by adding to
3691 `news-reply-mode-hook' or `mail-mode-hook' the following lambda expression:
3692 (function (lambda () (local-set-key \"\\C-ci\" 'ispell-message)))"
3695 (goto-char (point-min))
3696 (let* (boundary mimep
3697 (ispell-skip-region-alist-save ispell-skip-region-alist
)
3698 ;; Nil when message came from outside (eg calling Emacs as editor)
3699 ;; Non-nil marker of end of headers.
3702 (concat "^" (regexp-quote mail-header-separator
) "$") nil t
))
3703 (end-of-headers ; Start of body.
3705 (or internal-messagep
3706 (re-search-forward "^$" nil t
)
3708 (limit (copy-marker ; End of region we will spell check.
3710 ((not ispell-message-text-end
) (point-max))
3711 ((char-or-string-p ispell-message-text-end
)
3712 (if (re-search-forward ispell-message-text-end nil t
)
3715 (t (min (point-max) (funcall ispell-message-text-end
))))))
3716 (default-prefix ; Vanilla cite prefix (just used for cite-regexp)
3717 (if (and (boundp 'mail-yank-prefix
) mail-yank-prefix
)
3718 (ispell-non-empty-string mail-yank-prefix
)
3720 (cite-regexp ;Prefix of quoted text
3722 ((functionp 'sc-cite-regexp
) ; sc 3.0
3723 (ispell-with-no-warnings
3724 (concat "\\(" (sc-cite-regexp) "\\)" "\\|"
3725 (ispell-non-empty-string sc-reference-tag-string
))))
3726 ((boundp 'sc-cite-regexp
) ; sc 2.3
3727 (concat "\\(" sc-cite-regexp
"\\)" "\\|"
3728 (ispell-with-no-warnings
3729 (ispell-non-empty-string sc-reference-tag-string
))))
3730 ((or (equal major-mode
'news-reply-mode
) ;GNUS 4 & below
3731 (equal major-mode
'message-mode
)) ;GNUS 5
3732 (concat "In article <" "\\|"
3733 "[^,;&+=\n]+ <[^,;&+=]+> writes:" "\\|"
3734 (ispell-with-no-warnings message-cite-prefix-regexp
)
3737 ((equal major-mode
'mh-letter-mode
) ; mh mail message
3738 (concat "[^,;&+=\n]+ writes:" "\\|"
3739 (ispell-with-no-warnings
3740 (ispell-non-empty-string mh-ins-buf-prefix
))))
3741 ((not internal-messagep
) ; Assume nn sent us this message.
3742 (concat "In [a-zA-Z.]+ you write:" "\\|"
3743 "In <[^,;&+=]+> [^,;&+=]+ writes:" "\\|"
3745 ((boundp 'vm-included-text-prefix
) ; VM mail message
3746 (concat "[^,;&+=\n]+ writes:" "\\|"
3747 (ispell-non-empty-string vm-included-text-prefix
)))
3748 (t default-prefix
)))
3749 (ispell-skip-region-alist
3750 (cons (list (concat "^\\(" cite-regexp
"\\)")
3751 (function forward-line
))
3752 ispell-skip-region-alist
))
3753 (old-case-fold-search case-fold-search
)
3754 (dictionary-alist ispell-message-dictionary-alist
)
3755 (ispell-checking-message t
))
3757 ;; Select dictionary for message
3758 (or (local-variable-p 'ispell-local-dictionary
(current-buffer))
3759 (while dictionary-alist
3760 (goto-char (point-min))
3761 (if (re-search-forward (car (car dictionary-alist
))
3763 (setq ispell-local-dictionary
(cdr (car dictionary-alist
))
3764 dictionary-alist nil
)
3765 (setq dictionary-alist
(cdr dictionary-alist
)))))
3769 ;; Spell check any original Subject:
3770 (goto-char (point-min))
3771 (setq case-fold-search t
3772 mimep
(re-search-forward "MIME-Version:" end-of-headers t
))
3773 (goto-char (point-min))
3774 (if (re-search-forward "^Subject: *" end-of-headers t
)
3776 (goto-char (match-end 0))
3777 (if (and (not (looking-at ".*Re\\>"))
3778 (not (looking-at "\\[")))
3780 (setq case-fold-search old-case-fold-search
)
3781 (ispell-region (point)
3782 (progn ;Tab-initiated continuation lns.
3784 (while (looking-at "\n[ \t]")
3789 (goto-char (point-min))
3790 (setq boundary
(ispell-mime-multipartp end-of-headers
))))
3791 ;; Adjust message limit to MIME message if necessary.
3793 (re-search-forward (concat boundary
"--") nil t
)
3794 (re-search-backward boundary nil t
)
3795 (< (point) (marker-position limit
))
3796 (set-marker limit
(point)))
3797 (goto-char (point-min))
3798 ;; Select type or skip checking if this is a non-multipart message
3799 ;; Point moved to end of buffer if region is encoded.
3800 (when (and mimep
(not boundary
))
3801 (goto-char (point-min))
3802 (re-search-forward "Content-[^ \t]*:" end-of-headers t
)
3803 (forward-line -
1) ; following fn starts one line above
3804 (ispell-mime-skip-part nil
)
3805 ;; if message-text-end region, limit may be less than point.
3806 (if (> (point) limit
)
3807 (set-marker limit
(point))))
3808 (goto-char (max end-of-headers
(point)))
3810 (setq case-fold-search old-case-fold-search
)
3811 ;; Define MIME regions to skip.
3813 (setq ispell-checking-message
3814 (list (list boundary
'ispell-mime-skip-part boundary
))))
3815 (ispell-region (point) limit
))
3816 (set-marker end-of-headers nil
)
3817 (set-marker limit nil
)
3818 (setq ispell-skip-region-alist ispell-skip-region-alist-save
3819 ispell-skip-html nil
3820 case-fold-search old-case-fold-search
)))))
3823 (defun ispell-non-empty-string (string)
3824 (if (or (not string
) (string-equal string
""))
3825 "\\'\\`" ; An unmatchable string if string is null.
3826 (regexp-quote string
)))
3829 ;;; **********************************************************************
3830 ;;; Buffer Local Functions
3831 ;;; **********************************************************************
3834 (defun ispell-accept-buffer-local-defs ()
3835 "Load all buffer-local information, restarting Ispell when necessary."
3836 (ispell-buffer-local-dict) ; May kill ispell-process.
3837 (ispell-buffer-local-words) ; Will initialize ispell-process.
3838 (ispell-buffer-local-parsing))
3841 (defun ispell-buffer-local-parsing ()
3842 "Place Ispell into parsing mode for this buffer.
3843 Overrides the default parsing mode.
3844 Includes LaTeX/Nroff modes and extended character mode."
3845 ;; (ispell-init-process) must already be called.
3846 (ispell-send-string "!\n") ; Put process in terse mode.
3847 ;; We assume all major modes with "tex-mode" in them should use latex parsing
3848 ;; When exclusively checking comments, set to raw text mode (nroff).
3849 (if (and (not (eq 'exclusive ispell-check-comments
))
3850 (or (and (eq ispell-parser
'use-mode-name
)
3851 (string-match "[Tt][Ee][Xx]-mode"
3852 (symbol-name major-mode
)))
3853 (eq ispell-parser
'tex
)))
3855 (ispell-send-string "+\n") ; set ispell mode to tex
3856 (if (not (eq ispell-parser
'tex
))
3857 (set (make-local-variable 'ispell-parser
) 'tex
)))
3858 (ispell-send-string "-\n")) ; set mode to normal (nroff)
3859 ;; If needed, test for SGML & HTML modes and set a buffer local nil/t value.
3860 (if (and ispell-skip-html
(not (eq ispell-skip-html t
)))
3861 (setq ispell-skip-html
3862 (not (null (string-match "sgml\\|html\\|xml"
3863 (downcase (symbol-name major-mode
)))))))
3864 ;; Set default extended character mode for given buffer, if any.
3865 (let ((extended-char-mode (ispell-get-extended-character-mode)))
3866 (if extended-char-mode
3867 (ispell-send-string (concat extended-char-mode
"\n"))))
3868 ;; Set buffer-local parsing mode and extended character mode, if specified.
3870 (goto-char (point-max))
3871 ;; Uses last occurrence of ispell-parsing-keyword
3872 (if (search-backward ispell-parsing-keyword nil t
)
3873 (let ((end (point-at-eol))
3875 (search-forward ispell-parsing-keyword
)
3876 (while (re-search-forward " *\\([^ \"]+\\)" end t
)
3877 ;; space separated definitions.
3878 (setq string
(downcase (match-string-no-properties 1)))
3879 (cond ((and (string-match "latex-mode" string
)
3880 (not (eq 'exclusive ispell-check-comments
)))
3881 (ispell-send-string "+\n~tex\n"))
3882 ((string-match "nroff-mode" string
)
3883 (ispell-send-string "-\n~nroff\n"))
3884 ((string-match "~" string
) ; Set extended character mode.
3885 (ispell-send-string (concat string
"\n")))
3886 (t (message "Invalid Ispell Parsing argument!")
3890 ;; Can kill the current ispell process
3892 (defun ispell-buffer-local-dict (&optional no-reload
)
3893 "Initializes local dictionary and local personal dictionary.
3894 If optional NO-RELOAD is non-nil, do not reload any dictionary.
3895 When a dictionary is defined in the buffer (see variable
3896 `ispell-dictionary-keyword'), it will override the local setting
3897 from \\[ispell-change-dictionary].
3898 Both should not be used to define a buffer-local dictionary."
3900 (goto-char (point-min))
3902 ;; Override the local variable definition.
3903 ;; Uses last occurrence of ispell-dictionary-keyword.
3904 (goto-char (point-max))
3905 (unless ispell-local-dictionary-overridden
3906 (if (search-backward ispell-dictionary-keyword nil t
)
3908 (search-forward ispell-dictionary-keyword
)
3909 (setq end
(point-at-eol))
3910 (if (re-search-forward " *\\([^ \"]+\\)" end t
)
3911 (setq ispell-local-dictionary
3912 (match-string-no-properties 1))))))
3913 (goto-char (point-max))
3914 (if (search-backward ispell-pdict-keyword nil t
)
3916 (search-forward ispell-pdict-keyword
)
3917 (setq end
(point-at-eol))
3918 (if (re-search-forward " *\\([^ \"]+\\)" end t
)
3919 (setq ispell-local-pdict
3920 (match-string-no-properties 1)))))))
3922 ;; Reload if new dictionary (maybe the personal one) defined.
3923 (ispell-internal-change-dictionary)))
3926 (defun ispell-buffer-local-words ()
3927 "Load the buffer-local dictionary in the current buffer."
3928 ;; If there's an existing ispell process that's wrong for this use,
3930 (if (and ispell-buffer-local-name
3931 (not (equal ispell-buffer-local-name
(buffer-name))))
3932 (ispell-kill-ispell t
))
3933 ;; Actually start a new ispell process, because we need
3934 ;; to send commands now to specify the local words to it.
3935 (ispell-init-process)
3936 (dolist (session-localword ispell-buffer-session-localwords
)
3937 (ispell-send-string (concat "@" session-localword
"\n")))
3938 (or ispell-buffer-local-name
3939 (if ispell-buffer-session-localwords
3940 (setq ispell-buffer-local-name
(buffer-name))))
3942 (goto-char (point-min))
3943 (while (search-forward ispell-words-keyword nil t
)
3944 (or ispell-buffer-local-name
3945 (setq ispell-buffer-local-name
(buffer-name)))
3946 (let ((end (point-at-eol))
3947 (ispell-casechars (ispell-get-casechars))
3949 ;; buffer-local words separated by a space, and can contain
3950 ;; any character other than a space. Not rigorous enough.
3951 (while (re-search-forward " *\\([^ ]+\\)" end t
)
3952 (setq string
(match-string-no-properties 1))
3953 ;; This can fail when string contains a word with invalid chars.
3954 ;; Error handling needs to be added between ispell and Emacs.
3955 (if (and (< 1 (length string
))
3956 (equal 0 (string-match ispell-casechars string
)))
3957 (ispell-send-string (concat "@" string
"\n"))))))))
3960 ;; Returns optionally adjusted region-end-point.
3962 ;; If comment-padright is defined, newcomment must be loaded.
3963 (declare-function comment-add
"newcomment" (arg))
3965 (defun ispell-add-per-file-word-list (word)
3966 "Add WORD to the per-file word list."
3967 (or ispell-buffer-local-name
3968 (setq ispell-buffer-local-name
(buffer-name)))
3970 (goto-char (point-min))
3971 (let (line-okay search done found
)
3973 (let ((case-fold-search nil
))
3974 (setq search
(search-forward ispell-words-keyword nil
'move
)
3975 found
(or found search
)
3976 line-okay
(< (+ (length word
) 1 ; 1 for space after word..
3977 (progn (end-of-line) (current-column)))
3979 (if (or (and search line-okay
)
3986 (unless found
(newline))
3987 (insert (if comment-start
3989 (if (fboundp 'comment-padright
)
3990 ;; Try and use the proper comment marker,
3991 ;; e.g. ";;" rather than ";".
3992 (comment-padright comment-start
3997 ispell-words-keyword
)
3998 (if (and comment-end
(> (length comment-end
) 0))
4001 (insert comment-end
)))))
4002 (insert (concat " " word
))))))))
4004 (add-to-list 'debug-ignored-errors
"^No word found to check!$")
4009 ;;; LOCAL VARIABLES AND BUFFER-LOCAL VALUE EXAMPLES.
4011 ;; Local Variable options:
4012 ;; mode: name(-mode)
4014 ;; local-variable: value
4016 ;; The following sets the buffer local dictionary to `american' English
4017 ;; and spell checks only comments.
4021 ;; comment-column: 40
4022 ;; ispell-check-comments: exclusive
4023 ;; ispell-local-dictionary: "american"
4027 ;;; MORE EXAMPLES OF ISPELL BUFFER-LOCAL VALUES
4029 ;; The following places this file in nroff parsing and extended char modes.
4030 ;; Local IspellParsing: nroff-mode ~nroff
4031 ;; Change IspellPersDict to IspellPersDict: to enable the following line.
4032 ;; Local IspellPersDict ~/.ispell_lisp
4033 ;; The following were automatically generated by ispell using the 'A' command:
4034 ; LocalWords: settable alist inews mh frag pdict Wildcards iconify arg tex kss
4035 ; LocalWords: alists minibuffer bufferp autoload loaddefs aff Dansk KOI SPC op
4036 ; LocalWords: Francais Nederlands charset autoloaded popup nonmenu regexp num
4037 ; LocalWords: AMStex hspace includeonly nocite epsfig displaymath eqnarray reg
4038 ; LocalWords: minipage pers dict unhighlight buf grep sync prev inc
4039 ; LocalWords: fn oldot NB AIX msg init read's bufs pt cmd Quinlan eg
4040 ; LocalWords: uuencoded unidiff sc nn VM SGML eval IspellPersDict
4041 ; LocalWords: lns XEmacs HTML casechars Multibyte
4043 ;;; ispell.el ends here