1 ;;; ispell.el --- interface to International Ispell Versions 3.1 and 3.2
3 ;; Copyright (C) 1994, 1995, 1997, 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
5 ;; Author: Ken Stevens <k.stevens@ieee.org>
6 ;; Maintainer: Ken Stevens <k.stevens@ieee.org>
7 ;; Stevens Mod Date: Fri Aug 4 09:41:50 PDT 2000
8 ;; Stevens Revision: 3.4
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 2, or (at your option)
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; see the file COPYING. If not, write to the
28 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
29 ;; Boston, MA 02111-1307, USA.
31 ;; Note: version numbers and time stamp are not updated
32 ;; when this file is edited for release with GNU emacs.
38 ;; This code contains a section of user-settable variables that you
39 ;; should inspect prior to installation. Look past the end of the history
40 ;; list. Set them up for your locale and the preferences of the majority
41 ;; of the users. Otherwise the users may need to set a number of variables
43 ;; You particularly may want to change the default dictionary for your
44 ;; country and language.
45 ;; Most dictionary changes should be made in this file so all users can
46 ;; enjoy them. Local or modified dictionaries are supported in your .emacs
47 ;; file. Modify the variable `ispell-local-dictionary-alist' to include
48 ;; these dictionaries, and they will be installed when ispell.el is loaded.
50 ;; Depending on the mail system you use, you may want to include these:
51 ;; (add-hook 'news-inews-hook 'ispell-message)
52 ;; (add-hook 'mail-send-hook 'ispell-message)
53 ;; (add-hook 'mh-before-send-letter-hook 'ispell-message)
55 ;; Ispell has a TeX parser and a nroff parser (the default).
56 ;; The parsing is controlled by the variable ispell-parser. Currently
57 ;; it is just a "toggle" between TeX and nroff, but if more parsers are
58 ;; added it will be updated. See the variable description for more info.
67 ;; ispell-comments-and-strings
69 ;; ispell-complete-word
70 ;; ispell-complete-word-interior-frag
71 ;; ispell-change-dictionary
74 ;; ispell-skip-region-alist
76 ;; Commands in ispell-region:
77 ;; Character replacement: Replace word with choice. May query-replace.
78 ;; ` ': Accept word this time.
79 ;; `i': Accept word and insert into private dictionary.
80 ;; `a': Accept word for this session.
81 ;; `A': Accept word and place in buffer-local dictionary.
82 ;; `r': Replace word with typed-in value. Rechecked.
83 ;; `R': Replace word with typed-in value. Query-replaced in buffer. Rechecked.
84 ;; `?': Show these commands
85 ;; `x': Exit spelling buffer. Move cursor to original point.
86 ;; `X': Exit spelling buffer. Leaves cursor at the current point, and permits
87 ;; the check to be completed later.
88 ;; `q': Quit spelling session (Kills ispell process).
89 ;; `l': Look up typed-in replacement in alternate dictionary. Wildcards okay.
90 ;; `u': Like `i', but the word is lower-cased first.
91 ;; `m': Place entered value in personal dictionary, then recheck current word.
92 ;; `C-l': redraws screen
93 ;; `C-r': recursive edit
94 ;; `C-z': suspend emacs or iconify frame
96 ;; Buffer-Local features:
97 ;; There are a number of buffer-local features that can be used to customize
98 ;; ispell for the current buffer. This includes language dictionaries,
99 ;; personal dictionaries, parsing, and local word spellings. Each of these
100 ;; local customizations are done either through local variables, or by
101 ;; including the keyword and argument(s) at the end of the buffer (usually
102 ;; prefixed by the comment characters). See the end of this file for
103 ;; examples. The local keywords and variables are:
105 ;; ispell-dictionary-keyword language-dictionary
106 ;; uses local variable ispell-local-dictionary
107 ;; ispell-pdict-keyword personal-dictionary
108 ;; uses local variable ispell-local-pdict
109 ;; ispell-parsing-keyword mode-arg extended-char-arg
110 ;; ispell-words-keyword any number of local word spellings
113 ;; Place new regular expression definitions of regions you prefer not to
114 ;; spell check in `ispell-skip-region-alist'. Mode-dependent features can
115 ;; be added to latex by modifying `ispell-tex-skip-alists'.
116 ;; `ispell-message' contains some custom skipping code for e-mail messages.
119 ;; Need a way to select between different character mappings without separate
120 ;; dictionary entries.
121 ;; Multi-byte characters if not defined by current dictionary may result in the
122 ;; evil "misalignment error" in some versions of MULE emacs.
123 ;; On some versions of emacs, growing the minibuffer fails.
124 ;; see `ispell-help-in-bufferp'.
125 ;; Recursive edits (?C-r or ?R) inside a keyboard text replacement check (?r)
126 ;; can cause misalignment errors.
130 ;; Modifications made in latest versions:
132 ;; Revision 3.4 2000/8/4 09:41:50 kss
133 ;; Support new color display functions.
134 ;; Fixed misalignment offset bug when replacing a string after a shift made.
135 ;; Set to standard Author/Maintainer heading,
136 ;; ensure localwords lists are separated from the text by newline. (Dave Love)
137 ;; Added dictionary definition for Italian (William Deakin)
138 ;; HTML region skipping greatly improved. (Chuck D. Phillips)
139 ;; improved menus. Fixed regexp matching http/email addresses.
140 ;; one arg always for xemacs sleep-for (gunnar Evermann)
141 ;; support for synchronous processes (Eli Zaretskii)
143 ;; Revision 3.3 1999/11/29 11:38:34 kss
144 ;; Only word replacements entered in from the keyboard are rechecked.
145 ;; This fixes a bug in tex parsing and misalignment.
146 ;; Exceptions exist for recursive edit and query-replace, with tex error
147 ;; condition tested. Recursive editing improved.
148 ;; XEmacs repair for when `enable-multibyte-characters' defined - Didier Verna.
149 ;; ispell-help fixed for XEmacs. Choices minibuffer now displayed in XEmacs.
150 ;; Only list valid dictionaries in Spell menu. Russian dictionary doesn't allow
151 ;; run-together words, and uses koi8-r font. Don't skip text in html <TT>
154 ;; Revision 3.2 1999/5/7 14:25:14 kss
155 ;; Accept ispell versions 3.X.Y where X>=1
156 ;; fine tuned latex region skipping. Fixed bug in ispell-word that did not
157 ;; point in right place on words < 2 chars. Simplified ispell-minor-mode.
158 ;; Fixed bug in TeX parsing when math commands are in the comments.
159 ;; Removed calls to `when' macro.
161 ;; Revision 3.1 1998/12/1 13:21:52 kss
162 ;; Improved and fixed customize support.
163 ;; Improved and fixed comments in variables and messages.
164 ;; A coding system is now required for all languages.
165 ;; casechars improved for castellano, castellano8, and norsk dictionaries.
166 ;; Dictionary norsk7-tex removed. Dictionary polish added.
167 ;; Dictionaries redefined at load-time to support dictionary changes.
168 ;; Menu redefined at load time to support dictionary changes.
169 ;; ispell-check-version added as an alias for `check-ispell-version'.
170 ;; Spelling suggestions returned in order generated by ispell.
171 ;; Small bug fixed in matching ispell error messages.
172 ;; Robustness added to ensure `case-fold-search' doesn't get redefined.
173 ;; Fixed bug that didn't respect case of word in `ispell-complete-word'.
174 ;; Multibyte character coding support added for process interactions.
175 ;; Ensure ispell process has terminated before starting new process.
176 ;; This can otherwise confuse process filters and hang ispell.
177 ;; Improved skipping support for SGML.
178 ;; Fixed bug using ^M rather than \r in `ispell-minor-check'.
179 ;; Improved message reference matching in `ispell-message'.
180 ;; Fixed bug in returning to nroff mode from tex mode.
185 ;;; Custom.el macros require recompiling this when they are not present.
186 ;;; Add in backward compatible custom support.
188 (if (not (fboundp 'defcustom
))
189 (defmacro defcustom
(symbol value doc
&rest args
)
190 "Empty replacement for defcustom when not supplied."
191 `(defvar ,symbol
,value
,doc
))))
194 (if (fboundp 'defgroup
)
196 "User variables for emacs ispell interface."
197 :group
'applications
)))
199 (if (not (fboundp 'buffer-substring-no-properties
))
200 (defun buffer-substring-no-properties (start end
)
201 (buffer-substring start end
)))
204 (defconst xemacsp
(string-match "Lucid\\|XEmacs" emacs-version
)
205 "Non nil if using XEmacs.")
208 (defconst version18p
(string-match "18\\.[0-9]+\\.[0-9]+" emacs-version
)
209 "Non nil if using emacs version 18.")
212 (defconst version20p
(string-match "20\\.[0-9]+\\.[0-9]+" emacs-version
)
213 "Non nil if using emacs version 20.")
215 (defconst ispell-graphic-p
216 (if (fboundp 'display-graphic-p
)
219 "True if running on a `graphics capable' display.")
221 (and (not version18p
)
222 (not (boundp 'epoch
::version
))
223 (defalias 'ispell-check-version
'check-ispell-version
))
225 ;;; **********************************************************************
226 ;;; The following variables should be set according to personal preference
227 ;;; and location of binaries:
228 ;;; **********************************************************************
231 ;;; ******* THIS FILE IS WRITTEN FOR ISPELL VERSION 3.1+
233 (defcustom ispell-highlight-p
'block
234 "*Highlight spelling errors when non-nil.
235 When set to `block', assumes a block cursor with TTY displays."
236 :type
'(choice (const block
) (const :tag
"off" nil
) (const :tag
"on" t
))
239 (defcustom ispell-highlight-face
'highlight
240 "*The face used for Ispell highlighting. For Emacses with overlays.
241 Possible values are `highlight', `modeline', `secondary-selection',
242 `region', and `underline'.
243 This variable can be set by the user to whatever face they desire.
244 It's most convenient if the cursor color and highlight color are
249 (defcustom ispell-check-comments t
250 "*Spelling of comments checked when non-nil.
251 When set to `exclusive', ONLY comments are checked. (For code comments).
252 Warning! Not checking comments, when a comment start is embedded in strings,
253 may produce undesired results."
254 :type
'(choice (const exclusive
) (const :tag
"off" nil
) (const :tag
"on" t
))
257 (defcustom ispell-query-replace-choices nil
258 "*Corrections made throughout region when non-nil.
259 Uses `query-replace' (\\[query-replace]) for corrections."
263 (defcustom ispell-skip-tib nil
264 "*Does not spell check `tib' bibliography references when non-nil.
265 Skips any text between strings matching regular expressions
266 `ispell-tib-ref-beginning' and `ispell-tib-ref-end'.
268 TeX users beware: Any field starting with [. will skip until a .] -- even
269 your whole buffer -- unless you set `ispell-skip-tib' to nil. That includes
270 a [.5mm] type of number...."
274 (defvar ispell-tib-ref-beginning
"[[<]\\."
275 "Regexp matching the beginning of a Tib reference.")
277 (defvar ispell-tib-ref-end
"\\.[]>]"
278 "Regexp matching the end of a Tib reference.")
280 (defcustom ispell-keep-choices-win t
281 "*When not nil, the `*Choices*' window remains for spelling session.
282 This minimizes redisplay thrashing."
286 (defcustom ispell-choices-win-default-height
2
287 "*The default size of the `*Choices*' window, including mode line.
288 Must be greater than 1."
292 (defcustom ispell-program-name
"ispell"
293 "Program invoked by \\[ispell-word] and \\[ispell-region] commands."
297 (defcustom ispell-alternate-dictionary
298 (cond ((file-exists-p "/usr/dict/web2") "/usr/dict/web2")
299 ((file-exists-p "/usr/share/dict/web2") "/usr/share/dict/web2")
300 ((file-exists-p "/usr/dict/words") "/usr/dict/words")
301 ((file-exists-p "/usr/lib/dict/words") "/usr/lib/dict/words")
302 ((file-exists-p "/usr/share/dict/words") "/usr/share/dict/words")
303 ((file-exists-p "/usr/share/lib/dict/words")
304 "/usr/share/lib/dict/words")
305 ((file-exists-p "/sys/dict") "/sys/dict")
306 (t "/usr/dict/words"))
307 "*Alternate dictionary for spelling help."
308 :type
'(choice file
(const :tag
"None" nil
))
311 (defcustom ispell-complete-word-dict ispell-alternate-dictionary
312 "*Dictionary used for word completion."
313 :type
'(choice file
(const :tag
"None" nil
))
316 (defcustom ispell-message-dictionary-alist nil
317 "*List used by `ispell-message' to select a new dictionary.
318 It consists of pairs (REGEXP . DICTIONARY). If REGEXP is found
319 in the message headers, `ispell-local-dictionary' will be set to
320 DICTIONARY if `ispell-local-dictionary' is not buffer-local.
321 E.g. you may use the following value:
322 '((\"^Newsgroups:[ \\t]*de\\\\.\" . \"deutsch8\")
323 (\"^To:[^\\n,]+\\\\.de[ \\t\\n,>]\" . \"deutsch8\"))"
324 :type
'(repeat (cons regexp string
))
328 (defcustom ispell-grep-command
"egrep"
329 "Name of the grep command for search processes."
333 (defcustom ispell-grep-options
"-i"
334 "String of options to use when running the program in `ispell-grep-command'.
335 Should probably be \"-i\" or \"-e\".
336 Some machines (like the NeXT) don't support \"-i\""
340 (defcustom ispell-look-command
341 (cond ((file-exists-p "/bin/look") "/bin/look")
342 ((file-exists-p "/usr/local/bin/look") "/usr/local/bin/look")
343 ((file-exists-p "/usr/bin/look") "/usr/bin/look")
345 "Name of the look command for search processes.
346 This must be an absolute file name."
350 (defcustom ispell-look-p
(file-exists-p ispell-look-command
)
351 "*Non-nil means use `look' rather than `grep'.
352 Default is based on whether `look' seems to be available."
356 (defcustom ispell-have-new-look nil
357 "*Non-nil means use the `-r' option (regexp) when running `look'."
361 (defcustom ispell-look-options
(if ispell-have-new-look
"-dfr" "-df")
362 "String of command options for `ispell-look-command'."
366 (defcustom ispell-use-ptys-p nil
367 "When non-nil, Emacs uses ptys to communicate with Ispell.
368 When nil, Emacs uses pipes."
372 (defcustom ispell-following-word nil
373 "*Non-nil means `ispell-word' checks the word around or after point.
374 Otherwise `ispell-word' checks the preceding word."
378 (defcustom ispell-help-in-bufferp nil
379 "*Non-nil means display interactive keymap help in a buffer.
380 The following values are supported:
381 nil Expand the minibuffer and display a short help message
382 there for a couple of seconds.
383 t Pop up a new buffer and display a short help message there
384 for a couple of seconds.
385 electric Pop up a new buffer and display a long help message there.
386 User can browse and then exit the help mode."
387 :type
'(choice (const electric
) (const :tag
"off" nil
) (const :tag
"on" t
))
390 (defcustom ispell-quietly nil
391 "*Non-nil means suppress messages in `ispell-word'."
395 (defcustom ispell-format-word
(function upcase
)
396 "*Formatting function for displaying word being spell checked.
397 The function must take one string argument and return a string."
401 (defcustom ispell-use-framepop-p nil
402 "When non-nil ispell uses framepop to display choices in a dedicated frame.
403 You can set this variable to dynamically use framepop if you are in a
404 window system by evaluating the following on startup to set this variable:
405 (and window-system (condition-case () (require 'framepop) (error nil)))"
410 (defcustom ispell-personal-dictionary nil
411 "*File name of your personal spelling dictionary, or nil.
412 If nil, the default personal dictionary, \"~/.ispell_DICTNAME\" is used,
413 where DICTNAME is the name of your default dictionary."
415 (const :tag
"default" nil
))
418 (defcustom ispell-silently-savep nil
419 "*When non-nil, save the personal dictionary without confirmation."
423 ;;; This is the local dictionary to use. When nil the default dictionary will
424 ;;; be used. Change set-default call to use a new default dictionary.
425 (defcustom ispell-local-dictionary nil
426 "If non-nil, the dictionary to be used for Ispell commands.
427 The value must be a string dictionary name in `ispell-dictionary-alist'.
428 This variable becomes buffer-local when set in any fashion.
430 Setting `ispell-local-dictionary' to a value has the same effect as
431 calling \\[ispell-change-dictionary] with that value. This variable
432 is automatically set when defined in the file with either
433 `ispell-dictionary-keyword' or the Local Variable syntax.
435 To create a non-standard default dictionary (not from `ispell-dictionary-alist')
436 call function `set-default' with the new dictionary name."
437 :type
'(choice string
438 (const :tag
"default" nil
))
441 (make-variable-buffer-local 'ispell-local-dictionary
)
443 ;; Call this function set up the default dictionary if not English.
444 ;;(set-default 'ispell-local-dictionary nil)
447 (defcustom ispell-extra-args nil
448 "*If non-nil, a list of extra switches to pass to the Ispell program.
449 For example, (\"-W\" \"3\") to cause it to accept all 1-3 character
450 words as correct. See also `ispell-dictionary-alist', which may be used
451 for language-specific arguments."
452 :type
'(repeat string
)
457 (defcustom ispell-skip-html
'use-mode-name
458 "*Indicates whether ispell should skip spell checking of SGML markup.
459 If t, always skip SGML markup; if nil, never skip; if non-t and non-nil,
460 guess whether SGML markup should be skipped according to the name of the
461 buffer's major mode."
462 :type
'(choice (const :tag
"always" t
) (const :tag
"never" nil
)
463 (const :tag
"use-mode-name" use-mode-name
))
467 ;;; Define definitions here only for personal dictionaries.
469 (defcustom ispell-local-dictionary-alist nil
470 "*Contains local or customized dictionary definitions.
471 See `ispell-dictionary-alist'."
472 :type
'(repeat (list (choice :tag
"Dictionary"
473 (string :tag
"Dictionary name")
474 (const :tag
"default" nil
))
475 (regexp :tag
"Case characters")
476 (regexp :tag
"Non case characters")
477 (regexp :tag
"Other characters")
478 (boolean :tag
"Many other characters")
479 (repeat :tag
"Ispell command line args"
481 (choice :tag
"Extended character mode"
482 (const "~tex") (const "~plaintex")
483 (const "~nroff") (const "~list")
484 (const "~latin1") (const "~latin3")
485 (const :tag
"default" nil
))
486 (choice :tag
"Character set"
493 ;;; split dictionary so line length is smaller in loaddefs.el
495 ;;; First part of dictionary, shortened for loaddefs.el
498 ispell-dictionary-alist-1
499 '((nil ; default (English.aff)
500 "[A-Za-z]" "[^A-Za-z]" "[']" nil
("-B") nil iso-8859-1
)
501 ("american" ; Yankee English
502 "[A-Za-z]" "[^A-Za-z]" "[']" nil
("-B") nil iso-8859-1
)
503 ("brasileiro" ; Brazilian mode
504 "[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]"
505 "[^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]"
506 "[']" nil
("-d" "brasileiro") nil iso-8859-1
)
507 ("british" ; British version
508 "[A-Za-z]" "[^A-Za-z]" "[']" nil
("-B" "-d" "british") nil iso-8859-1
)
509 ("castellano" ; Spanish mode
510 "[A-Z\301\311\315\321\323\332\334a-z\341\351\355\361\363\372\374]"
511 "[^A-Z\301\311\315\321\323\332\334a-z\341\351\355\361\363\372\374]"
512 "[-]" nil
("-B" "-d" "castellano") "~tex" iso-8859-1
)
513 ("castellano8" ; 8 bit Spanish mode
514 "[A-Z\301\311\315\321\323\332\334a-z\341\351\355\361\363\372\374]"
515 "[^A-Z\301\311\315\321\323\332\334a-z\341\351\355\361\363\372\374]"
516 "[-]" nil
("-B" "-d" "castellano") "~latin1" iso-8859-1
)))
519 ;;; Second part of dictionary, shortened for loaddefs.el
522 ispell-dictionary-alist-2
524 "[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]"
525 "[^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]"
526 "" nil
("-B" "-d" "czech") nil iso-8859-2
)
528 "[A-Z\306\330\305a-z\346\370\345]" "[^A-Z\306\330\305a-z\346\370\345]"
529 "[']" nil
("-C") nil iso-8859-1
)
530 ("deutsch" ; Deutsch.aff
531 "[a-zA-Z\"]" "[^a-zA-Z\"]" "[']" t
("-C") "~tex" iso-8859-1
)
533 "[a-zA-Z\304\326\334\344\366\337\374]"
534 "[^a-zA-Z\304\326\334\344\366\337\374]"
535 "[']" t
("-C" "-d" "deutsch") "~latin1" iso-8859-1
)
536 ("english" ; make English explicitly selectable
537 "[A-Za-z]" "[^A-Za-z]" "[']" nil
("-B") nil iso-8859-1
)))
540 ;;; Third part of dictionary, shortened for loaddefs.el
543 ispell-dictionary-alist-3
545 "[A-Za-z\246\254\266\274\306\330\335\336\346\370\375\376]"
546 "[^A-Za-z\246\254\266\274\306\330\335\336\346\370\375\376]"
547 "[-']" t
("-C") "~latin3" iso-8859-1
)
549 "[A-Za-z^\\]" "[^A-Za-z^\\]"
550 "[-'`\"]" t
("-C" "-d" "esperanto") "~tex" iso-8859-1
)
552 "[A-Za-z]" "[^A-Za-z]" "[`'^---]" t nil nil iso-8859-1
)
553 ("francais" ; Francais.aff
554 "[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]"
555 "[^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]"
556 "[-']" t nil
"~list" iso-8859-1
)))
559 ;;; Fourth part of dictionary, shortened for loaddefs.el
562 ispell-dictionary-alist-4
563 '(("francais-tex" ; Francais.aff
564 "[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\\]"
565 "[^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\\]"
566 "[-'^`\"]" t nil
"~tex" iso-8859-1
)
567 ("german" ; german.aff
568 "[a-zA-Z\"]" "[^a-zA-Z\"]" "[']" t
("-C") "~tex" iso-8859-1
)
570 "[a-zA-Z\304\326\334\344\366\337\374]"
571 "[^a-zA-Z\304\326\334\344\366\337\374]"
572 "[']" t
("-C" "-d" "german") "~latin1" iso-8859-1
)
573 ("italiano" ; Italian.aff
574 "[A-Z\300\301\310\311\314\315\322\323\331\332a-z\340\341\350\351\354\355\363\371\372]"
575 "[^A-Z\300\301\310\311\314\315\322\323\331\332a-z\340\341\350\351\354\355\363\371\372]"
576 "[-]" nil
("-B" "-d" "italian") "~tex" iso-8859-1
)))
579 ;;; Fifth part of dictionary, shortened for loaddefs.el
582 ispell-dictionary-alist-5
583 '(("nederlands" ; Nederlands.aff
584 "[A-Za-z\300-\305\307\310-\317\322-\326\331-\334\340-\345\347\350-\357\361\362-\366\371-\374]"
585 "[^A-Za-z\300-\305\307\310-\317\322-\326\331-\334\340-\345\347\350-\357\361\362-\366\371-\374]"
586 "[']" t
("-C") nil iso-8859-1
)
587 ("nederlands8" ; Dutch8.aff
588 "[A-Za-z\300-\305\307\310-\317\322-\326\331-\334\340-\345\347\350-\357\361\362-\366\371-\374]"
589 "[^A-Za-z\300-\305\307\310-\317\322-\326\331-\334\340-\345\347\350-\357\361\362-\366\371-\374]"
590 "[']" t
("-C") nil iso-8859-1
)
591 ("norsk" ; 8 bit Norwegian mode
592 "[A-Za-z\305\306\307\310\311\322\324\330\345\346\347\350\351\362\364\370]"
593 "[^A-Za-z\305\306\307\310\311\322\324\330\345\346\347\350\351\362\364\370]"
594 "[\"]" nil
("-d" "norsk") "~list" iso-8859-1
)
595 ("norsk7-tex" ; 7 bit Norwegian TeX mode
596 "[A-Za-z{}\\'^`]" "[^A-Za-z{}\\'^`]"
597 "[\"]" nil
("-d" "norsk") "~plaintex" iso-8859-1
)))
600 ;;; Sixth part of dictionary, shortened for loaddefs.el
603 ispell-dictionary-alist-6
604 ;; include Russian iso character set too?
605 ;; "[']" t ("-d" "russian") "~latin1" iso-8859-1
606 '(("polish" ; polish mode
607 "[A-Za-z\241\243\246\254\257\261\263\266\274\277\306\312\321\323\346\352\361\363]"
608 "[^A-Za-z\241\243\246\254\257\261\263\266\274\277\306\312\321\323\346\352\361\363]"
609 "" nil
( "-d" "polish") nil iso-8859-2
)
610 ("russian" ; Russian.aff (KOI8-R charset)
611 "[\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]"
612 "[^\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]"
613 "" nil
("-d" "russian") nil koi8-r
)
614 ("svenska" ; Swedish mode
615 "[A-Za-z\345\344\366\351\340\374\350\346\370\347\305\304\326\311\300\334\310\306\330\307]"
616 "[^A-Za-z\345\344\366\351\340\374\350\346\370\347\305\304\326\311\300\334\310\306\330\307]"
617 "[']" nil
("-C") "~list" iso-8859-1
)
619 "[a-zA-Z\301\302\311\323\340\341\342\351\352\355\363\343\372]"
620 "[^a-zA-Z\301\302\311\323\340\341\342\351\352\355\363\343\372]"
621 "[']" t
("-C" "-d" "portugues") "~latin1" iso-8859-1
)
623 "[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]"
624 "[^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]"
625 "" nil
("-B" "-d" "slovak") nil iso-8859-2
)))
628 (defcustom ispell-dictionary-alist
629 (append ispell-local-dictionary-alist
; dictionary customizations
630 ispell-dictionary-alist-1 ispell-dictionary-alist-2
631 ispell-dictionary-alist-3 ispell-dictionary-alist-4
632 ispell-dictionary-alist-5 ispell-dictionary-alist-6
)
633 "An alist of dictionaries and their associated parameters.
635 Each element of this list is also a list:
637 \(DICTIONARY-NAME CASECHARS NOT-CASECHARS OTHERCHARS MANY-OTHERCHARS-P
638 ISPELL-ARGS EXTENDED-CHARACTER-MODE CHARACTER-SET\)
640 DICTIONARY-NAME is a possible string value of variable `ispell-dictionary',
641 nil means the default dictionary.
643 CASECHARS is a regular expression of valid characters that comprise a
646 NOT-CASECHARS is the opposite regexp of CASECHARS.
648 OTHERCHARS is a regexp of characters in the NOT-CASECHARS set but which can be
649 used to construct words in some special way. If OTHERCHARS characters follow
650 and precede characters from CASECHARS, they are parsed as part of a word,
651 otherwise they become word-breaks. As an example in English, assume the
652 regular expression \"[']\" for OTHERCHARS. Then \"they're\" and
653 \"Steven's\" are parsed as single words including the \"'\" character, but
654 \"Stevens'\" does not include the quote character as part of the word.
655 If you want OTHERCHARS to be empty, use the empty string.
656 Hint: regexp syntax requires the hyphen to be declared first here.
658 MANY-OTHERCHARS-P is non-nil when multiple OTHERCHARS are allowed in a word.
659 Otherwise only a single OTHERCHARS character is allowed to be part of any
662 ISPELL-ARGS is a list of additional arguments passed to the ispell
665 EXTENDED-CHARACTER-MODE should be used when dictionaries are used which
666 have been configured in an Ispell affix file. (For example, umlauts
667 can be encoded as \\\"a, a\\\", \"a, ...) Defaults are ~tex and ~nroff
668 in English. This has the same effect as the command-line `-T' option.
669 The buffer Major Mode controls Ispell's parsing in tex or nroff mode,
670 but the dictionary can control the extended character mode.
671 Both defaults can be overruled in a buffer-local fashion. See
672 `ispell-parsing-keyword' for details on this.
674 CHARACTER-SET used for languages with multibyte characters.
676 Note that the CASECHARS and OTHERCHARS slots of the alist should
677 contain the same character set as casechars and otherchars in the
678 LANGUAGE.aff file \(e.g., english.aff\)."
679 :type
'(repeat (list (choice :tag
"Dictionary"
680 (string :tag
"Dictionary name")
681 (const :tag
"default" nil
))
682 (regexp :tag
"Case characters")
683 (regexp :tag
"Non case characters")
684 (regexp :tag
"Other characters")
685 (boolean :tag
"Many other characters")
686 (repeat :tag
"Ispell command line args"
688 (choice :tag
"Extended character mode"
689 (const "~tex") (const "~plaintex")
690 (const "~nroff") (const "~list")
691 (const "~latin1") (const "~latin3")
692 (const :tag
"default" nil
))
693 (choice :tag
"Character set"
699 ;;; update the dictionaries at load time
700 (setq ispell-dictionary-alist
701 (append ispell-local-dictionary-alist
; dictionary customizations
702 ispell-dictionary-alist-1 ispell-dictionary-alist-2
703 ispell-dictionary-alist-3 ispell-dictionary-alist-4
704 ispell-dictionary-alist-5 ispell-dictionary-alist-6
))
709 ;;; **********************************************************************
710 ;;; The following are used by ispell, and should not be changed.
711 ;;; **********************************************************************
715 ;;; The version must be 3.1 or greater for this version of ispell.el
716 ;;; There is an incompatibility between version 3.1.12 and lower versions.
717 (defconst ispell-required-version
'(3 1 12)
718 "Ispell versions with which this version of ispell.el is known to work.")
719 (defvar ispell-offset -
1
720 "Offset that maps protocol differences between ispell 3.1 versions.")
722 (defconst ispell-version
"ispell.el 3.4 -- Fri Aug 4 09:41:50 PDT 2000")
725 (defun check-ispell-version (&optional interactivep
)
726 "Ensure that `ispell-program-name' is valid and the correct version.
727 Returns version number if called interactively.
728 Otherwise returns the library path if defined."
729 ;; This is a little wasteful as we actually launch ispell twice: once
730 ;; to make sure it's the right version, and once for real. But people
731 ;; get confused by version mismatches *all* the time (and I've got the
732 ;; email to prove it) so I think this is worthwhile. And the -v[ersion]
733 ;; option is the only way I can think of to do this that works with
734 ;; all versions, since versions earlier than 3.0.09 didn't identify
735 ;; themselves on startup.
737 (let ((case-fold-search-val case-fold-search
)
738 ;; avoid bugs when syntax of `.' changes in various default modes
739 (default-major-mode 'fundamental-mode
)
742 (set-buffer (get-buffer-create " *ispell-tmp*"))
744 (setq status
(call-process
745 ispell-program-name nil t nil
746 ;; aspell doesn't accept the -vv switch.
747 (let ((case-fold-search
748 (memq system-type
'(ms-dos windows-nt
)))
750 (file-name-nondirectory ispell-program-name
)))
751 ;; Assume anything that isn't `aspell' is Ispell.
752 (if (string-match "\\`aspell" speller
) "-v" "-vv"))))
753 (goto-char (point-min))
757 (setq result
(concat (buffer-substring-no-properties (point-min)
762 ;; return library path.
763 (if (re-search-forward "LIBDIR = \\\"\\([^ \t\n]*\\)\\\"" nil t
)
764 (setq result
(buffer-substring (match-beginning 1) (match-end 1)))))
765 (goto-char (point-min))
766 (if (not (memq status
'(0 nil
)))
767 (error "%s exited with %s %s" ispell-program-name
768 (if (stringp status
) "signal" "code") status
))
769 (setq case-fold-search t
770 status
(re-search-forward
772 (format "%d" (car ispell-required-version
))
773 "\\)\\.\\([0-9]*\\)\\.\\([0-9]*\\)\\>")
775 case-fold-search case-fold-search-val
)
776 (if (or (not status
) ; major version mismatch
777 (< (car (read-from-string (buffer-substring-no-properties
778 (match-beginning 2) (match-end 2))))
779 (car (cdr ispell-required-version
)))) ; minor version mismatch
780 (error "%s version 3 release %d.%d.%d or greater is required"
781 ispell-program-name
(car ispell-required-version
)
782 (car (cdr ispell-required-version
))
783 (car (cdr (cdr ispell-required-version
))))
784 ;; check that it is the correct version.
785 (if (and (= (car (read-from-string (buffer-substring-no-properties
786 (match-beginning 2)(match-end 2))))
787 (car (cdr ispell-required-version
)))
788 (< (car (read-from-string (buffer-substring-no-properties
789 (match-beginning 3)(match-end 3))))
790 (car (cdr (cdr ispell-required-version
)))))
791 (setq ispell-offset
0)))
792 (kill-buffer (current-buffer)))
797 ;;; The preparation of the menu bar menu must be autoloaded
798 ;;; because otherwise this file gets autoloaded every time Emacs starts
799 ;;; so that it can set up the menus and determine keyboard equivalents.
803 (defvar ispell-menu-map nil
"Key map for ispell menu.")
804 ;;; redo menu when loading ispell to get dictionary modifications
805 (setq ispell-menu-map nil
)
808 (defvar ispell-menu-xemacs nil
809 "Spelling menu for XEmacs.
810 If nil when package is loaded, a standard menu will be set,
811 and added as a submenu of the \"Edit\" menu.")
813 ;;; Break out XEmacs menu and split into several calls to avoid having
814 ;;; long lines in loaddefs.el. Detect need off following constant.
816 ;;; Set up dictionary
818 (defvar ispell-menu-map-needed
819 ;; only needed when not version 18 and not XEmacs.
820 (and (not ispell-menu-map
)
825 (defvar ispell-library-path
(if (or (not (fboundp 'byte-compiling-files-p
))
826 (not (byte-compiling-files-p)))
827 (check-ispell-version))
828 "The directory where ispell dictionaries reside.")
830 (defvar ispell-process nil
831 "The process object for Ispell.")
833 (defvar ispell-async-processp
(and (fboundp 'kill-process
)
834 (fboundp 'process-send-string
)
835 (fboundp 'accept-process-output
)
836 ;;(fboundp 'start-process)
837 ;;(fboundp 'set-process-filter)
838 ;;(fboundp 'process-kill-without-query)
840 "Non-nil means that the OS supports asynchronous processes.")
843 (if (and ispell-menu-map-needed
844 (or (not (fboundp 'byte-compiling-files-p
))
845 (not (byte-compiling-files-p))))
846 (let ((dicts (reverse (cons (cons "default" nil
) ispell-dictionary-alist
)))
847 ;; `ispell-library-path' intentionally not defined in autoload
848 (path (and (boundp 'ispell-library-path
) ispell-library-path
))
850 (setq ispell-menu-map
(make-sparse-keymap "Spell"))
851 ;; add the dictionaries to the bottom of the list.
853 (setq name
(car (car dicts
))
854 load-dict
(car (cdr (member "-d" (nth 5 (car dicts
)))))
856 (cond ((not (stringp name
))
857 (define-key ispell-menu-map
(vector 'default
)
858 (cons "Select Default Dict"
859 (cons "Dictionary for which Ispell was configured"
860 (list 'lambda
() '(interactive)
862 'ispell-change-dictionary
"default"))))))
863 ((or (not path
) ; load all if library dir not defined
864 (file-exists-p (concat path
"/" name
".hash"))
865 (file-exists-p (concat path
"/" name
".has"))
867 (or (file-exists-p(concat path
"/" load-dict
".hash"))
868 (file-exists-p(concat path
"/" load-dict
".has")))))
869 (define-key ispell-menu-map
(vector (intern name
))
870 (cons (concat "Select " (capitalize name
) " Dict")
871 (list 'lambda
() '(interactive)
872 (list 'ispell-change-dictionary name
)))))))))
875 ;;; define commands in menu in opposite order you want them to appear.
877 (if (and ispell-menu-map-needed
878 (or (not (fboundp 'byte-compiling-files-p
))
879 (not (byte-compiling-files-p))))
881 (define-key ispell-menu-map
[ispell-change-dictionary
]
882 '(menu-item "Change Dictionary..." ispell-change-dictionary
883 :help
"Supply explicit path to dictionary"))
884 (define-key ispell-menu-map
[ispell-kill-ispell
]
885 '(menu-item "Kill Process" ispell-kill-ispell
886 :enable
(and (boundp 'ispell-process
) ispell-process
887 (eq (ispell-process-status) 'run
))
888 :help
"Terminate Ispell subprocess"))
889 (define-key ispell-menu-map
[ispell-pdict-save
]
890 '(menu-item "Save Dictionary"
891 (lambda () (interactive) (ispell-pdict-save t t
))
892 :help
"Save personal dictionary"))
893 (define-key ispell-menu-map
[ispell-help
]
894 ;; use (x-popup-menu last-nonmenu-event(list "" ispell-help-list)) ?
896 (lambda () (interactive) (describe-function 'ispell-help
))
897 :help
"Show standard Ispell keybindings and commands"))
898 (define-key ispell-menu-map
[ispell-complete-word
]
899 '(menu-item "Complete Word" ispell-complete-word
900 :help
"Complete word at cursor using dictionary"))
901 (define-key ispell-menu-map
[ispell-complete-word-interior-frag
]
902 '(menu-item "Complete Word Fragment" ispell-complete-word-interior-frag
903 :help
"Complete word fragment at cursor"))))
906 (if (and ispell-menu-map-needed
907 (or (not (fboundp 'byte-compiling-files-p
))
908 (not (byte-compiling-files-p))))
910 (define-key ispell-menu-map
[ispell-continue
]
911 '(menu-item "Continue Spell-Checking" ispell-continue
912 :enable
(and (boundp 'ispell-region-end
)
913 (marker-position ispell-region-end
)
914 (equal (marker-buffer ispell-region-end
)
916 :help
"Continue spell checking last region"))
917 (define-key ispell-menu-map
[ispell-word
]
918 '(menu-item "Spell-Check Word" ispell-word
919 :help
"Spell-check word at cursor"))
920 (define-key ispell-menu-map
[ispell-comments-and-strings
]
921 '(menu-item "Spell-Check Comments" ispell-comments-and-strings
922 :help
"Spell-check only comments and strings"))))
925 (if (and ispell-menu-map-needed
926 (or (not (fboundp 'byte-compiling-files-p
))
927 (not (byte-compiling-files-p))))
929 (define-key ispell-menu-map
[ispell-region
]
930 '(menu-item "Spell-Check Region" ispell-region
932 :help
"Spell-check text in marked region"))
933 (define-key ispell-menu-map
[ispell-message
]
934 '(menu-item "Spell-Check Message" ispell-message
935 :help
"Skip headers and included message text"))
936 (define-key ispell-menu-map
[ispell-buffer
]
937 '(menu-item "Spell-Check Buffer" ispell-buffer
938 :help
"Check spelling of selected buffer"))
939 ;;(put 'ispell-region 'menu-enable 'mark-active)
940 (fset 'ispell-menu-map
(symbol-value 'ispell-menu-map
))))
942 ;;; XEmacs versions 19 & 20
946 (null ispell-menu-xemacs
)
947 (not (and (boundp 'infodock-version
) infodock-version
)))
948 (let ((dicts (cons (cons "default" nil
) ispell-dictionary-alist
))
949 (current-menubar (or current-menubar default-menubar
))
951 '(["Help" (describe-function 'ispell-help
) t
]
952 ;;["Help" (popup-menu ispell-help-list) t]
953 ["Check Message" ispell-message t
]
954 ["Check Buffer" ispell-buffer t
]
955 ["Check Comments" ispell-comments-and-strings t
]
956 ["Check Word" ispell-word t
]
957 ["Check Region" ispell-region
(or (not zmacs-regions
) (mark))]
958 ["Continue Check" ispell-continue t
]
959 ["Complete Word Frag"ispell-complete-word-interior-frag t
]
960 ["Complete Word" ispell-complete-word t
]
961 ["Kill Process" ispell-kill-ispell t
]
963 ["Save Personal Dict"(ispell-pdict-save t t
) t
]
964 ["Change Dictionary" ispell-change-dictionary t
]
965 ["Select Default" (ispell-change-dictionary "default") t
]))
968 (setq name
(car (car dicts
))
969 load-dict
(car (cdr (member "-d" (nth 5 (car dicts
)))))
971 ;; Include if the dictionary is in the library, or path not defined.
972 (if (and (stringp name
)
973 (or (not ispell-library-path
)
974 (file-exists-p (concat ispell-library-path
"/"
976 (file-exists-p (concat ispell-library-path
"/"
979 (or (file-exists-p (concat ispell-library-path
"/"
981 (file-exists-p (concat ispell-library-path
"/"
982 load-dict
".has"))))))
983 (setq menu
(append menu
985 (vector (concat "Select " (capitalize name
))
986 (list 'ispell-change-dictionary name
)
988 (setq ispell-menu-xemacs menu
)
991 (delete-menu-item '("Edit" "Spell")) ; in case already defined
992 (add-menu '("Edit") "Spell" ispell-menu-xemacs
)))))
994 ;;; Allow incrementing characters as integers in XEmacs 20
997 (fset 'ispell-int-char
'int-char
)
998 ;; Emacs and XEmacs 19 or earlier
999 (fset 'ispell-int-char
'identity
))
1002 ;;; **********************************************************************
1005 ;;; This variable contains the current dictionary being used if the ispell
1006 ;;; process is running. Otherwise it contains the global default.
1007 (defvar ispell-dictionary nil
1008 "The name of the current dictionary, or nil for the default.
1009 When `ispell-local-dictionary' is nil, `ispell-dictionary' is used to select
1010 the dictionary for new buffers.
1012 This is passed to the ispell process using the `-d' switch and is
1013 used as key in `ispell-dictionary-alist' (which see).")
1015 (defun ispell-decode-string (str)
1016 "Decodes multibyte character strings.
1017 Protects against bogus binding of `enable-multibyte-characters' in XEmacs."
1018 (if (and (or xemacsp
1019 (and (boundp 'enable-multibyte-characters
)
1020 enable-multibyte-characters
))
1021 (fboundp 'decode-coding-string
)
1022 (ispell-get-coding-system))
1023 (decode-coding-string str
(ispell-get-coding-system))
1026 (defun ispell-get-casechars ()
1027 (ispell-decode-string
1028 (nth 1 (assoc ispell-dictionary ispell-dictionary-alist
))))
1029 (defun ispell-get-not-casechars ()
1030 (ispell-decode-string
1031 (nth 2 (assoc ispell-dictionary ispell-dictionary-alist
))))
1032 (defun ispell-get-otherchars ()
1033 (ispell-decode-string
1034 (nth 3 (assoc ispell-dictionary ispell-dictionary-alist
))))
1035 (defun ispell-get-many-otherchars-p ()
1036 (nth 4 (assoc ispell-dictionary ispell-dictionary-alist
)))
1037 (defun ispell-get-ispell-args ()
1038 (nth 5 (assoc ispell-dictionary ispell-dictionary-alist
)))
1039 (defun ispell-get-extended-character-mode ()
1040 (nth 6 (assoc ispell-dictionary ispell-dictionary-alist
)))
1041 (defun ispell-get-coding-system ()
1042 (nth 7 (assoc ispell-dictionary ispell-dictionary-alist
)))
1045 (defvar ispell-pdict-modified-p nil
1046 "Non-nil means personal dictionary has modifications to be saved.")
1048 ;;; If you want to save the dictionary when quitting, must do so explicitly.
1049 ;;; When non-nil, the spell session is terminated.
1050 ;;; When numeric, contains cursor location in buffer, and cursor remains there.
1051 (defvar ispell-quit nil
)
1053 (defvar ispell-process-directory nil
1054 "The directory where `ispell-process' was started.")
1056 (defvar ispell-filter nil
1057 "Output filter from piped calls to Ispell.")
1059 (defvar ispell-filter-continue nil
1060 "Control variable for Ispell filter function.")
1062 (defvar ispell-output-buffer nil
1063 "Buffer used for reading output of a synchronous Ispell subprocess.")
1065 (defvar ispell-session-buffer nil
1066 "Buffer used for passing input to a synchronous Ispell subprocess.")
1068 (defvar ispell-cmd-args nil
1069 "Command-line arguments to pass to a synchronous Ispell subprocess.")
1071 (defvar ispell-query-replace-marker
(make-marker)
1072 "Marker for `query-replace' processing.")
1074 (defvar ispell-recursive-edit-marker
(make-marker)
1075 "Marker for return point from recursive edit.")
1077 (defvar ispell-checking-message nil
1078 "Non-nil when we're checking a mail message.")
1080 (defconst ispell-choices-buffer
"*Choices*")
1082 (defvar ispell-overlay nil
"Overlay variable for Ispell highlighting.")
1084 ;;; *** Buffer Local Definitions ***
1086 (defconst ispell-words-keyword
"LocalWords: "
1087 "The keyword for local oddly-spelled words to accept.
1088 The keyword will be followed by any number of local word spellings.
1089 There can be multiple of these keywords in the file.")
1091 (defconst ispell-dictionary-keyword
"Local IspellDict: "
1092 "The keyword for a local dictionary to use.
1093 The keyword must be followed by a correct dictionary name in
1094 `ispell-dictionary-alist'. When multiple occurrences exist, the last keyword
1095 definition is used.")
1097 (defconst ispell-pdict-keyword
"Local IspellPersDict: "
1098 "The keyword for defining buffer local dictionaries.
1099 Keyword must be followed by the filename of a personal dictionary.
1100 The last occurring definition in the buffer will be used.")
1102 (defconst ispell-parsing-keyword
"Local IspellParsing: "
1103 "The keyword for overriding default Ispell parsing.
1104 The above keyword string should be followed by `latex-mode' or
1105 `nroff-mode' to put the current buffer into the desired parsing mode.
1107 Extended character mode can be changed for this buffer by placing
1108 a `~' followed by an extended-character mode -- such as `~.tex'.
1109 The last occurring definition in the buffer will be used.")
1112 (defvar ispell-skip-region-alist
1113 '((ispell-words-keyword forward-line
)
1114 (ispell-dictionary-keyword forward-line
)
1115 (ispell-pdict-keyword forward-line
)
1116 (ispell-parsing-keyword forward-line
)
1117 ("^---*BEGIN PGP [A-Z ]*--*" .
"^---*END PGP [A-Z ]*--*")
1118 ("^---* \\(Start of \\)?[Ff]orwarded [Mm]essage" .
"^---* End of [Ff]orwarded [Mm]essage")
1119 ;; Matches e-mail addresses, file names, http addresses, etc. The `-+'
1120 ;; pattern necessary for performance reasons when `-' part of word syntax.
1121 ("\\(-+\\|\\(/\\|\\(\\(\\w\\|[-_]\\)+[.:@]\\)\\)\\(\\w\\|[-_]\\)*\\([.:/@]+\\(\\w\\|[-_]\\|~\\)+\\)+\\)")
1122 ;; This is a pretty complex regexp. It can be simplified to the following:
1123 ;; "\\(\\w\\|[-_]\\)*\\([.:/@]+\\(\\w\\|[-_]\\|~\\)+\\)+"
1124 ;; but some valid text will be skipped, e.g. "his/her". This could be
1125 ;; fixed up (at the expense of a moderately more complex regexp)
1126 ;; by not allowing "/" to be the character which triggers the
1127 ;; identification of the computer name, e.g.:
1128 ;; "\\(\\w\\|[-_]\\)+[.:@]\\(\\w\\|[-_]\\)*\\([.:/@]+\\(\\w\\|[-_]\\|~\\)+\\)+"
1130 "Alist expressing beginning and end of regions not to spell check.
1131 The alist key must be a regular expression.
1132 Valid forms include:
1133 (KEY) - just skip the key.
1134 (KEY . REGEXP) - skip to the end of REGEXP. REGEXP may be string or symbol.
1135 (KEY REGEXP) - skip to end of REGEXP. REGEXP must be a string.
1136 (KEY FUNCTION ARGS) - FUNCTION called with ARGS returns end of region.")
1141 (defvar ispell-tex-skip-alists
1142 '((;;("%\\[" . "%\\]") ; AMStex block comment...
1143 ;; All the standard LaTeX keywords from L. Lamport's guide:
1144 ;; \cite, \hspace, \hspace*, \hyphenation, \include, \includeonly, \input,
1145 ;; \label, \nocite, \rule (in ispell - rest included here)
1146 ("\\\\addcontentsline" ispell-tex-arg-end
2)
1147 ("\\\\add\\(tocontents\\|vspace\\)" ispell-tex-arg-end
)
1148 ("\\\\\\([aA]lph\\|arabic\\)" ispell-tex-arg-end
)
1149 ;;("\\\\author" ispell-tex-arg-end)
1150 ("\\\\bibliographystyle" ispell-tex-arg-end
)
1151 ("\\\\makebox" ispell-tex-arg-end
0)
1152 ("\\\\e?psfig" ispell-tex-arg-end
)
1153 ("\\\\document\\(class\\|style\\)" .
1154 "\\\\begin[ \t\n]*{[ \t\n]*document[ \t\n]*}"))
1155 (;; delimited with \begin. In ispell: displaymath, eqnarray, eqnarray*,
1156 ;; equation, minipage, picture, tabular, tabular* (ispell)
1157 ("\\(figure\\|table\\)\\*?" ispell-tex-arg-end
0)
1158 ("list" ispell-tex-arg-end
2)
1159 ("program" .
"\\\\end[ \t\n]*{[ \t\n]*program[ \t\n]*}")
1160 ("verbatim\\*?" .
"\\\\end[ \t\n]*{[ \t\n]*verbatim\\*?[ \t\n]*}")))
1161 "*Lists of regions to be skipped in TeX mode.
1162 First list is used raw.
1163 Second list has key placed inside \\begin{}.
1165 Delete or add any regions you want to be automatically selected
1166 for skipping in latex mode.")
1169 (defvar ispell-local-pdict ispell-personal-dictionary
1170 "A buffer local variable containing the current personal dictionary.
1171 If non-nil, the value must be a string, which is a file name.
1173 If you specify a personal dictionary for the current buffer which is
1174 different from the current personal dictionary, the effect is similar
1175 to calling \\[ispell-change-dictionary]. This variable is automatically
1176 set when defined in the file with either `ispell-pdict-keyword' or the
1177 local variable syntax.")
1179 (make-variable-buffer-local 'ispell-local-pdict
)
1181 (defvar ispell-buffer-local-name nil
1182 "Contains the buffer name if local word definitions were used.
1183 Ispell is then restarted because the local words could conflict.")
1185 (defvar ispell-parser
'use-mode-name
1186 "*Indicates whether ispell should parse the current buffer as TeX Code.
1187 Special value `use-mode-name' tries to guess using the name of `major-mode'.
1188 Default parser is `nroff'.
1189 Currently the only other valid parser is `tex'.
1191 You can set this variable in hooks in your init file -- eg:
1193 (add-hook 'tex-mode-hook (function (lambda () (setq ispell-parser 'tex))))")
1195 (defvar ispell-region-end
(make-marker)
1196 "Marker that allows spelling continuations.")
1198 (defvar ispell-check-only nil
1199 "If non-nil, `ispell-word' does not try to correct the word.")
1202 ;;; **********************************************************************
1203 ;;; **********************************************************************
1208 (define-key esc-map
"$" 'ispell-word
)
1211 (defun ispell-accept-output (&optional timeout-secs timeout-msecs
)
1212 "Wait for output from ispell process, or TIMEOUT-SECS and TIMEOUT-MSECS.
1213 If asynchronous subprocesses are not supported, call `ispell-filter' and
1214 pass it the output of the last ispell invocation."
1215 (if ispell-async-processp
1216 (accept-process-output ispell-process timeout-secs timeout-msecs
)
1217 (if (null ispell-process
)
1218 (error "No Ispell process to read output from!")
1219 (let ((buf ispell-output-buffer
)
1221 (if (not (bufferp buf
))
1222 (setq ispell-filter nil
)
1225 (setq ispell-output
(buffer-substring-no-properties
1226 (point-min) (point-max))))
1227 (ispell-filter t ispell-output
)
1230 (erase-buffer)))))))
1233 (defun ispell-send-string (string)
1234 "Send the string STRING to the Ispell process."
1235 (if ispell-async-processp
1236 (process-send-string ispell-process string
)
1237 ;; Asynchronous subprocesses aren't supported on this losing system.
1238 ;; We keep all the directives passed to Ispell during the entire
1239 ;; session in a buffer, and pass them anew each time we invoke
1240 ;; Ispell to process another chunk of text. (Yes, I know this is a
1241 ;; terrible kludge, and it's a bit slow, but it does get the work done.)
1242 (let ((cmd (aref string
0))
1243 ;; The following commands are not passed to Ispell until
1244 ;; we have a *reall* reason to invoke it.
1245 (cmds-to-defer '(?
* ?
@ ?~ ?
+ ?- ?
! ?%
))
1246 (default-major-mode 'fundamental-mode
)
1247 (session-buf ispell-session-buffer
)
1248 (output-buf ispell-output-buffer
)
1249 (ispell-args ispell-cmd-args
)
1250 (defdir ispell-process-directory
)
1253 (set-buffer session-buf
)
1254 (setq prev-pos
(point))
1255 (setq default-directory defdir
)
1257 (if (not (memq cmd cmds-to-defer
))
1258 (let (coding-system-for-read coding-system-for-write status
)
1260 (and (boundp 'enable-multibyte-characters
)
1261 enable-multibyte-characters
))
1262 (setq coding-system-for-read
(ispell-get-coding-system)
1263 coding-system-for-write
(ispell-get-coding-system)))
1264 (set-buffer output-buf
)
1266 (set-buffer session-buf
)
1268 (apply 'call-process-region
(point-min) (point-max)
1269 ispell-program-name nil
1271 "-a" "-m" ispell-args
))
1272 (set-buffer output-buf
)
1273 (goto-char (point-min))
1275 (if (not (looking-at "@(#) "))
1276 (error "Ispell error: %s"
1277 (buffer-substring-no-properties
1278 (point) (progn (end-of-line) (point)))))
1279 ;; If STRING is "^Z\n", we just started Ispell and need
1280 ;; to retain its version ID line in the output buffer.
1281 ;; Otherwise, remove the ID line, as it will confuse
1283 (or (string= string
"\032\n")
1286 (delete-region (point-min) (point))))
1287 ;; If STRING begins with ^ or any normal character, we need
1288 ;; to remove the last line from the session buffer, since it
1289 ;; was just spell-checked, and we don't want to check it again.
1290 ;; The same goes for the # command, since Ispell already saved
1291 ;; the personal dictionary.
1292 (set-buffer session-buf
)
1293 (delete-region prev-pos
(point))
1294 ;; Ispell run synchronously saves the personal dictionary
1295 ;; after each successful command. So we can remove any
1296 ;; lines in the session buffer that insert words into the
1298 (if (memq status
'(0 nil
))
1299 (let ((more-lines t
))
1300 (goto-char (point-min))
1302 (if (looking-at "^\\*")
1303 (let ((start (point)))
1305 (delete-region start
(point)))
1306 (setq more-lines
(= 0 (forward-line))))))))))))))
1311 (defun ispell-word (&optional following quietly continue
)
1312 "Check spelling of word under or before the cursor.
1313 If the word is not found in dictionary, display possible corrections
1314 in a window allowing you to choose one.
1316 If optional argument FOLLOWING is non-nil or if `ispell-following-word'
1317 is non-nil when called interactively, then the following word
1318 \(rather than preceding\) is checked when the cursor is not over a word.
1319 When the optional argument QUIETLY is non-nil or `ispell-quietly' is non-nil
1320 when called interactively, non-corrective messages are suppressed.
1322 With a prefix argument (or if CONTINUE is non-nil),
1323 resume interrupted spell-checking of a buffer or region.
1325 Word syntax described by `ispell-dictionary-alist' (which see).
1327 This will check or reload the dictionary. Use \\[ispell-change-dictionary]
1328 or \\[ispell-region] to update the Ispell process.
1331 nil word is correct or spelling is accpeted.
1332 0 word is inserted into buffer-local definitions.
1333 \"word\" word corrected from word list.
1334 \(\"word\" arg\) word is hand entered.
1335 quit spell session exited."
1337 (interactive (list nil nil current-prefix-arg
))
1341 (setq following ispell-following-word
1342 quietly ispell-quietly
))
1343 (ispell-accept-buffer-local-defs) ; use the correct dictionary
1344 (let ((cursor-location (point)) ; retain cursor location
1345 (word (ispell-get-word following
))
1346 start end poss new-word replace
)
1347 ;; De-structure return word info list.
1348 (setq start
(car (cdr word
))
1349 end
(car (cdr (cdr word
)))
1352 ;; now check spelling of word if it has 3 or more characters.
1354 ((> (length word
) 2)
1356 (message "Checking spelling of %s..."
1357 (funcall ispell-format-word word
)))
1358 (ispell-send-string "%\n") ; put in verbose mode
1359 (ispell-send-string (concat "^" word
"\n"))
1360 ;; wait until ispell has processed word
1362 (ispell-accept-output)
1363 (not (string= "" (car ispell-filter
)))))
1364 ;;(ispell-send-string "!\n") ;back to terse mode.
1365 (setq ispell-filter
(cdr ispell-filter
)) ; remove extra \n
1366 (if (and ispell-filter
(listp ispell-filter
))
1367 (if (> (length ispell-filter
) 1)
1368 (error "Ispell and its process have different character maps")
1369 (setq poss
(ispell-parse-output (car ispell-filter
)))))
1372 (message "%s is correct"
1373 (funcall ispell-format-word word
))))
1376 (message "%s is correct because of root %s"
1377 (funcall ispell-format-word word
)
1378 (funcall ispell-format-word poss
))))
1379 ((null poss
) (message "Error in ispell process"))
1380 (ispell-check-only ; called from ispell minor mode.
1382 (message "%s is incorrect" (funcall ispell-format-word word
)))
1383 (t ; prompt for correct word.
1384 (save-window-excursion
1385 (setq replace
(ispell-command-loop
1386 (car (cdr (cdr poss
)))
1387 (car (cdr (cdr (cdr poss
))))
1388 (car poss
) start end
)))
1389 (cond ((equal 0 replace
)
1390 (ispell-add-per-file-word-list (car poss
)))
1392 (setq new-word
(if (atom replace
) replace
(car replace
))
1393 cursor-location
(+ (- (length word
) (- end start
))
1395 (if (not (equal new-word
(car poss
)))
1397 (delete-region start end
)
1398 (setq start
(point))
1400 (setq end
(point))))
1401 (if (not (atom replace
)) ;recheck spelling of replacement
1403 (if (car (cdr replace
)) ; query replace requested
1404 (save-window-excursion
1405 (query-replace word new-word t
)))
1407 ;; single word could be split into multiple words
1408 (setq ispell-quit
(not (ispell-region start end
)))
1410 ;; keep if rechecking word and we keep choices win.
1411 (if (get-buffer ispell-choices-buffer
)
1412 (kill-buffer ispell-choices-buffer
))))
1413 (ispell-pdict-save ispell-silently-savep
)
1414 ;; NB: Cancels ispell-quit incorrectly if called from ispell-region
1415 (if ispell-quit
(setq ispell-quit nil replace
'quit
))))
1416 (goto-char cursor-location
) ; return to original location
1420 (defun ispell-get-word (following &optional extra-otherchars
)
1421 "Return the word for spell-checking according to ispell syntax.
1422 If optional argument FOLLOWING is non-nil or if `ispell-following-word'
1423 is non-nil when called interactively, then the following word
1424 \(rather than preceding\) is checked when the cursor is not over a word.
1425 Optional second argument contains otherchars that can be included in word
1428 Word syntax described by `ispell-dictionary-alist' (which see)."
1429 (let* ((ispell-casechars (ispell-get-casechars))
1430 (ispell-not-casechars (ispell-get-not-casechars))
1431 (ispell-otherchars (ispell-get-otherchars))
1432 (ispell-many-otherchars-p (ispell-get-many-otherchars-p))
1433 (word-regexp (concat ispell-casechars
1435 (if (not (string= "" ispell-otherchars
))
1436 (concat ispell-otherchars
"?"))
1437 (if extra-otherchars
1438 (concat extra-otherchars
"?"))
1441 (if (or ispell-many-otherchars-p
1447 (if (not (looking-at ispell-casechars
))
1449 (re-search-forward ispell-casechars
(point-max) t
)
1450 (re-search-backward ispell-casechars
(point-min) t
)))
1451 ;; move to front of word
1452 (re-search-backward ispell-not-casechars
(point-min) 'start
)
1453 (while (and (or (and (not (string= "" ispell-otherchars
))
1454 (looking-at ispell-otherchars
))
1455 (and extra-otherchars
(looking-at extra-otherchars
)))
1457 (or (not did-it-once
)
1458 ispell-many-otherchars-p
)
1459 (not (eq prevpt
(point))))
1460 (if (and extra-otherchars
(looking-at extra-otherchars
))
1463 (if (looking-at ispell-casechars
)
1464 (re-search-backward ispell-not-casechars
(point-min) 'move
)))
1468 (if (looking-at ispell-casechars
)
1469 (re-search-backward ispell-not-casechars
(point-min) 'move
)
1470 (backward-char -
1))))
1471 ;; Now mark the word and save to string.
1472 (if (not (re-search-forward word-regexp
(point-max) t
))
1473 (if ispell-check-only
1474 ;; return dummy word when just flagging misspellings
1475 (list "" (point) (point))
1476 (error "No word found to check!"))
1477 (setq start
(match-beginning 0)
1479 word
(buffer-substring-no-properties start end
))
1480 (list word start end
))))
1483 ;;; Global ispell-pdict-modified-p is set by ispell-command-loop and
1484 ;;; tracks changes in the dictionary. The global may either be
1485 ;;; a value or a list, whose value is the state of whether the
1486 ;;; dictionary needs to be saved.
1489 (defun ispell-pdict-save (&optional no-query force-save
)
1490 "Check to see if the personal dictionary has been modified.
1491 If so, ask if it needs to be saved."
1492 (interactive (list ispell-silently-savep t
))
1493 (if (and ispell-pdict-modified-p
(listp ispell-pdict-modified-p
))
1494 (setq ispell-pdict-modified-p
(car ispell-pdict-modified-p
)))
1495 (if (or ispell-pdict-modified-p force-save
)
1496 (if (or no-query
(y-or-n-p "Personal dictionary modified. Save? "))
1498 (ispell-send-string "#\n") ; save dictionary
1499 (message "Personal dictionary saved."))))
1500 ;; unassert variable, even if not saved to avoid questioning.
1501 (setq ispell-pdict-modified-p nil
))
1504 (defun ispell-command-loop (miss guess word start end
)
1505 "Display possible corrections from list MISS.
1506 GUESS lists possibly valid affix construction of WORD.
1507 Returns nil to keep word.
1508 Returns 0 to insert locally into buffer-local dictionary.
1509 Returns string for new chosen word.
1510 Returns list for new replacement word (will be rechecked).
1511 Query-replace when list length is 2.
1512 Automatic query-replace when second element is `query-replace'.
1513 Highlights the word, which is assumed to run from START to END.
1514 Global `ispell-pdict-modified-p' becomes a list where the only value
1515 indicates whether the dictionary has been modified when option `a' or `i' is
1517 Global `ispell-quit' set to start location to continue spell session."
1519 (line ispell-choices-win-default-height
)
1520 ;; ensure 4 context lines.
1521 (max-lines (- (ispell-adjusted-window-height) 4))
1523 (window-min-height (min window-min-height
1524 ispell-choices-win-default-height
))
1525 (command-characters '( ? ?i ?a ?A ?r ?R ?? ?x ?X ?q ?l ?u ?m
))
1526 (dedicated (window-dedicated-p (selected-window)))
1528 char num result textwin dedicated-win
)
1530 ;; setup the *Choices* buffer with valid data.
1532 (set-buffer (get-buffer-create ispell-choices-buffer
))
1533 (setq mode-line-format
(concat "-- %b -- word: " word
))
1534 ;; XEmacs: prevent thick modeline vs increasing height in overlay-window
1535 ;;(and (fboundp 'set-specifier)
1536 ;; (set-specifier has-modeline-p (cons (current-buffer) nil)))
1540 (insert "Affix rules generate and capitalize "
1541 "this word as shown below:\n\t")
1543 (if (> (+ 4 (current-column) (length (car guess
)))
1547 (setq line
(1+ line
))))
1548 (insert (car guess
) " ")
1549 (setq guess
(cdr guess
)))
1550 (insert "\nUse option `i' if this is a correct composition"
1551 " from the derivative root.\n")
1552 (setq line
(+ line
(if choices
3 2)))))
1554 (< (if (> (+ 7 (current-column) (length (car choices
))
1555 (if (> count ?~
) 3 0))
1559 (setq line
(1+ line
)))
1562 ;; not so good if there are over 20 or 30 options, but then, if
1563 ;; there are that many you don't want to scan them all anyway...
1564 (while (memq count command-characters
) ; skip command characters.
1565 (setq count
(ispell-int-char (1+ count
))
1566 skipped
(1+ skipped
)))
1567 (insert "(" count
") " (car choices
) " ")
1568 (setq choices
(cdr choices
)
1569 count
(ispell-int-char (1+ count
))))
1570 (setq count
(ispell-int-char (- count ?
0 skipped
))))
1572 ;; ensure word is visible
1573 (if (not (pos-visible-in-window-p end
))
1576 ;; allow temporary split of dedicated windows...
1579 (setq dedicated-win
(selected-window))
1580 (set-window-dedicated-p dedicated-win nil
)))
1582 ;; Display choices for misspelled word.
1583 (ispell-show-choices line end
)
1584 (select-window (setq textwin
(next-window)))
1586 ;; highlight word, protecting current buffer status
1589 (and ispell-highlight-p
1590 (ispell-highlight-spelling-error start end t
))
1591 ;; Loop until a valid choice is made.
1599 (let (message-log-max)
1600 (message (concat "C-h or ? for more options; SPC to leave "
1601 "unchanged, Character to replace word")))
1602 (let ((inhibit-quit t
))
1603 (setq char
(if (fboundp 'read-char-exclusive
)
1604 (read-char-exclusive)
1607 (if (or quit-flag
(= char ?\C-g
)) ; C-g is like typing X
1610 ;; Adjust num to array offset skipping command characters.
1611 (let ((com-chars command-characters
))
1613 (if (and (> (car com-chars
) ?
0) (< (car com-chars
) char
))
1614 (setq skipped
(1+ skipped
)))
1615 (setq com-chars
(cdr com-chars
)))
1616 (setq num
(- char ?
0 skipped
)))
1619 ((= char ?
) nil
) ; accept word this time only
1620 ((= char ?i
) ; accept and insert word into pers dict
1621 (ispell-send-string (concat "*" word
"\n"))
1622 (setq ispell-pdict-modified-p
'(t)) ; dictionary modified!
1624 ((or (= char ?a
) (= char ?A
)) ; accept word without insert
1625 (ispell-send-string (concat "@" word
"\n"))
1626 (if (null ispell-pdict-modified-p
)
1627 (setq ispell-pdict-modified-p
1628 (list ispell-pdict-modified-p
)))
1629 (if (= char ?A
) 0)) ; return 0 for ispell-add buffer-local
1630 ((or (= char ?r
) (= char ?R
)) ; type in replacement
1631 (and (eq 'block ispell-highlight-p
) ; refresh tty's
1632 (ispell-highlight-spelling-error start end nil t
))
1634 (if (or (= char ?R
) ispell-query-replace-choices
)
1636 (format "Query-replacement for %s: "word
)
1639 (cons (read-string "Replacement for: " word
)
1641 (and (eq 'block ispell-highlight-p
)
1642 (ispell-highlight-spelling-error start end nil
1645 ((or (= char ??
) (= char help-char
) (= char ?\C-h
))
1646 (and (eq 'block ispell-highlight-p
)
1647 (ispell-highlight-spelling-error start end nil t
))
1649 (and (eq 'block ispell-highlight-p
)
1650 (ispell-highlight-spelling-error start end nil
1653 ;; Quit and move point back.
1655 (ispell-pdict-save ispell-silently-savep
)
1656 (message "Exited spell-checking")
1657 (setq ispell-quit t
)
1659 ;; Quit and preserve point.
1661 (ispell-pdict-save ispell-silently-savep
)
1663 (substitute-command-keys
1664 (concat "Spell-checking suspended;"
1665 " use C-u \\[ispell-word] to resume")))
1666 (setq ispell-quit start
)
1669 (if (y-or-n-p "Really kill Ispell process? ")
1671 (ispell-kill-ispell t
) ; terminate process.
1672 (setq ispell-quit
(or (not ispell-checking-message
)
1674 ispell-pdict-modified-p nil
))
1675 t
)) ; continue if they don't quit.
1677 (and (eq 'block ispell-highlight-p
) ; refresh tty displays
1678 (ispell-highlight-spelling-error start end nil t
))
1679 (let ((new-word (read-string
1680 "Lookup string (`*' is wildcard): "
1685 (set-buffer (get-buffer-create
1686 ispell-choices-buffer
))
1690 mode-line-format
(concat
1693 miss
(lookup-words new-word
)
1695 line ispell-choices-win-default-height
)
1696 (while (and choices
; adjust choices window.
1697 (< (if (> (+ 7 (current-column)
1698 (length (car choices
))
1699 (if (> count ?~
) 3 0))
1703 (setq line
(1+ line
)))
1706 (while (memq count command-characters
)
1707 (setq count
(ispell-int-char (1+ count
))
1708 skipped
(1+ skipped
)))
1709 (insert "(" count
") " (car choices
) " ")
1710 (setq choices
(cdr choices
)
1711 count
(ispell-int-char (1+ count
))))
1712 (setq count
(ispell-int-char
1713 (- count ?
0 skipped
))))
1714 (ispell-show-choices line end
)
1715 (select-window (next-window)))))
1716 (and (eq 'block ispell-highlight-p
)
1717 (ispell-highlight-spelling-error start end nil
1719 t
) ; reselect from new choices
1720 ((= char ?u
) ; insert lowercase into dictionary
1721 (ispell-send-string (concat "*" (downcase word
) "\n"))
1722 (setq ispell-pdict-modified-p
'(t)) ; dictionary modified!
1724 ((= char ?m
) ; type in what to insert
1726 (concat "*" (read-string "Insert: " word
) "\n"))
1727 (setq ispell-pdict-modified-p
'(t))
1729 ((and (>= num
0) (< num count
))
1730 (if ispell-query-replace-choices
; Query replace flag
1731 (list (nth num miss
) 'query-replace
)
1736 ;; This may have alignment errors if current line is edited
1737 (if (marker-position ispell-recursive-edit-marker
)
1739 (message "Only one recursive edit session supported")
1742 (set-marker ispell-recursive-edit-marker start
)
1743 ;;(set-marker ispell-region-end reg-end)
1744 (and ispell-highlight-p
; unhighlight
1745 (ispell-highlight-spelling-error start end
))
1750 (substitute-command-keys
1751 (concat "Exit recursive edit with"
1752 " \\[exit-recursive-edit]")))
1753 (save-window-excursion (save-excursion
1756 (goto-char ispell-recursive-edit-marker
)
1757 (if (not (equal (marker-buffer
1758 ispell-recursive-edit-marker
)
1761 (set-marker ispell-recursive-edit-marker nil
)
1763 "Cannot continue ispell from this buffer.")))
1764 (set-marker ispell-recursive-edit-marker nil
)))
1765 (list word nil
)) ; recheck starting at this word.
1767 (funcall (key-binding "\C-z"))
1772 (and ispell-highlight-p
; unhighlight
1773 (save-window-excursion
1774 (select-window textwin
)
1775 (ispell-highlight-spelling-error start end
)))
1777 (set-window-dedicated-p dedicated-win t
)))))
1781 (defun ispell-show-choices (line end
)
1782 "Shows the choices in another buffer or frame."
1783 (if (and ispell-use-framepop-p
(fboundp 'framepop-display-buffer
))
1785 (framepop-display-buffer (get-buffer ispell-choices-buffer
))
1786 (get-buffer-window ispell-choices-buffer t
)
1787 (select-window (previous-window))) ; *Choices* window
1788 ;; standard selection by splitting a small buffer out of this window.
1789 (let ((choices-window (get-buffer-window ispell-choices-buffer
)))
1791 (if (= line
(ispell-adjusted-window-height choices-window
))
1792 (select-window choices-window
)
1793 ;; *Choices* window changed size. Adjust the choices window
1794 ;; without scrolling the spelled window when possible
1796 (- line
(ispell-adjusted-window-height choices-window
)))
1797 (visible (progn (vertical-motion -
1) (point))))
1798 (if (< line ispell-choices-win-default-height
)
1799 (setq window-line
(+ window-line
1800 (- ispell-choices-win-default-height
1802 (move-to-window-line 0)
1803 (vertical-motion window-line
)
1804 (set-window-start (selected-window)
1805 (if (> (point) visible
) visible
(point)))
1807 (select-window (previous-window)) ; *Choices* window
1808 (enlarge-window window-line
)))
1809 ;; Overlay *Choices* window when it isn't showing
1810 (ispell-overlay-window (max line ispell-choices-win-default-height
)))
1811 (switch-to-buffer ispell-choices-buffer
)
1812 (goto-char (point-min)))))
1816 (defun ispell-help ()
1817 "Display a list of the options available when a misspelling is encountered.
1821 DIGIT: Replace the word with a digit offered in the *Choices* buffer.
1822 SPC: Accept word this time.
1823 `i': Accept word and insert into private dictionary.
1824 `a': Accept word for this session.
1825 `A': Accept word and place in `buffer-local dictionary'.
1826 `r': Replace word with typed-in value. Rechecked.
1827 `R': Replace word with typed-in value. Query-replaced in buffer. Rechecked.
1828 `?': Show these commands.
1829 `x': Exit spelling buffer. Move cursor to original point.
1830 `X': Exit spelling buffer. Leaves cursor at the current point, and permits
1831 the aborted check to be completed later.
1832 `q': Quit spelling session (Kills ispell process).
1833 `l': Look up typed-in replacement in alternate dictionary. Wildcards okay.
1834 `u': Like `i', but the word is lower-cased first.
1835 `m': Place typed-in value in personal dictionary, then recheck current word.
1836 `C-l': redraws screen
1837 `C-r': recursive edit
1838 `C-z': suspend emacs or iconify frame"
1840 (if (equal ispell-help-in-bufferp
'electric
)
1844 (function (lambda ()
1845 ;;This shouldn't be necessary: with-electric-help needs
1846 ;; an optional argument telling it about the smallest
1847 ;; acceptable window-height of the help buffer.
1848 (if (< (window-height) 15)
1850 (- 15 (ispell-adjusted-window-height))))
1851 (princ "Selections are:
1853 DIGIT: Replace the word with a digit offered in the *Choices* buffer.
1854 SPC: Accept word this time.
1855 `i': Accept word and insert into private dictionary.
1856 `a': Accept word for this session.
1857 `A': Accept word and place in `buffer-local dictionary'.
1858 `r': Replace word with typed-in value. Rechecked.
1859 `R': Replace word with typed-in value. Query-replaced in buffer. Rechecked.
1860 `?': Show these commands.
1861 `x': Exit spelling buffer. Move cursor to original point.
1862 `X': Exit spelling buffer. Leaves cursor at the current point, and permits
1863 the aborted check to be completed later.
1864 `q': Quit spelling session (Kills ispell process).
1865 `l': Look up typed-in replacement in alternate dictionary. Wildcards okay.
1866 `u': Like `i', but the word is lower-cased first.
1867 `m': Place typed-in value in personal dictionary, then recheck current word.
1868 `C-l': redraws screen
1869 `C-r': recursive edit
1870 `C-z': suspend emacs or iconify frame")
1871 nil
;undocumented requirement of with-electric-help
1875 (let ((help-1 (concat "[r/R]eplace word; [a/A]ccept for this session; "
1876 "[i]nsert into private dictionary"))
1877 (help-2 (concat "[l]ook a word up in alternate dictionary; "
1878 "e[x/X]it; [q]uit session"))
1879 (help-3 (concat "[u]ncapitalized insert into dict. "
1880 "Type 'x C-h d ispell-help' for more help")))
1881 (save-window-excursion
1882 (if ispell-help-in-bufferp
1884 (ispell-overlay-window 4)
1885 (switch-to-buffer (get-buffer-create "*Ispell Help*"))
1886 (insert (concat help-1
"\n" help-2
"\n" help-3
))
1888 (kill-buffer "*Ispell Help*"))
1889 (select-window (minibuffer-window))
1891 (if (not version18p
) (message nil
))
1892 ;;(set-minibuffer-window (selected-window))
1894 (insert (concat help-1
"\n" help-2
"\n" help-3
))
1899 (defun lookup-words (word &optional lookup-dict
)
1900 "Look up WORD in optional word-list dictionary LOOKUP-DICT.
1901 A `*' serves as a wild card. If no wild cards, `look' is used if it exists.
1902 Otherwise the variable `ispell-grep-command' contains the command used to
1903 search for the words (usually egrep).
1905 Optional second argument contains the dictionary to use; the default is
1906 `ispell-alternate-dictionary'."
1907 ;; We don't use the filter for this function, rather the result is written
1908 ;; into a buffer. Hence there is no need to save the filter values.
1909 (if (null lookup-dict
)
1910 (setq lookup-dict ispell-alternate-dictionary
))
1912 (let* ((process-connection-type ispell-use-ptys-p
)
1913 (wild-p (string-match "\\*" word
))
1914 (look-p (and ispell-look-p
; Only use look for an exact match.
1915 (or ispell-have-new-look
(not wild-p
))))
1916 (ispell-grep-buffer (get-buffer-create "*Ispell-Temp*")) ; result buf
1917 (prog (if look-p ispell-look-command ispell-grep-command
))
1918 (args (if look-p ispell-look-options ispell-grep-options
))
1921 (save-window-excursion
1922 (message "Starting \"%s\" process..." (file-name-nondirectory prog
))
1923 (set-buffer ispell-grep-buffer
)
1927 (insert "^" word
"$")
1928 (while (search-backward "*" nil t
) (insert "."))
1929 (setq word
(buffer-string))
1931 (setq status
(call-process prog nil t nil args word lookup-dict
))
1932 ;; grep returns status 1 and no output when word not found, which
1933 ;; is a perfectly normal thing.
1934 (if (stringp status
)
1935 (setq results
(cons (format "error: %s exited with signal %s"
1936 (file-name-nondirectory prog
) status
)
1938 ;; else collect words into `results' in FIFO order
1939 (goto-char (point-max))
1940 ;; assure we've ended with \n
1941 (or (bobp) (= (preceding-char) ?
\n) (insert ?
\n))
1945 (setq results
(cons (buffer-substring-no-properties (point)
1949 (kill-buffer ispell-grep-buffer
)
1950 (if (and results
(string-match ".+: " (car results
)))
1951 (error "%s error: %s" ispell-grep-command
(car results
))))
1955 ;;; "ispell-filter" is a list of output lines from the generating function.
1956 ;;; Each full line (ending with \n) is a separate item on the list.
1957 ;;; "output" can contain multiple lines, part of a line, or both.
1958 ;;; "start" and "end" are used to keep bounds on lines when "output" contains
1960 ;;; "ispell-filter-continue" is true when we have received only part of a
1961 ;;; line as output from a generating function ("output" did not end with \n)
1962 ;;; THIS FUNCTION WILL FAIL IF THE PROCESS OUTPUT DOESN'T END WITH \n!
1963 ;;; This is the case when a process dies or fails. The default behavior
1964 ;;; in this case treats the next input received as fresh input.
1966 (defun ispell-filter (process output
)
1967 "Output filter function for ispell, grep, and look."
1972 (setq end
(string-match "\n" output start
)) ; get text up to the newline.
1973 ;; If we get out of sync and ispell-filter-continue is asserted when we
1974 ;; are not continuing, treat the next item as a separate list. When
1975 ;; ispell-filter-continue is asserted, ispell-filter *should* always be a
1978 ;; Continue with same line (item)?
1979 (if (and ispell-filter-continue ispell-filter
(listp ispell-filter
))
1980 ;; Yes. Add it to the prev item
1981 (setcar ispell-filter
1982 (concat (car ispell-filter
) (substring output start end
)))
1983 ;; No. This is a new line and item.
1985 (cons (substring output start end
) ispell-filter
)))
1987 ;; We've completed reading the output, but didn't finish the line.
1988 (setq ispell-filter-continue t continue nil
)
1989 ;; skip over newline, this line complete.
1990 (setq ispell-filter-continue nil end
(1+ end
))
1991 (if (= end
(length output
)) ; No more lines in output
1992 (setq continue nil
) ; so we can exit the filter.
1993 (setq start end
)))))) ; else move start to next line of input
1996 ;;; This function destroys the mark location if it is in the word being
1998 (defun ispell-highlight-spelling-error-generic (start end
&optional highlight
2000 "Highlight the word from START to END with a kludge using `inverse-video'.
2001 When the optional third arg HIGHLIGHT is set, the word is highlighted;
2002 otherwise it is displayed normally.
2003 Uses block cursor to highlight one character.
2004 Optional REFRESH will unhighlighted then highlight, using block cursor
2005 highlighting when REFRESH is equal to `block'."
2006 (and (eq 'block ispell-highlight-p
)
2007 (or (eq 'block refresh
)
2008 (setq start
(1+ start
)))) ; On block non-refresh, inc start.
2009 (let ((modified (buffer-modified-p)) ; don't allow this fn to modify buffer
2010 (buffer-read-only nil
) ; Allow highlighting read-only buffers.
2011 (text (buffer-substring-no-properties start end
)) ; Save hilight region
2012 (inhibit-quit t
) ; inhibit interrupt processing here.
2013 (buffer-undo-list t
)) ; don't clutter the undo list.
2015 (delete-region start end
)
2016 (insert-char ?
(- end start
)) ; minimize amount of redisplay
2017 (sit-for 0) ; update display
2018 (if highlight
(setq inverse-video
(not inverse-video
))) ; toggle video
2019 (delete-region start end
) ; delete whitespace
2020 (insert text
) ; insert text in inverse video.
2021 (sit-for 0) ; update display showing inverse video.
2024 (setq inverse-video
(not inverse-video
)) ; toggle video
2025 (and (eq 'block ispell-highlight-p
)
2026 (goto-char (1- start
)))) ; use block cursor to "highlight" char
2027 (set-buffer-modified-p modified
) ; don't modify if flag not set.
2028 (and refresh
; re-highlight
2029 (ispell-highlight-spelling-error-generic
2030 (if (eq 'block refresh
) start
(- start
2)) end t
))))
2033 (defun ispell-highlight-spelling-error-xemacs (start end
&optional highlight
)
2034 "Highlight the word from START to END using `isearch-highlight'.
2035 When the optional third arg HIGHLIGHT is set, the word is highlighted,
2036 otherwise it is displayed normally."
2038 (isearch-highlight start end
)
2039 (isearch-dehighlight t
))
2044 (defun ispell-highlight-spelling-error-overlay (start end
&optional highlight
)
2045 "Highlight the word from START to END using overlays.
2046 When the optional third arg HIGHLIGHT is set, the word is highlighted
2047 otherwise it is displayed normally.
2049 The variable `ispell-highlight-face' selects the face to use for highlighting."
2052 (setq ispell-overlay
(make-overlay start end
))
2053 (overlay-put ispell-overlay
'face ispell-highlight-face
))
2054 (delete-overlay ispell-overlay
)))
2057 (defun ispell-highlight-spelling-error (start end
&optional highlight refresh
)
2060 (ispell-highlight-spelling-error-xemacs start end highlight
))
2061 ((and (not version18p
)
2063 (or (and (fboundp 'display-color-p
) (display-color-p))
2065 (ispell-highlight-spelling-error-overlay start end highlight
))
2066 (t (ispell-highlight-spelling-error-generic start end highlight refresh
))))
2068 (defun ispell-adjusted-window-height (&optional window
)
2069 "Like `window-height', adjusted to correct for the effect of tall mode-lines.
2070 The value returned is actually the nominal number of text-lines in the
2071 window plus 1. On a terminal, this is the same value returned by
2072 `window-height', but if the window has a mode-line is taller than a normal
2073 text line, the returned value may be smaller than that from
2075 (cond ((fboundp 'window-text-height
)
2076 (1+ (window-text-height window
)))
2078 (1- (window-height window
)))
2080 (window-height window
))))
2082 (defun ispell-overlay-window (height)
2083 "Create a window covering the top HEIGHT lines of the current window.
2084 Ensure that the line above point is still visible but otherwise avoid
2085 scrolling the current window. Leave the new window selected."
2087 (let ((oldot (save-excursion (vertical-motion -
1) (point)))
2088 (top (save-excursion (move-to-window-line height
) (point))))
2089 ;; If line above old point (line starting at oldot) would be
2090 ;; hidden by new window, scroll it to just below new win
2091 ;; otherwise set top line of other win so it doesn't scroll.
2092 (if (< oldot top
) (setq top oldot
))
2093 ;; if frame is unsplitable, temporarily disable that...
2094 (if (cdr (assq 'unsplittable
(frame-parameters (selected-frame))))
2095 (let ((frame (selected-frame)))
2096 (modify-frame-parameters frame
'((unsplittable . nil
)))
2097 (split-window nil height
)
2098 (modify-frame-parameters frame
'((unsplittable . t
))))
2099 (split-window nil height
))
2100 (let ((deficit (- height
(ispell-adjusted-window-height))))
2102 ;; Number of lines the window is still too short. We ensure that
2103 ;; there are at least (1- HEIGHT) lines visible in the window.
2104 (enlarge-window deficit
)
2106 (vertical-motion deficit
)
2107 (setq top
(min (point) oldot
))))
2108 (set-window-start (next-window) top
))))
2111 ;;; Should we add a compound word match return value?
2112 (defun ispell-parse-output (output &optional accept-list shift
)
2113 "Parse the OUTPUT string from Ispell process and return:
2114 1: t for an exact match.
2115 2: A string containing the root word matched via suffix removal.
2116 3: A list of possible correct spellings of the format:
2117 (\"ORIGINAL-WORD\" OFFSET MISS-LIST GUESS-LIST)
2118 ORIGINAL-WORD is a string of the possibly misspelled word.
2119 OFFSET is an integer giving the line offset of the word.
2120 MISS-LIST and GUESS-LIST are possibly null lists of guesses and misses.
2121 4: Nil when an error has occurred.
2123 Optional second arg ACCEPT-LIST is list of words already accepted.
2124 Optional third arg SHIFT is an offset to apply based on previous corrections."
2126 ((string= output
"") t
) ; for startup with pipes...
2127 ((string= output
"*") t
) ; exact match
2128 ((string= output
"-") t
) ; compound word match
2129 ((string= (substring output
0 1) "+") ; found because of root word
2130 (substring output
2)) ; return root word
2131 ((equal 0 (string-match "[\ra-zA-Z]" output
))
2132 (ding) ; error message from ispell!
2133 (message (concat "Ispell error: " output
))
2136 (t ; need to process &, ?, and #'s
2137 (let ((type (substring output
0 1)) ; &, ?, or #
2138 (original-word (substring output
2 (string-match " " output
2)))
2139 (cur-count 0) ; contains number of misses + guesses
2140 count miss-list guess-list offset
)
2141 (setq output
(substring output
(match-end 0))) ; skip over misspelling
2142 (if (string= type
"#")
2143 (setq count
0) ; no misses for type #
2144 (setq count
(string-to-int output
) ; get number of misses.
2145 output
(substring output
(1+ (string-match " " output
1)))))
2146 (setq offset
(string-to-int output
))
2147 (if (string= type
"#") ; No miss or guess list.
2149 (setq output
(substring output
(1+ (string-match " " output
1)))))
2151 (let ((end (string-match ", \\|\\($\\)" output
))) ; end of miss/guess.
2152 (setq cur-count
(1+ cur-count
))
2153 (if (> cur-count count
)
2154 (setq guess-list
(cons (substring output
0 end
) guess-list
))
2155 (setq miss-list
(cons (substring output
0 end
) miss-list
)))
2156 (if (match-end 1) ; True only when at end of line.
2157 (setq output nil
) ; no more misses or guesses
2158 (setq output
(substring output
(+ end
2))))))
2159 ;; return results. Accept word if it was already accepted.
2161 (if (member original-word accept-list
)
2164 (if (numberp shift
) (+ shift offset
) offset
)
2165 (nreverse miss-list
) (nreverse guess-list
)))))))
2168 (defun ispell-process-status ()
2169 "Return the status of the Ispell process.
2170 When asynchronous processes are not supported, `run' is always returned."
2171 (if ispell-async-processp
2172 (process-status ispell-process
)
2173 (and ispell-process
'run
)))
2176 (defun ispell-start-process ()
2177 "Start the ispell process, with support for no asynchronous processes.
2178 Keeps argument list for future ispell invocations for no async support."
2180 ;; Local dictionary becomes the global dictionary in use.
2181 (if ispell-local-dictionary
2182 (setq ispell-dictionary ispell-local-dictionary
))
2183 (setq args
(ispell-get-ispell-args))
2184 (if ispell-dictionary
; use specified dictionary
2186 (append (list "-d" ispell-dictionary
) args
)))
2187 (if ispell-personal-dictionary
; use specified pers dict
2191 (expand-file-name ispell-personal-dictionary
)))))
2192 (setq args
(append args ispell-extra-args
))
2194 (if ispell-async-processp
2195 (let ((process-connection-type ispell-use-ptys-p
))
2196 (apply 'start-process
2197 "ispell" nil ispell-program-name
2198 "-a" ; accept single input lines
2199 "-m" ; make root/affix combos not in dict
2201 (setq ispell-cmd-args args
2202 ispell-output-buffer
(generate-new-buffer " *ispell-output*")
2203 ispell-session-buffer
(generate-new-buffer " *ispell-session*"))
2204 (ispell-send-string "\032\n") ; so Ispell prints version and exits
2209 (defun ispell-init-process ()
2210 "Check status of Ispell process and start if necessary."
2211 (if (and ispell-process
2212 (eq (ispell-process-status) 'run
)
2213 ;; If we're using a personal dictionary, ensure
2214 ;; we're in the same default directory!
2215 (or (not ispell-personal-dictionary
)
2216 (equal ispell-process-directory default-directory
)))
2217 (setq ispell-filter nil ispell-filter-continue nil
)
2218 ;; may need to restart to select new personal dictionary.
2219 (ispell-kill-ispell t
)
2220 (message "Starting new Ispell process...")
2222 (check-ispell-version)
2223 (setq ispell-process-directory default-directory
2224 ispell-process
(ispell-start-process)
2226 ispell-filter-continue nil
)
2227 (if ispell-async-processp
2228 (set-process-filter ispell-process
'ispell-filter
))
2229 ;; protect against bogus binding of `enable-multibyte-characters' in XEmacs
2230 (if (and (or xemacsp
2231 (and (boundp 'enable-multibyte-characters
)
2232 enable-multibyte-characters
))
2233 (fboundp 'set-process-coding-system
))
2234 (set-process-coding-system ispell-process
(ispell-get-coding-system)
2235 (ispell-get-coding-system)))
2236 ;; Get version ID line
2237 (if (not version18p
)
2238 (ispell-accept-output 3)
2239 (ispell-accept-output))
2240 ;; get more output if filter empty?
2241 (if (null ispell-filter
) (ispell-accept-output 3))
2242 (cond ((null ispell-filter
)
2243 (error "%s did not output version line" ispell-program-name
))
2245 (stringp (car ispell-filter
))
2246 (if (string-match "warning: " (car ispell-filter
))
2248 (if (not version18p
)
2249 (ispell-accept-output 3) ; was warn msg.
2250 (ispell-accept-output))
2251 (stringp (car ispell-filter
)))
2252 (null (cdr ispell-filter
)))
2253 (string-match "^@(#) " (car ispell-filter
)))
2254 ;; got the version line as expected (we already know it's the right
2255 ;; version, so don't bother checking again.)
2258 ;; Otherwise, it must be an error message. Show the user.
2259 ;; But first wait to see if some more output is going to arrive.
2260 ;; Otherwise we get cool errors like "Can't open ".
2262 (ispell-accept-output 3)
2263 (error "%s" (mapconcat 'identity ispell-filter
"\n"))))
2264 (setq ispell-filter nil
) ; Discard version ID line
2265 (let ((extended-char-mode (ispell-get-extended-character-mode)))
2266 (if extended-char-mode
; ~ extended character mode
2267 (ispell-send-string (concat extended-char-mode
"\n"))))
2268 (if ispell-async-processp
2269 (process-kill-without-query ispell-process
))))
2272 (defun ispell-kill-ispell (&optional no-error
)
2273 "Kill current Ispell process (so that you may start a fresh one).
2274 With NO-ERROR, just return non-nil if there was no Ispell running."
2276 (if (not (and ispell-process
2277 (eq (ispell-process-status) 'run
)))
2279 (error "There is no ispell process running!"))
2280 (if ispell-async-processp
2282 (process-send-eof ispell-process
)
2283 (if (eq (ispell-process-status) 'run
)
2284 (ispell-accept-output 1))
2285 (if (eq (ispell-process-status) 'run
)
2286 (kill-process ispell-process
))
2287 (while (not (or (eq (ispell-process-status) 'exit
)
2288 (eq (ispell-process-status) 'signal
)))
2289 (if (or xemacsp version20p
) (sleep-for 0.25)
2290 (sleep-for 0 250))))
2291 ;; synchronous processes
2292 (ispell-send-string "\n") ; make sure side effects occurred.
2293 (kill-buffer ispell-output-buffer
)
2294 (kill-buffer ispell-session-buffer
)
2295 (setq ispell-output-buffer nil
2296 ispell-session-buffer nil
))
2297 (setq ispell-process nil
)
2298 (message "Ispell process killed")
2302 ;;; ispell-change-dictionary is set in some people's hooks. Maybe this should
2303 ;;; call ispell-init-process rather than wait for a spell checking command?
2306 (defun ispell-change-dictionary (dict &optional arg
)
2307 "Change `ispell-dictionary' (q.v.) to DICT and kill old Ispell process.
2308 A new one will be started as soon as necessary.
2310 By just answering RET you can find out what the current dictionary is.
2312 With prefix argument, set the default dictionary."
2314 (list (completing-read
2315 "Use new dictionary (RET for current, SPC to complete): "
2316 (cons (cons "default" nil
) ispell-dictionary-alist
) nil t
)
2317 current-prefix-arg
))
2318 (if (equal dict
"default") (setq dict nil
))
2319 ;; This relies on completing-read's bug of returning "" for no match
2320 (cond ((equal dict
"")
2321 (message "Using %s dictionary"
2322 (or ispell-local-dictionary ispell-dictionary
"default")))
2323 ((and (equal dict ispell-dictionary
)
2324 (or (null ispell-local-dictionary
)
2325 (equal dict ispell-local-dictionary
)))
2326 ;; Specified dictionary is the default already. No-op
2327 (and (interactive-p)
2328 (message "No change, using %s dictionary" (or dict
"default"))))
2329 (t ; reset dictionary!
2330 (if (assoc dict ispell-dictionary-alist
)
2332 (if (or arg
(null dict
)) ; set default dictionary
2333 (setq ispell-dictionary dict
))
2334 (if (null arg
) ; set local dictionary
2335 (setq ispell-local-dictionary dict
)))
2336 (error "Undefined dictionary: %s" dict
))
2337 (ispell-kill-ispell t
)
2338 (message "(Next %sIspell command will use %s dictionary)"
2339 (cond ((equal ispell-local-dictionary ispell-dictionary
)
2343 (or (if (or (equal ispell-local-dictionary ispell-dictionary
)
2345 ispell-local-dictionary
2350 ;;; Spelling of comments are checked when ispell-check-comments is non-nil.
2353 (defun ispell-region (reg-start reg-end
&optional recheckp shift
)
2354 "Interactively check a region for spelling errors.
2355 Return nil if spell session is quit,
2356 otherwise returns shift offset amount for last line processed."
2357 (interactive "r") ; Don't flag errors on read-only bufs.
2359 (ispell-accept-buffer-local-defs)) ; set up dictionary, local words, etc.
2362 (message "Spell checking %s using %s dictionary..."
2363 (if (and (= reg-start
(point-min)) (= reg-end
(point-max)))
2364 (buffer-name) "region")
2365 (or ispell-dictionary
"default"))
2366 ;; Returns cursor to original location.
2367 (save-window-excursion
2368 (goto-char reg-start
)
2369 (let ((transient-mark-mode)
2370 (case-fold-search case-fold-search
)
2371 (skip-region-start (make-marker))
2372 (skip-regexp (ispell-begin-skip-region-regexp))
2373 (skip-alist ispell-skip-region-alist
)
2375 (if (eq ispell-parser
'tex
)
2376 (setq case-fold-search nil
2378 (append (car ispell-tex-skip-alists
)
2379 (car (cdr ispell-tex-skip-alists
))
2381 (let (message-log-max)
2382 (message "searching for regions to skip"))
2383 (if (re-search-forward skip-regexp reg-end t
)
2385 (setq key
(buffer-substring-no-properties
2386 (match-beginning 0) (match-end 0)))
2387 (set-marker skip-region-start
(- (point) (length key
)))
2388 (goto-char reg-start
)))
2389 (let (message-log-max)
2390 (message "Continuing spelling check using %s dictionary..."
2391 (or ispell-dictionary
"default")))
2392 (set-marker ispell-region-end reg-end
)
2393 (while (and (not ispell-quit
)
2394 (< (point) ispell-region-end
))
2395 ;; spell-check region with skipping
2396 (if (and (marker-position skip-region-start
)
2397 (<= skip-region-start
(point)))
2399 (ispell-skip-region key skip-alist
) ; moves pt past region.
2400 (setq reg-start
(point))
2401 (if (and (< reg-start ispell-region-end
)
2402 (re-search-forward skip-regexp
2403 ispell-region-end t
))
2405 (setq key
(buffer-substring-no-properties
2407 (car (cdr (match-data)))))
2408 (set-marker skip-region-start
2409 (- (point) (length key
)))
2410 (goto-char reg-start
))
2411 (set-marker skip-region-start nil
))))
2412 (setq reg-end
(if (marker-position skip-region-start
)
2413 (min skip-region-start ispell-region-end
)
2414 (marker-position ispell-region-end
)))
2415 (let* ((start (point))
2416 (end (save-excursion (end-of-line) (min (point) reg-end
)))
2417 (string (ispell-get-line start end reg-end
)))
2418 (setq end
(point)) ; "end" tracks region retrieved.
2419 (if string
; there is something to spell check!
2420 ;; (special start end)
2421 (setq shift
(ispell-process-line string
2422 (and recheckp shift
))))
2428 (if (and (not (and recheckp ispell-keep-choices-win
))
2429 (get-buffer ispell-choices-buffer
))
2430 (kill-buffer ispell-choices-buffer
))
2433 ;; preserve or clear the region for ispell-continue.
2434 (if (not (numberp ispell-quit
))
2435 (set-marker ispell-region-end nil
)
2436 ;; Ispell-continue enabled - ispell-region-end is set.
2437 (goto-char ispell-quit
))
2438 ;; Check for aborting
2439 (if (and ispell-checking-message
(numberp ispell-quit
))
2441 (setq ispell-quit nil
)
2442 (error "Message send aborted")))
2443 (if (not recheckp
) (setq ispell-quit nil
)))
2444 (if (not recheckp
) (set-marker ispell-region-end nil
))
2445 ;; Only save if successful exit.
2446 (ispell-pdict-save ispell-silently-savep
)
2447 (message "Spell-checking done"))))
2450 ;;; Creates the regexp for skipping a region.
2451 ;;; Makes the skip-regexp local for tex buffers adding in the
2452 ;;; tex expressions to skip as well.
2453 ;;; Call AFTER ispell-buffer-local-parsing.
2454 (defun ispell-begin-skip-region-regexp ()
2455 (let ((skip-regexp (ispell-begin-skip-region)))
2456 (if (and (null ispell-check-comments
) comment-start
)
2457 (setq skip-regexp
(concat (regexp-quote comment-start
) "\\|"
2459 (if (and (eq 'exclusive ispell-check-comments
) comment-start
)
2460 (setq skip-regexp
(concat (if (string= "" comment-end
) "^"
2461 (regexp-quote comment-end
))
2462 "\\|" skip-regexp
)))
2464 (setq skip-regexp
(concat ispell-tib-ref-beginning
"\\|" skip-regexp
)))
2465 (if ispell-skip-html
2466 (setq skip-regexp
(concat "<[cC][oO][dD][eE]\\>[^>]*>" "\\|"
2467 "<[sS][cC][rR][iI][pP][tT]\\>[^>]*>" "\\|"
2468 "<[aA][pP][pP][lL][eE][tT]\\>[^>]*>" "\\|"
2469 "<[vV][eE][rR][bB]\\>[^>]*>" "\\|"
2470 ;; "<[tT][tT]\\>[^>]*>" "\\|"
2475 (if (eq ispell-parser
'tex
)
2476 (setq skip-regexp
(concat (ispell-begin-tex-skip-regexp) "\\|"
2481 (defun ispell-begin-tex-skip-regexp ()
2482 "Regular expression of tex commands to skip.
2483 Generated from `ispell-tex-skip-alists'."
2485 (mapconcat (function (lambda (lst) (car lst
)))
2486 (car ispell-tex-skip-alists
)
2489 (mapconcat (function (lambda (lst)
2490 (concat "\\\\begin[ \t\n]*{[ \t\n]*"
2493 (car (cdr ispell-tex-skip-alists
))
2497 (defun ispell-begin-skip-region ()
2498 "Regular expression of regions to skip for all buffers.
2499 Each selection should be a key of `ispell-skip-region-alist';
2500 otherwise, the current line is skipped."
2501 (mapconcat (function (lambda (lst) (if (stringp (car lst
)) (car lst
)
2503 ispell-skip-region-alist
2507 (defun ispell-tex-arg-end (&optional arg
)
2510 (while (looking-at "[ \t\n]*\\[") (forward-sexp))
2511 (forward-sexp (or arg
1)))
2513 (message "error skipping s-expressions at point %d." (point))
2518 ;;; Skips to region-end from point, or a single line.
2519 ;;; Places point at end of region skipped.
2520 (defun ispell-skip-region (key alist
)
2521 ;; move over key to begin checking.
2522 (forward-char (length key
))
2523 (let ((start (point))
2524 alist-key null-skip
)
2526 ;; what about quoted comment, or comment inside strings?
2527 ((and (null ispell-check-comments
) comment-start
2528 (string= key comment-start
))
2529 (if (string= "" comment-end
)
2531 (search-forward comment-end ispell-region-end t
)))
2532 ((and (eq 'exclusive ispell-check-comments
) comment-start
2533 (string= key comment-end
))
2534 (search-forward comment-start ispell-region-end
:end
))
2535 ((and ispell-skip-tib
(string-match ispell-tib-ref-beginning key
))
2536 (re-search-forward ispell-tib-ref-end ispell-region-end t
))
2537 ((and ispell-skip-html
(string-match "</" key
))
2538 (search-forward ">" ispell-region-end t
))
2539 ((and ispell-skip-html
(string-match "<[cC][oO][dD][eE]\\>[^>]*>" key
))
2540 (search-forward-regexp "</[cC][oO][dD][eE]>" ispell-region-end t
))
2541 ((and ispell-skip-html
2542 (string-match "<[sS][cC][rR][iI][pP][tT]\\>[^>]*>" key
))
2543 (search-forward-regexp "</[sS][cC][rR][iI][pP][tT]>" ispell-region-end t
))
2544 ((and ispell-skip-html
2545 (string-match "<[aA][pP][pP][lL][eE][tT]\\>[^>]*>" key
))
2546 (search-forward-regexp "</[aA][pP][pP][lL][eE][tT]>" ispell-region-end t
))
2547 ((and ispell-skip-html
(string-match "<[vV][eE][rR][bB]\\>[^>]*>" key
))
2548 (search-forward-regexp "</[vV][eE][rR][bB]>" ispell-region-end t
))
2549 ;;((and ispell-skip-html (string-match "<[tT][tT]\\>[^>]*>" key))
2550 ;; (search-forward-regexp "</[tT][tT]>" ispell-region-end t))
2551 ((and ispell-skip-html
(string-match "<[tT][tT]/" key
))
2552 (search-forward "/" ispell-region-end t
))
2553 ((and ispell-skip-html
(string-match "<" key
))
2554 (search-forward ">" ispell-region-end t
))
2555 ((and ispell-skip-html
(string-match "&" key
))
2556 (search-forward-regexp "[; \t\n]" ispell-region-end t
))
2557 ;; markings from alist
2560 (setq alist-key
(eval (car (car alist
))))
2561 (if (string-match alist-key key
)
2563 (setq alist
(cdr (car alist
)))
2565 ((null alist
) (setq null-skip t
)) ; done! Just skip key.
2566 ((not (consp alist
))
2567 ;; Search past end of spell region to find this region end.
2568 (re-search-forward (eval alist
) (point-max) t
))
2571 (re-search-forward alist
(point-max) t
)
2572 (setq null-skip t
) ; error handling in functions!
2573 (if (consp (cdr alist
))
2574 (apply (car alist
) (cdr alist
))
2575 (funcall (car alist
))))))
2577 (setq alist
(cdr alist
))))))
2578 (if (and (= start
(point)) (null null-skip
))
2580 (message "Matching region end for `%s' point %d not found"
2586 ;;; Grab the next line of data.
2587 ;;; Returns a string with the line data
2588 (defun ispell-get-line (start end reg-end
)
2589 (let ((ispell-casechars (ispell-get-casechars))
2591 (cond ; LOOK AT THIS LINE AND SKIP OR PROCESS
2592 ((eolp) ; END OF LINE, just go to next line.
2594 ;;((looking-at "[-#@*+!%~^]") ; SKIP SPECIAL ISPELL CHARACTERS
2595 ;; (forward-char 1)) ; not needed as quoted below.
2596 ((or (re-search-forward ispell-casechars end t
) ; TEXT EXISTS
2597 (re-search-forward "[][()${}]" end t
)) ; or MATH COMMANDS
2598 (setq string
(concat "^" (buffer-substring-no-properties start end
)
2601 (t (goto-char end
))) ; EMPTY LINE, skip it.
2605 ;;; Avoid error messages when compiling for these dynamic variables.
2610 (defun ispell-process-line (string shift
)
2611 "Sends a LINE of text to ispell and processes the result.
2612 This will modify the buffer for spelling errors.
2613 Requires variables START and END to be defined in its lexical scope.
2614 Returns the sum shift due to changes in word replacements."
2615 ;;(declare special start end)
2616 (let (poss accept-list
)
2617 (if (not (numberp shift
))
2619 ;; send string to spell process and get input.
2620 (ispell-send-string string
)
2622 (ispell-accept-output)
2623 ;; Last item of output contains a blank line.
2624 (not (string= "" (car ispell-filter
)))))
2625 ;; parse all inputs from the stream one word at a time.
2626 ;; Place in FIFO order and remove the blank item.
2627 (setq ispell-filter
(nreverse (cdr ispell-filter
)))
2628 (while (and (not ispell-quit
) ispell-filter
)
2629 ;; get next word, accounting for accepted words and start shifts
2630 (setq poss
(ispell-parse-output (car ispell-filter
)
2632 (if (and poss
(listp poss
)) ; spelling error occurred.
2633 ;; Whenever we have misspellings, we can change
2634 ;; the buffer. Keep boundaries as markers.
2635 ;; Markers can move with highlighting! This destroys
2636 ;; end of region markers line-end and ispell-region-end
2638 (copy-marker (+ start ispell-offset
(car (cdr poss
)))))
2639 (word-len (length (car poss
)))
2640 (line-end (copy-marker end
))
2641 (line-start (copy-marker start
))
2642 recheck-region replace
)
2643 (goto-char word-start
)
2644 ;; Adjust the horizontal scroll & point
2645 (ispell-horiz-scroll)
2646 (goto-char (+ word-len word-start
))
2647 (ispell-horiz-scroll)
2648 (goto-char word-start
)
2649 (ispell-horiz-scroll)
2651 ;; Alignment cannot be tracked and this error will occur when
2652 ;; `query-replace' makes multiple corrections on the starting line.
2653 (if (/= (+ word-len
(point))
2655 ;; NB: Search can fail with Mule character sets that don't
2656 ;; display properly. Ignore the error in this case?
2657 (search-forward (car poss
) (+ word-len
(point)) t
)
2659 ;; This occurs due to filter pipe problems
2660 (error (concat "Ispell misalignment: word "
2661 "`%s' point %d; probably incompatible versions")
2662 (car poss
) (marker-position word-start
)))
2663 ;; ispell-cmd-loop can go recursive & change buffer
2664 (if ispell-keep-choices-win
2665 (setq replace
(ispell-command-loop
2666 (car (cdr (cdr poss
)))
2667 (car (cdr (cdr (cdr poss
))))
2668 (car poss
) (marker-position word-start
)
2669 (+ word-len
(marker-position word-start
))))
2670 (save-window-excursion
2671 (setq replace
(ispell-command-loop
2672 (car (cdr (cdr poss
)))
2673 (car (cdr (cdr (cdr poss
))))
2674 (car poss
) (marker-position word-start
)
2675 (+ word-len
(marker-position word-start
))))))
2677 (goto-char word-start
)
2678 ;; Recheck when query replace edit changes misspelled word.
2679 ;; Error in tex mode when a potential math mode change exists.
2680 (if (and replace
(listp replace
) (= 2 (length replace
)))
2681 (if (and (eq ispell-parser
'tex
)
2682 (string-match "[\\\\][]()[]\\|\\\\begin\\|\\$"
2683 (regexp-quote string
)))
2685 "Don't start query replace on a line with math characters"
2687 (set-marker line-end
(point))
2688 (setq ispell-filter nil
2691 ;; insert correction if needed
2694 (equal 0 replace
)) ; ACCEPT/INSERT
2695 (if (equal 0 replace
) ; BUFFER-LOCAL DICT ADD
2696 (ispell-add-per-file-word-list (car poss
)))
2697 ;; do not recheck accepted word on this line
2698 (setq accept-list
(cons (car poss
) accept-list
)))
2699 (t ; replacement word selected or entered
2700 (delete-region (point) (+ word-len
(point)))
2701 (if (not (listp replace
))
2703 (insert replace
) ; insert dictionary word
2704 (setq accept-list
(cons replace accept-list
)))
2705 (let ((replace-word (car replace
)))
2706 ;; Recheck hand entered replacement word
2707 (insert replace-word
)
2708 (if (car (cdr replace
))
2709 (save-window-excursion
2710 (delete-other-windows) ; to correctly show help.
2711 ;; Assume case-replace &
2712 ;; case-fold-search correct?
2713 (query-replace (car poss
) (car replace
) t
)))
2714 (goto-char word-start
)
2715 ;; do not recheck if already accepted
2716 (if (member replace-word accept-list
)
2717 (setq accept-list
(cons replace-word accept-list
)
2718 replace replace-word
)
2719 (let ((region-end (copy-marker ispell-region-end
)))
2720 (setq recheck-region ispell-filter
2721 ispell-filter nil
; save filter
2722 shift
0 ; already accounted
2723 shift
(ispell-region
2725 (+ word-start
(length replace-word
))
2727 (if (null shift
) ; quitting check.
2729 (set-marker ispell-region-end region-end
)
2730 (set-marker region-end nil
)
2731 (setq ispell-filter recheck-region
2733 replace replace-word
)))))
2735 (setq shift
(+ shift
(- (length replace
) word-len
)))
2737 ;; Move line-start across word...
2738 ;; new shift function does this now...
2739 ;;(set-marker line-start (+ line-start
2740 ;; (- (length replace)
2741 ;; (length (car poss)))))
2743 (if (not ispell-quit
)
2744 (let (message-log-max)
2745 (message "Continuing spelling check using %s dictionary..."
2746 (or ispell-dictionary
"default"))))
2748 (setq start
(marker-position line-start
)
2749 end
(marker-position line-end
))
2750 ;; Adjust markers when end of region lost from highlighting.
2751 (if (and (not recheck-region
) (< end
(+ word-start word-len
)))
2752 (setq end
(+ word-start word-len
)))
2753 (if (= word-start ispell-region-end
)
2754 (set-marker ispell-region-end
(+ word-start word-len
)))
2755 ;; going out of scope - unneeded
2756 (set-marker line-start nil
)
2757 (set-marker word-start nil
)
2758 (set-marker line-end nil
)))
2759 ;; finished with misspelling!
2760 (setq ispell-filter
(cdr ispell-filter
)))
2765 (defun ispell-comments-and-strings ()
2766 "Check comments and strings in the current buffer for spelling errors."
2768 (goto-char (point-min))
2772 (setq state
(parse-partial-sexp (point) (point-max)
2773 nil nil state
'syntax-table
))
2774 (if (or (nth 3 state
) (nth 4 state
))
2775 (let ((start (point)))
2776 (setq state
(parse-partial-sexp start
(point-max)
2777 nil nil state
'syntax-table
))
2778 (if (or (nth 3 state
) (nth 4 state
))
2779 (error "Unterminated string or comment"))
2781 (setq done
(not (ispell-region start
(point))))))))))
2785 (defun ispell-buffer ()
2786 "Check the current buffer for spelling errors interactively."
2788 (ispell-region (point-min) (point-max)))
2792 (defun ispell-continue ()
2793 "Continue a halted spelling session beginning with the current word."
2795 (if (not (marker-position ispell-region-end
))
2796 (message "No session to continue. Use 'X' command when checking!")
2797 (if (not (equal (marker-buffer ispell-region-end
) (current-buffer)))
2798 (message "Must continue ispell from buffer %s"
2799 (buffer-name (marker-buffer ispell-region-end
)))
2801 ;; find beginning of current word:
2802 (car (cdr (ispell-get-word t
)))
2803 (marker-position ispell-region-end
)))))
2806 ;;; Horizontal scrolling
2807 (defun ispell-horiz-scroll ()
2808 "Places point within the horizontal visibility of its window area."
2809 (if truncate-lines
; display truncating lines?
2810 ;; See if display needs to be scrolled.
2811 (let ((column (- (current-column) (max (window-hscroll) 1))))
2812 (if (and (< column
0) (> (window-hscroll) 0))
2813 (scroll-right (max (- column
) 10))
2814 (if (>= column
(- (window-width) 2))
2815 (scroll-left (max (- column
(window-width) -
3) 10)))))))
2818 ;;; Interactive word completion.
2819 ;;; Forces "previous-word" processing. Do we want to make this selectable?
2822 (defun ispell-complete-word (&optional interior-frag
)
2823 "Try to complete the word before or under point (see `lookup-words')
2824 If optional INTERIOR-FRAG is non-nil then the word may be a character
2825 sequence inside of a word.
2827 Standard ispell choices are then available."
2829 (let ((cursor-location (point))
2830 (case-fold-search-val case-fold-search
)
2831 (word (ispell-get-word nil
"\\*")) ; force "previous-word" processing.
2832 start end possibilities replacement
)
2833 (setq start
(car (cdr word
))
2834 end
(car (cdr (cdr word
)))
2837 (or (string= word
"") ; Will give you every word
2838 (lookup-words (concat (and interior-frag
"*") word
2839 (if (or interior-frag
(null ispell-look-p
))
2841 ispell-complete-word-dict
)))
2842 (cond ((eq possibilities t
)
2843 (message "No word to complete"))
2844 ((null possibilities
)
2845 (message "No match for \"%s\"" word
))
2846 (t ; There is a modification...
2847 (setq case-fold-search nil
) ; Try and respect case of word.
2849 ((string-equal (upcase word
) word
)
2850 (setq possibilities
(mapcar 'upcase possibilities
)))
2851 ((string-equal (upcase (substring word
0 1)) (substring word
0 1))
2852 (setq possibilities
(mapcar (function
2855 (substring word
0 1)
2856 (substring pos
0 1))
2860 (setq case-fold-search case-fold-search-val
)
2861 (save-window-excursion
2863 (ispell-command-loop possibilities nil word start end
)))
2865 ((equal 0 replacement
) ; BUFFER-LOCAL ADDITION
2866 (ispell-add-per-file-word-list word
))
2867 (replacement ; REPLACEMENT WORD
2868 (delete-region start end
)
2869 (setq word
(if (atom replacement
) replacement
(car replacement
))
2870 cursor-location
(+ (- (length word
) (- end start
))
2873 (if (not (atom replacement
)) ; recheck spelling of replacement.
2875 (goto-char cursor-location
)
2876 (ispell-word nil t
)))))
2877 (if (get-buffer ispell-choices-buffer
)
2878 (kill-buffer ispell-choices-buffer
))))
2879 (ispell-pdict-save ispell-silently-savep
)
2880 (goto-char cursor-location
)))
2884 (defun ispell-complete-word-interior-frag ()
2885 "Completes word matching character sequence inside a word."
2887 (ispell-complete-word t
))
2892 "Interactively check a region or buffer for spelling errors.
2893 If `transient-mark-mode' is on, and a region is active, spell-check
2894 that region. Otherwise spell-check the buffer.
2896 Ispell dictionaries are not distributed with Emacs. If you are
2897 looking for a dictionary, please see the distribution of the GNU ispell
2898 program, or do an Internet search; there are various dictionaries
2899 available on the net."
2901 (if (and transient-mark-mode mark-active
)
2902 (ispell-region (region-beginning) (region-end))
2906 ;;; **********************************************************************
2907 ;;; Ispell Minor Mode
2908 ;;; **********************************************************************
2910 (defvar ispell-minor-mode nil
2911 "Non-nil if Ispell minor mode is enabled.")
2912 ;; Variable indicating that ispell minor mode is active.
2913 (make-variable-buffer-local 'ispell-minor-mode
)
2915 (or (assq 'ispell-minor-mode minor-mode-alist
)
2916 (setq minor-mode-alist
2917 (cons '(ispell-minor-mode " Spell") minor-mode-alist
)))
2919 (defvar ispell-minor-keymap
2920 (let ((map (make-sparse-keymap)))
2921 (define-key map
" " 'ispell-minor-check
)
2922 (define-key map
"\r" 'ispell-minor-check
)
2924 "Keymap used for Ispell minor mode.")
2926 (or (not (boundp 'minor-mode-map-alist
))
2927 (assoc 'ispell-minor-mode minor-mode-map-alist
)
2928 (setq minor-mode-map-alist
2929 (cons (cons 'ispell-minor-mode ispell-minor-keymap
)
2930 minor-mode-map-alist
)))
2933 (defun ispell-minor-mode (&optional arg
)
2934 "Toggle Ispell minor mode.
2935 With prefix arg, turn Ispell minor mode on iff arg is positive.
2937 In Ispell minor mode, pressing SPC or RET
2938 warns you if the previous word is incorrectly spelled.
2940 All the buffer-local variables and dictionaries are ignored -- to read
2941 them into the running ispell process, type \\[ispell-word] SPC."
2943 (setq ispell-minor-mode
2944 (not (or (and (null arg
) ispell-minor-mode
)
2945 (<= (prefix-numeric-value arg
) 0))))
2946 (force-mode-line-update))
2948 (defun ispell-minor-check ()
2949 "Check previous word then continue with the normal binding of this key.
2950 Don't check previous word when character before point is a space or newline.
2951 Don't read buffer-local settings or word lists."
2953 (let ((ispell-minor-mode nil
)
2954 (ispell-check-only t
)
2955 (last-char (char-after (1- (point)))))
2956 (command-execute (key-binding (this-command-keys)))
2957 (if (not (or (eq last-char ?\
) (eq last-char ?
\n)
2958 (and ispell-skip-html
(eq last-char ?
>))
2959 (and ispell-skip-html
(eq last-char ?\
;))))
2960 (ispell-word nil t
))))
2963 ;;; **********************************************************************
2965 ;;; **********************************************************************
2966 ;;; Original from D. Quinlan, E. Bradford, A. Albert, and M. Ernst
2969 (defvar ispell-message-text-end
2970 (mapconcat (function identity
)
2972 ;; Don't spell check signatures
2974 ;; Matches postscript files.
2975 "^%!PS-Adobe-[123].0"
2976 ;; Matches uuencoded text
2977 "^begin [0-9][0-9][0-9] .*\nM.*\nM.*\nM"
2978 ;; Matches shell files (especially auto-decoding)
2980 ;; Matches context difference listing
2981 "\\(\\(^cd .*\n\\)?diff -c .*\\)?\n\\*\\*\\* .*\n--- .*\n\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*"
2982 ;; Matches unidiff difference listing
2983 "\\(diff -u .*\\)?\n--- .*\n\\+\\+\\+ .*\n@@ [-+][0-9]+,[0-9]+ [-+][0-9]+,[0-9]+ @@\n"
2984 ;; Matches reporter.el bug report
2985 "^current state:\n==============\n"
2986 ;; Matches commonly used "cut" boundaries
2987 "^\\(- \\)?[-=_]+\\s ?\\(cut here\\|Environment Follows\\)")
2989 "*End of text which will be checked in `ispell-message'.
2990 If it is a string, limit at first occurrence of that regular expression.
2991 Otherwise, it must be a function which is called to get the limit.")
2996 (defun ispell-message ()
2997 "Check the spelling of a mail message or news post.
2998 Don't check spelling of message headers except the Subject field.
2999 Don't check included messages.
3001 To abort spell checking of a message region and send the message anyway,
3002 use the `x' command. (Any subsequent regions will be checked.)
3003 The `X' command aborts the message send so that you can edit the buffer.
3005 To spell-check whenever a message is sent, include the appropriate lines
3006 in your .emacs file:
3007 (add-hook 'message-send-hook 'ispell-message) ;; GNUS 5
3008 (add-hook 'news-inews-hook 'ispell-message) ;; GNUS 4
3009 (add-hook 'mail-send-hook 'ispell-message)
3010 (add-hook 'mh-before-send-letter-hook 'ispell-message)
3012 You can bind this to the key C-c i in GNUS or mail by adding to
3013 `news-reply-mode-hook' or `mail-mode-hook' the following lambda expression:
3014 (function (lambda () (local-set-key \"\\C-ci\" 'ispell-message)))"
3017 (goto-char (point-min))
3019 ;; Nil when message came from outside (eg calling emacs as editor)
3020 ;; Non-nil marker of end of headers.
3023 (concat "^" (regexp-quote mail-header-separator
) "$") nil t
))
3024 (end-of-headers ; Start of body.
3026 (or internal-messagep
3027 (re-search-forward "^$" nil t
)
3029 (limit (copy-marker ; End of region we will spell check.
3031 ((not ispell-message-text-end
) (point-max))
3032 ((char-or-string-p ispell-message-text-end
)
3033 (if (re-search-forward ispell-message-text-end nil t
)
3036 (t (min (point-max) (funcall ispell-message-text-end
))))))
3037 (default-prefix ; Vanilla cite prefix (just used for cite-regexp)
3038 (if (and (boundp 'mail-yank-prefix
) mail-yank-prefix
)
3039 (ispell-non-empty-string mail-yank-prefix
)
3041 (cite-regexp ;Prefix of quoted text
3043 ((functionp 'sc-cite-regexp
) ; sc 3.0
3044 (concat "\\(" (sc-cite-regexp) "\\)" "\\|"
3045 (ispell-non-empty-string sc-reference-tag-string
)))
3046 ((boundp 'sc-cite-regexp
) ; sc 2.3
3047 (concat "\\(" sc-cite-regexp
"\\)" "\\|"
3048 (ispell-non-empty-string sc-reference-tag-string
)))
3049 ((or (equal major-mode
'news-reply-mode
) ;GNUS 4 & below
3050 (equal major-mode
'message-mode
)) ;GNUS 5
3051 (concat "In article <" "\\|"
3052 "[^,;&+=\n]+ <[^,;&+=]+> writes:" "\\|"
3053 message-yank-prefix
"\\|"
3055 ((equal major-mode
'mh-letter-mode
) ; mh mail message
3056 (concat "[^,;&+=\n]+ writes:" "\\|"
3057 (ispell-non-empty-string mh-ins-buf-prefix
)))
3058 ((not internal-messagep
) ; Assume nn sent us this message.
3059 (concat "In [a-zA-Z.]+ you write:" "\\|"
3060 "In <[^,;&+=]+> [^,;&+=]+ writes:" "\\|"
3062 ((boundp 'vm-included-text-prefix
) ; VM mail message
3063 (concat "[^,;&+=\n]+ writes:" "\\|"
3064 (ispell-non-empty-string vm-included-text-prefix
)))
3065 (t default-prefix
)))
3066 (ispell-skip-region-alist
3067 (cons (list (concat "^\\(" cite-regexp
"\\)")
3068 (function forward-line
))
3069 ispell-skip-region-alist
))
3070 (old-case-fold-search case-fold-search
)
3071 (dictionary-alist ispell-message-dictionary-alist
)
3072 (ispell-checking-message t
))
3074 ;; Select dictionary for message
3075 (or (local-variable-p 'ispell-local-dictionary
(current-buffer))
3076 (while dictionary-alist
3077 (goto-char (point-min))
3078 (if (re-search-forward (car (car dictionary-alist
))
3080 (setq ispell-local-dictionary
(cdr (car dictionary-alist
))
3081 dictionary-alist nil
)
3082 (setq dictionary-alist
(cdr dictionary-alist
)))))
3086 ;; Spell check any original Subject:
3087 (goto-char (point-min))
3088 (setq case-fold-search t
)
3089 (if (re-search-forward "^Subject: *" end-of-headers t
)
3091 (goto-char (match-end 0))
3092 (if (and (not (looking-at ".*Re\\>"))
3093 (not (looking-at "\\[")))
3095 (setq case-fold-search old-case-fold-search
)
3096 (ispell-region (point)
3097 (progn ;Tab-initiated continuation lns.
3099 (while (looking-at "\n[ \t]")
3102 (setq case-fold-search old-case-fold-search
)
3103 (goto-char end-of-headers
)
3105 (ispell-region (point) limit
))
3106 (set-marker end-of-headers nil
)
3107 (set-marker limit nil
)))))
3110 (defun ispell-non-empty-string (string)
3111 (if (or (not string
) (string-equal string
""))
3112 "\\'\\`" ; An unmatchable string if string is null.
3113 (regexp-quote string
)))
3116 ;;; **********************************************************************
3117 ;;; Buffer Local Functions
3118 ;;; **********************************************************************
3121 (defun ispell-accept-buffer-local-defs ()
3122 "Load all buffer-local information, restarting Ispell when necessary."
3123 (ispell-buffer-local-dict) ; May kill ispell-process.
3124 (ispell-buffer-local-words) ; Will initialize ispell-process.
3125 (ispell-buffer-local-parsing))
3128 (defun ispell-buffer-local-parsing ()
3129 "Place Ispell into parsing mode for this buffer.
3130 Overrides the default parsing mode.
3131 Includes Latex/Nroff modes and extended character mode."
3132 ;; (ispell-init-process) must already be called.
3133 (ispell-send-string "!\n") ; Put process in terse mode.
3134 ;; We assume all major modes with "tex-mode" in them should use latex parsing
3135 ;; When exclusively checking comments, set to raw text mode (nroff).
3136 (if (and (not (eq 'exclusive ispell-check-comments
))
3137 (or (and (eq ispell-parser
'use-mode-name
)
3138 (string-match "[Tt][Ee][Xx]-mode"
3139 (symbol-name major-mode
)))
3140 (eq ispell-parser
'tex
)))
3142 (ispell-send-string "+\n") ; set ispell mode to tex
3143 (if (not (eq ispell-parser
'tex
))
3144 (set (make-local-variable 'ispell-parser
) 'tex
)))
3145 (ispell-send-string "-\n")) ; set mode to normal (nroff)
3146 ;; If needed, test for SGML & HTML modes and set a buffer local nil/t value.
3147 (if (and ispell-skip-html
(not (eq ispell-skip-html t
)))
3148 (set (make-local-variable 'ispell-skip-html
)
3149 (not (null (string-match "sgml\\|html"
3150 (downcase (symbol-name major-mode
)))))))
3151 ;; Set default extended character mode for given buffer, if any.
3152 (let ((extended-char-mode (ispell-get-extended-character-mode)))
3153 (if extended-char-mode
3154 (ispell-send-string (concat extended-char-mode
"\n"))))
3155 ;; Set buffer-local parsing mode and extended character mode, if specified.
3157 (goto-char (point-max))
3158 ;; Uses last occurrence of ispell-parsing-keyword
3159 (if (search-backward ispell-parsing-keyword nil t
)
3160 (let ((end (save-excursion (end-of-line) (point)))
3162 (search-forward ispell-parsing-keyword
)
3163 (while (re-search-forward " *\\([^ \"]+\\)" end t
)
3164 ;; space separated definitions.
3165 (setq string
(downcase (buffer-substring-no-properties
3166 (match-beginning 1) (match-end 1))))
3167 (cond ((and (string-match "latex-mode" string
)
3168 (not (eq 'exclusive ispell-check-comments
)))
3169 (ispell-send-string "+\n~tex\n"))
3170 ((string-match "nroff-mode" string
)
3171 (ispell-send-string "-\n~nroff\n"))
3172 ((string-match "~" string
) ; Set extended character mode.
3173 (ispell-send-string (concat string
"\n")))
3174 (t (message "Invalid Ispell Parsing argument!")
3178 ;;; Can kill the current ispell process
3180 (defun ispell-buffer-local-dict ()
3181 "Initializes local dictionary and local personal dictionary.
3182 When a dictionary is defined in the buffer (see variable
3183 `ispell-dictionary-keyword'), it will override the local setting
3184 from \\[ispell-change-dictionary].
3185 Both should not be used to define a buffer-local dictionary."
3187 (goto-char (point-min))
3189 ;; Override the local variable definition.
3190 ;; Uses last occurrence of ispell-dictionary-keyword.
3191 (goto-char (point-max))
3192 (if (search-backward ispell-dictionary-keyword nil t
)
3194 (search-forward ispell-dictionary-keyword
)
3195 (setq end
(save-excursion (end-of-line) (point)))
3196 (if (re-search-forward " *\\([^ \"]+\\)" end t
)
3197 (setq ispell-local-dictionary
3198 (buffer-substring-no-properties (match-beginning 1)
3200 (goto-char (point-max))
3201 (if (search-backward ispell-pdict-keyword nil t
)
3203 (search-forward ispell-pdict-keyword
)
3204 (setq end
(save-excursion (end-of-line) (point)))
3205 (if (re-search-forward " *\\([^ \"]+\\)" end t
)
3206 (setq ispell-local-pdict
3207 (buffer-substring-no-properties (match-beginning 1)
3208 (match-end 1))))))))
3209 ;; Reload if new personal dictionary defined.
3210 (if (and ispell-local-pdict
3211 (not (equal ispell-local-pdict ispell-personal-dictionary
)))
3213 (ispell-kill-ispell t
)
3214 (setq ispell-personal-dictionary ispell-local-pdict
)))
3215 ;; Reload if new dictionary defined.
3216 (if (and ispell-local-dictionary
3217 (not (equal ispell-local-dictionary ispell-dictionary
)))
3218 (ispell-change-dictionary ispell-local-dictionary
)))
3221 (defun ispell-buffer-local-words ()
3222 "Loads the buffer-local dictionary in the current buffer."
3223 (if (and ispell-buffer-local-name
3224 (not (equal ispell-buffer-local-name
(buffer-name))))
3226 (ispell-kill-ispell t
)
3227 (setq ispell-buffer-local-name nil
)))
3228 (ispell-init-process)
3230 (goto-char (point-min))
3231 (while (search-forward ispell-words-keyword nil t
)
3232 (or ispell-buffer-local-name
3233 (setq ispell-buffer-local-name
(buffer-name)))
3234 (let ((end (save-excursion (end-of-line) (point)))
3235 (ispell-casechars (ispell-get-casechars))
3237 ;; buffer-local words separated by a space, and can contain
3238 ;; any character other than a space. Not rigorous enough.
3239 (while (re-search-forward " *\\([^ ]+\\)" end t
)
3240 (setq string
(buffer-substring-no-properties (match-beginning 1)
3242 ;; This can fail when string contains a word with illegal chars.
3243 ;; Error handling needs to be added between ispell and emacs.
3244 (if (and (< 1 (length string
))
3245 (equal 0 (string-match ispell-casechars string
)))
3246 (ispell-send-string (concat "@" string
"\n"))))))))
3249 ;;; returns optionally adjusted region-end-point.
3251 (defun ispell-add-per-file-word-list (word)
3252 "Add WORD to the per-file word list."
3253 (or ispell-buffer-local-name
3254 (setq ispell-buffer-local-name
(buffer-name)))
3256 (goto-char (point-min))
3257 (let ((old-case-fold-search case-fold-search
)
3258 line-okay search done found
)
3260 (setq case-fold-search nil
3261 search
(search-forward ispell-words-keyword nil
'move
)
3262 found
(or found search
)
3263 line-okay
(< (+ (length word
) 1 ; 1 for space after word..
3264 (progn (end-of-line) (current-column)))
3266 case-fold-search old-case-fold-search
)
3267 (if (or (and search line-okay
)
3274 (unless found
(newline))
3275 (insert (concat comment-start
" " ispell-words-keyword
))
3276 (if (> (length comment-end
) 0)
3279 (insert comment-end
)))))
3280 (insert (concat " " word
))))))))
3282 (add-to-list 'debug-ignored-errors
"^No word found to check!$")
3287 ;;; LOCAL VARIABLES AND BUFFER-LOCAL VALUE EXAMPLES.
3289 ;;; Local Variable options:
3290 ;;; mode: name(-mode)
3291 ;;; eval: expression
3292 ;;; local-variable: value
3294 ;;; The following sets the buffer local dictionary to `american' English
3295 ;;; and spell checks only comments.
3297 ;;; Local Variables:
3298 ;;; mode: emacs-lisp
3299 ;;; comment-column: 40
3300 ;;; ispell-check-comments: exclusive
3301 ;;; ispell-local-dictionary: "american"
3305 ;;; MORE EXAMPLES OF ISPELL BUFFER-LOCAL VALUES
3307 ;;; The following places this file in nroff parsing and extended char modes.
3308 ;;; Local IspellParsing: nroff-mode ~nroff
3309 ;;; Change IspellPersDict to IspellPersDict: to enable the following line.
3310 ;;; Local IspellPersDict ~/.ispell_lisp
3311 ;;; The following were automatically generated by ispell using the 'A' command:
3312 ; LocalWords: settable alist inews mh frag pdict Wildcards iconify arg tex kss
3313 ; LocalWords: alists minibuffer bufferp autoload loaddefs aff Dansk KOI SPC op
3314 ; LocalWords: Francais Nederlands charset autoloaded popup nonmenu regexp num
3315 ; LocalWords: AMStex hspace includeonly nocite epsfig displaymath eqnarray reg
3316 ; LocalWords: minipage modeline pers dict unhighlight buf grep sync prev inc
3317 ; LocalWords: fn hilight oldot NB AIX msg init read's bufs pt cmd Quinlan eg
3318 ; LocalWords: uuencoded unidiff sc nn VM SGML eval IspellPersDict unsplitable
3319 ; LocalWords: lns XEmacs HTML casechars Multibyte
3321 ;;; ispell.el ends here