| blob | 0edf9b1a47e3b8e741fb20ee199498d358aba03f |
1 ;;; flyspell.el --- On-the-fly spell checker -*- lexical-binding:t -*-
3 ;; Copyright (C) 1998, 2000-2017 Free Software Foundation, Inc.
5 ;; Author: Manuel Serrano <Manuel.Serrano@sophia.inria.fr>
6 ;; Maintainer: emacs-devel@gnu.org
7 ;; Keywords: convenience
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software: you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation, either version 3 of the License, or
14 ;; (at your option) any later version.
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
24 ;;; Commentary:
25 ;;
26 ;; Flyspell is a minor Emacs mode performing on-the-fly spelling
27 ;; checking.
28 ;;
29 ;; To enable Flyspell minor mode, type M-x flyspell-mode.
30 ;; This applies only to the current buffer.
31 ;;
32 ;; To enable Flyspell in text representing computer programs, type
33 ;; M-x flyspell-prog-mode.
34 ;; In that mode only text inside comments is checked.
35 ;;
36 ;; Some user variables control the behavior of flyspell. They are
37 ;; those defined under the `User variables' comment.
39 ;;; Code:
44 ;;*---------------------------------------------------------------------*/
45 ;;* Group ... */
46 ;;*---------------------------------------------------------------------*/
48 "Spell checking on the fly."
54 ;;*---------------------------------------------------------------------*/
55 ;;* User configuration ... */
56 ;;*---------------------------------------------------------------------*/
58 "How Flyspell should indicate misspelled words.
59 Non-nil means use highlight, nil means use minibuffer messages."
64 "Non-nil means Flyspell reports a repeated word as an error.
65 See `flyspell-mark-duplications-exceptions' to add exceptions to this rule.
66 Detection of repeated words is not implemented in
74 "A list of exceptions for duplicated words.
75 It should be a list of (LANGUAGE . EXCEPTION-LIST).
77 LANGUAGE is nil, which means the exceptions apply regardless of
78 the current dictionary, or a regular expression matching the
79 dictionary name (`ispell-local-dictionary' or
80 `ispell-dictionary') for which the exceptions should apply.
82 EXCEPTION-LIST is a list of strings. The checked word is
83 downcased before comparing with these exceptions."
86 string)
91 "If non-nil, sort the corrections before popping them.
92 The sorting is controlled by the `flyspell-sort-corrections-function'
93 variable, and defaults to sorting alphabetically."
99 'flyspell-sort-corrections-alphabetically
100 "The function used to sort corrections.
101 This only happens if `flyspell-sort-corrections' is non-nil. The
102 function takes three parameters -- the two correction candidates
103 to be sorted, and the third parameter is the word that's being
104 corrected."
117 corrs))
120 "The maximum distance for finding duplicates of unrecognized words.
121 This applies to the feature that when a word is not found in the dictionary,
122 if the same spelling occurs elsewhere in the buffer,
123 Flyspell uses a different face (`flyspell-duplicate') to highlight it.
124 This variable specifies how far to search to find such a duplicate.
125 -1 means no limit (search the whole buffer).
126 0 means do not search for duplicate unrecognized spellings."
130 number))
138 "Non-nil means misspelled words remain highlighted until corrected.
139 If this variable is nil, only the most recently detected misspelled word
140 is highlighted."
145 "Non-nil means highlight incorrect words even if a property exists for this word."
151 delete-backward-char
152 backward-or-forward-delete-char
153 delete-char
154 scrollbar-vertical-drag
155 backward-delete-char-untabify)
156 "The standard list of delayed commands for Flyspell.
157 See `flyspell-delayed-commands'."
164 After these commands, Flyspell checking is delayed for a short time,
165 whose length is specified by `flyspell-delay'."
171 handle-switch-frame handle-select-window
172 scroll-up
173 scroll-down)
174 "The standard list of deplacement commands for Flyspell.
175 See variable `flyspell-deplacement-commands'."
182 After these commands, Flyspell checking is performed only if the previous
183 command was not the very same command."
189 "Non-nil means that Flyspell should display a welcome message when started."
194 "Non-nil means that Flyspell emits messages when checking words."
199 "List of functions to be called when incorrect words are encountered.
200 Each function is given three arguments. The first two
201 arguments are the beginning and the end of the incorrect region.
202 The third is either the symbol `doublon' or the list
203 of possible corrections as returned by `ispell-parse-output'.
205 If any of the functions return non-nil, the word is not highlighted as
206 incorrect."
212 "A string that is the name of the default dictionary.
213 This is passed to the `ispell-change-dictionary' when flyspell is started.
214 If the variable `ispell-local-dictionary' or `ispell-dictionary' is non-nil
215 when flyspell is started, the value of that variable is used instead
216 of `flyspell-default-dictionary' to select the default dictionary.
217 Otherwise, if `flyspell-default-dictionary' is nil, it means to use
218 Ispell's ultimate default dictionary."
224 "\\(\\(begin\\|end\\)[ \t]*{\\|\\(cite[a-z*]*\\|label\\|ref\\|eqref\\|usepackage\\|documentclass\\)[ \t]*\\(\\[[^]]*\\]\\)?{[^{}]*\\)"
225 "A string that is the regular expression that matches TeX commands."
231 "Non-nil means check even inside TeX math environment.
232 TeX math environments are discovered by `texmathp', implemented
233 inside AUCTeX package. That package may be found at
234 URL `http://www.gnu.org/software/auctex/'"
240 "List of dictionary names that consider `-' as word delimiter."
246 nil
247 "If non-nil, add correction to abbreviation table."
253 nil
254 "If non-nil, prefer global abbrev table to local abbrev table."
260 "String displayed on the mode line when flyspell is active.
261 Set this to nil if you don't want a mode line indicator."
266 "The threshold that determines if a region is small.
267 If the region is smaller than this number of characters,
268 `flyspell-region' checks the words sequentially using regular
269 flyspell methods. Else, if the region is large, a new Ispell process is
270 spawned for speed.
272 Doubled words are not detected in a large region, because Ispell
273 does not check for them.
275 If this variable is nil, all regions are treated as small."
281 "Function for inserting word by flyspell upon correction."
286 "String used to indicate an incorrect word starting."
291 "String used to indicate an incorrect word ending."
298 "Non-nil means that flyspell uses M-TAB to correct word."
309 "The key binding for flyspell auto correction."
313 ;;*---------------------------------------------------------------------*/
314 ;;* Mode specific options */
315 ;;* ------------------------------------------------------------- */
316 ;;* Mode specific options enable users to disable flyspell on */
317 ;;* certain word depending of the emacs mode. For instance, when */
318 ;;* using flyspell with mail-mode add the following expression */
319 ;;* in your init file: */
320 ;;* (add-hook 'mail-mode */
321 ;;* (lambda () (setq flyspell-generic-check-word-predicate */
322 ;;* 'mail-mode-flyspell-verify))) */
323 ;;*---------------------------------------------------------------------*/
325 "Function providing per-mode customization over which words are flyspelled.
326 Returns t to continue checking, nil otherwise.
327 Flyspell mode sets this variable to whatever is the `flyspell-mode-predicate'
333 ;;*--- mail mode -------------------------------------------------------*/
338 "Function used for `flyspell-generic-check-word-predicate' in Mail mode."
345 nil t)
360 nil)
366 ;;*--- texinfo mode ----------------------------------------------------*/
369 "Function used for `flyspell-generic-check-word-predicate' in Texinfo mode."
374 ;;*--- tex mode --------------------------------------------------------*/
377 "Function used for `flyspell-generic-check-word-predicate' in LaTeX mode."
389 ;;*--- sgml mode -------------------------------------------------------*/
397 "Function used for `flyspell-generic-check-word-predicate' in SGML mode.
398 Tag and attribute names are not spell checked, everything else is.
400 String values of attributes are checked because they can be text
406 ;;*---------------------------------------------------------------------*/
407 ;;* Programming mode */
408 ;;*---------------------------------------------------------------------*/
414 "Used for `flyspell-generic-check-word-predicate' in programming modes."
415 ;; (point) is next char after the word. Must check one char before.
419 ;; Records the binding of M-TAB in effect before flyspell was activated.
422 ;;;###autoload
424 "Turn on `flyspell-mode' for comments and strings."
434 ;;*---------------------------------------------------------------------*/
435 ;;* Overlay compatibility */
436 ;;*---------------------------------------------------------------------*/
446 ;;*---------------------------------------------------------------------*/
447 ;;* The minor mode declaration. */
448 ;;*---------------------------------------------------------------------*/
461 map)
464 ;; dash character machinery
473 ;;*---------------------------------------------------------------------*/
474 ;;* Highlighting */
475 ;;*---------------------------------------------------------------------*/
481 "Flyspell face for misspelled words."
490 "Flyspell face for words that appear twice in a row.
491 See also `flyspell-duplicate-distance'."
497 ;;*---------------------------------------------------------------------*/
498 ;;* flyspell-mode ... */
499 ;;*---------------------------------------------------------------------*/
500 ;;;###autoload(defvar flyspell-mode nil "Non-nil if Flyspell mode is enabled.")
501 ;;;###autoload
503 "Toggle on-the-fly spell checking (Flyspell mode).
504 With a prefix argument ARG, enable Flyspell mode if ARG is
505 positive, and disable it otherwise. If called from Lisp, enable
506 the mode if ARG is omitted or nil.
508 Flyspell mode is a buffer-local minor mode. When enabled, it
509 spawns a single Ispell process and checks each word. The default
510 flyspell behavior is to highlight incorrect words.
512 Bindings:
518 Hooks:
519 This runs `flyspell-mode-hook' after flyspell mode is entered or exit.
521 Remark:
522 `flyspell-mode' uses `ispell-mode'. Thus all Ispell options are
523 valid. For instance, a different dictionary can be used by
524 invoking `ispell-change-dictionary'.
526 Consider using the `ispell-parser' to check your text. For instance
527 consider adding:
529 in your init file.
533 :lighter flyspell-mode-line-string
534 :keymap flyspell-mode-map
543 ;;;###autoload
545 "Unconditionally turn on Flyspell mode."
548 ;;;###autoload
550 "Unconditionally turn off Flyspell mode."
555 ;;*---------------------------------------------------------------------*/
556 ;;* flyspell-buffers ... */
557 ;;* ------------------------------------------------------------- */
558 ;;* For remembering buffers running flyspell */
559 ;;*---------------------------------------------------------------------*/
562 ;;*---------------------------------------------------------------------*/
563 ;;* flyspell-minibuffer-p ... */
564 ;;*---------------------------------------------------------------------*/
566 "Is BUFFER a minibuffer?"
570 ;;*---------------------------------------------------------------------*/
571 ;;* flyspell-accept-buffer-local-defs ... */
572 ;;*---------------------------------------------------------------------*/
577 ;; When flyspell-word is used inside a loop (e.g. when processing
578 ;; flyspell-changes), the calls to `ispell-accept-buffer-local-defs' end
579 ;; up dwarfing everything else, so only do it when the buffer has changed.
582 ;; Strange problem: If buffer in current window has font-lock turned on,
583 ;; but SET-BUFFER was called to point to an invisible buffer, this ispell
584 ;; call will reset the buffer to the buffer in the current window.
585 ;; However, it only happens at startup (fix by Albert L. Ting).
590 ;; The dictionary has changed
595 flyspell-dictionaries-that-consider-dash-as-word-delimiter)))))
598 ;; When local variables are loaded, see if the dictionary context
599 ;; has changed.
608 ;; Make sure we flush our caches when needed. Do it here rather than in
609 ;; flyspell-mode-on, since flyspell-region may be used without ever turning
610 ;; on flyspell-mode.
613 ;;*---------------------------------------------------------------------*/
614 ;;* flyspell-mode-on ... */
615 ;;*---------------------------------------------------------------------*/
617 "Turn Flyspell mode on. Do not use this; use `flyspell-mode' instead."
620 ;; local dictionaries setup
624 ;; we have to force ispell to accept the local definition or
625 ;; otherwise it could be too late, the local dictionary may
626 ;; be forgotten!
627 ;; Pass the `force' argument for the case where flyspell was active already
628 ;; but the buffer's local-defs have been edited.
630 ;; we put the `flyspell-delayed' property on some commands
632 ;; we put the `flyspell-deplacement' property on some commands
634 ;; we bound flyspell action to post-command hook
636 ;; we bound flyspell action to pre-command hook
638 ;; we bound flyspell action to after-change hook
640 ;; we bound flyspell action to hack-local-variables-hook
643 ;; set flyspell-generic-check-word-predicate based on the major mode
647 ;; the welcome message
649 flyspell-issue-welcome-flag
659 ;;*---------------------------------------------------------------------*/
660 ;;* flyspell-delay-commands ... */
661 ;;*---------------------------------------------------------------------*/
663 "Install the standard set of Flyspell delayed commands."
667 ;;*---------------------------------------------------------------------*/
668 ;;* flyspell-delay-command ... */
669 ;;*---------------------------------------------------------------------*/
671 "Set COMMAND to be delayed, for Flyspell.
672 When flyspell `post-command-hook' is invoked because a delayed command
673 has been used, the current word is not immediately checked.
674 It will be checked only after `flyspell-delay' seconds."
678 ;;*---------------------------------------------------------------------*/
679 ;;* flyspell-deplacement-commands ... */
680 ;;*---------------------------------------------------------------------*/
682 "Install the standard set of Flyspell deplacement commands."
686 ;;*---------------------------------------------------------------------*/
687 ;;* flyspell-deplacement-command ... */
688 ;;*---------------------------------------------------------------------*/
690 "Set COMMAND that implement cursor movements, for Flyspell.
691 When flyspell `post-command-hook' is invoked because a deplacement command
692 has been used, the current word is not checked."
696 ;;*---------------------------------------------------------------------*/
697 ;;* flyspell-word-cache ... */
698 ;;*---------------------------------------------------------------------*/
708 ;;*---------------------------------------------------------------------*/
709 ;;* The flyspell pre-hook, store the current position. In the */
710 ;;* post command hook, we will check, if the word at this position */
711 ;;* has to be spell checked. */
712 ;;*---------------------------------------------------------------------*/
720 ;;*---------------------------------------------------------------------*/
721 ;;* flyspell-previous-command ... */
722 ;;*---------------------------------------------------------------------*/
726 ;;*---------------------------------------------------------------------*/
727 ;;* flyspell-pre-command-hook ... */
728 ;;*---------------------------------------------------------------------*/
730 "Save the current buffer and point for Flyspell's post-command hook."
736 ;;*---------------------------------------------------------------------*/
737 ;;* flyspell-mode-off ... */
738 ;;*---------------------------------------------------------------------*/
739 ;;;###autoload
741 "Turn Flyspell mode off."
742 ;; We remove the hooks.
748 ;; We remove all the flyspell highlightings.
750 ;; We have to erase pre cache variables.
753 ;; We mark the mode as killed.
756 ;;*---------------------------------------------------------------------*/
757 ;;* flyspell-check-pre-word-p ... */
758 ;;*---------------------------------------------------------------------*/
760 "Return non-nil if we should check the word before point.
761 More precisely, it applies to the word that was before point
762 before the current command."
767 nil)
770 nil)
775 ispell-otherchars
780 nil)
788 ;; If other post-command-hooks change the buffer,
789 ;; flyspell-pre-point can lie past eob (bug#468).
794 ispell-otherchars
797 nil)
799 t)
802 t)
807 ;;*---------------------------------------------------------------------*/
808 ;;* The flyspell after-change-hook, store the change position. In */
809 ;;* the post command hook, we will check, if the word at this */
810 ;;* position has to be spell checked. */
811 ;;*---------------------------------------------------------------------*/
815 ;;*---------------------------------------------------------------------*/
816 ;;* flyspell-after-change-function ... */
817 ;;*---------------------------------------------------------------------*/
819 "Save the current buffer and point for Flyspell's post-command hook."
822 ;;*---------------------------------------------------------------------*/
823 ;;* flyspell-check-changed-word-p ... */
824 ;;*---------------------------------------------------------------------*/
826 "Return non-nil when the changed word has to be checked.
827 The answer depends of several criteria.
828 Mostly we check word delimiters."
836 ;;*---------------------------------------------------------------------*/
837 ;;* flyspell-check-word-p ... */
838 ;;*---------------------------------------------------------------------*/
840 "Return t when the word at `point' has to be checked.
841 The answer depends of several criteria.
842 Mostly we check word delimiters."
846 ;; The buffer is not filled enough.
847 nil)
857 ;; Yes because we have reached or typed a word delimiter.
858 t)
864 ;; The current command is not delayed, that
865 ;; is that we must check the word now.
871 ;;*---------------------------------------------------------------------*/
872 ;;* flyspell-debug-signal-no-check ... */
873 ;;*---------------------------------------------------------------------*/
881 ;;*---------------------------------------------------------------------*/
882 ;;* flyspell-debug-signal-pre-word-checked ... */
883 ;;*---------------------------------------------------------------------*/
894 ;;*---------------------------------------------------------------------*/
895 ;;* flyspell-debug-signal-word-checked ... */
896 ;;*---------------------------------------------------------------------*/
915 nil
928 ;; The current command is not delayed, that
929 ;; is that we must check the word now.
933 nil
941 ;; Yes because we have reached or typed a word delimiter.
944 ;; Yes because the user set up a no-delay configuration.
950 ;;*---------------------------------------------------------------------*/
951 ;;* flyspell-debug-signal-changed-checked ... */
952 ;;*---------------------------------------------------------------------*/
961 ;;*---------------------------------------------------------------------*/
962 ;;* flyspell-post-command-hook ... */
963 ;;* ------------------------------------------------------------- */
964 ;;* It is possible that we check several words: */
965 ;;* 1- the current word is checked if the predicate */
966 ;;* FLYSPELL-CHECK-WORD-P is true */
967 ;;* 2- the word that used to be the current word before the */
968 ;;* THIS-COMMAND is checked if: */
969 ;;* a- the previous word is different from the current word */
970 ;;* b- the previous word has not just been checked by the */
971 ;;* previous FLYSPELL-POST-COMMAND-HOOK */
972 ;;* 3- the words changed by the THIS-COMMAND that are neither the */
973 ;;* previous word nor the current word */
974 ;;*---------------------------------------------------------------------*/
976 "The `post-command-hook' used by flyspell to check a word on-the-fly."
981 ;; Prevent anything we do from affecting the mark.
982 deactivate-mark)
991 ;; FIXME: This should be asynchronous!
993 ;; we remember which word we have just checked.
994 ;; this will be used next time we will check a word
995 ;; to compare the next current word with the word
996 ;; that has been registered in the pre-command-hook
997 ;; that is these variables are used within the predicate
998 ;; FLYSPELL-CHECK-PRE-WORD-P
1003 ;; when a word is not checked because of a delayed command
1004 ;; we do not disable the ispell cache.
1020 ;;*---------------------------------------------------------------------*/
1021 ;;* flyspell-notify-misspell ... */
1022 ;;*---------------------------------------------------------------------*/
1025 poss
1030 ;;*---------------------------------------------------------------------*/
1031 ;;* flyspell-word-search-backward ... */
1032 ;;*---------------------------------------------------------------------*/
1044 flyspell-not-casechars))
1045 p)
1062 r)))
1064 ;;*---------------------------------------------------------------------*/
1065 ;;* flyspell-word-search-forward ... */
1066 ;;*---------------------------------------------------------------------*/
1078 p)
1091 r)))
1095 ;;*---------------------------------------------------------------------*/
1096 ;;* flyspell-word ... */
1097 ;;*---------------------------------------------------------------------*/
1099 "Spell check a word.
1100 If the optional argument FOLLOWING, or, when called interactively
1101 `ispell-following-word', is non-nil, checks the following (rather
1102 than preceding) word when the cursor is not over a word. If
1103 optional argument KNOWN-MISSPELLING is non nil considers word a
1104 misspelling and skips redundant spell-checking step."
1108 ;; use the correct dictionary
1112 start end poss word ispell-filter)
1116 t
1118 ;; destructure return flyspell-word info list.
1122 ;; before checking in the directory, we check for doublons.
1127 flyspell-mark-duplications-flag
1130 ispell-dictionary)))
1147 ;; yes, this is a doublon
1149 nil)
1153 ;; this word had been already checked, we skip
1154 flyspell-word-cache-result)
1157 ;; this is a correct word (because a tex command)
1161 t)
1163 ;; we setup the cache
1167 ;; now check spelling of word.
1171 ;; put in verbose mode
1173 ;; we mark the ispell process so it can be killed
1174 ;; when emacs is exited without query
1176 ;; Wait until ispell has processed word.
1180 ;; (ispell-send-string "!\n")
1181 ;; back to terse mode.
1182 ;; Remove leading empty element
1184 ;; ispell process should return something after word is sent.
1185 ;; Tag word as valid (i.e., skip) otherwise
1190 ;; Else, this was a known misspelling to begin with, and
1191 ;; we should forge an ispell return value.
1194 ;; correct
1199 t)
1201 ;; correct
1206 t)
1212 t)
1217 word
1222 word
1228 word
1230 flyspell-duplicate-distance)))
1234 word
1235 (+ end
1236 flyspell-duplicate-distance))))))
1237 ;; This is a misspelled word which occurs
1238 ;; twice within flyspell-duplicate-distance.
1242 start end poss)
1244 nil)
1247 ;; Highlight the location as incorrect,
1248 ;; including offset specified in POSS.
1254 start)
1255 end poss)
1257 nil))))
1258 ;; return to original location
1261 res))))))))
1263 ;;*---------------------------------------------------------------------*/
1264 ;;* flyspell-math-tex-command-p ... */
1265 ;;* ------------------------------------------------------------- */
1266 ;;* This function uses the texmathp package to check if point */
1267 ;;* is within a TeX math environment. `texmathp' can yield errors */
1268 ;;* if the document is currently not valid TeX syntax. */
1269 ;;*---------------------------------------------------------------------*/
1273 nil
1278 ;;*---------------------------------------------------------------------*/
1279 ;;* flyspell-tex-command-p ... */
1280 ;;*---------------------------------------------------------------------*/
1282 "Return t if WORD is a TeX command."
1295 ;;*---------------------------------------------------------------------*/
1296 ;;* flyspell-get-word ... */
1297 ;;*---------------------------------------------------------------------*/
1299 "Return the word for spell-checking according to Ispell syntax.
1300 Optional argument FOLLOWING non-nil means to get the following
1301 \(rather than preceding) word when the cursor is not over a word.
1302 Optional second argument EXTRA-OTHERCHARS is a regexp of characters
1303 that may be included as part of a word (see `ispell-dictionary-alist')."
1314 flyspell-casechars
1317 extra-otherchars)
1319 did-it-once prevpt
1320 start end word)
1321 ;; find the word
1326 ;; move to front of word
1333 ispell-many-otherchars-p)
1346 ;; Now mark the word and save to string.
1348 nil
1355 ;;*---------------------------------------------------------------------*/
1356 ;;* flyspell-small-region ... */
1357 ;;*---------------------------------------------------------------------*/
1359 "Flyspell text between BEG and END."
1384 ;;*---------------------------------------------------------------------*/
1385 ;;* flyspell-external-ispell-process ... */
1386 ;;*---------------------------------------------------------------------*/
1390 ;;*---------------------------------------------------------------------*/
1391 ;;* flyspell-external-ispell-buffer ... */
1392 ;;*---------------------------------------------------------------------*/
1398 ;;*---------------------------------------------------------------------*/
1399 ;;* flyspell-external-point-words ... */
1400 ;;*---------------------------------------------------------------------*/
1402 "Mark words from a buffer listing incorrect words in order of appearance.
1403 The list of incorrect words should be in `flyspell-external-ispell-buffer'.
1404 \(We finish by killing that buffer and setting the variable to nil.)
1405 The buffer to mark them in is `flyspell-large-region-buffer'."
1409 case-fold-search)
1412 ;; Loop over incorrect words, in the order they were reported,
1413 ;; which is also the order they appear in the buffer being checked.
1415 ;; Bind WORD to the next one.
1417 ;; Here there used to be code to see if WORD is the same
1418 ;; as the previous iteration, and count the number of consecutive
1419 ;; identical words, and the loop below would search for that many.
1420 ;; That code seemed to be incorrect, and on principle, should
1421 ;; be unnecessary too. -- rms.
1425 word))
1429 ;; Iterate on string search until string is found as word,
1430 ;; not as substring.
1433 flyspell-large-region-end t)
1436 ;; Move back into the match
1437 ;; so flyspell-get-word will find it.
1444 ;; Size matches, we really found it.
1446 ;; Matches as part of a boundary-char separated
1447 ;; word.
1450 ;; Misspelling has higher length than
1451 ;; what flyspell considers the word.
1452 ;; Caused by boundary-chars mismatch.
1453 ;; Validating seems safe.
1455 ;; ispell treats beginning of some TeX
1456 ;; commands as nroff control sequences
1457 ;; and strips them in the list of
1458 ;; misspelled words thus giving a
1459 ;; non-existent word. Skip if ispell
1460 ;; is used, string is a TeX command
1461 ;; (char before beginning of word is
1462 ;; backslash) and none of the previous
1463 ;; conditions match.
1468 t
1469 nil))))
1472 ;; Search for next misspelled word will begin from
1473 ;; end of last validated match.
1475 ;; Record if misspelling is not found and try new one
1480 ;; we are done
1482 ;; Warn about not found misspellings
1485 ;; Kill and forget the buffer with the list of incorrect words.
1489 ;;*---------------------------------------------------------------------*/
1490 ;;* flyspell-process-localwords ... */
1491 ;;* ------------------------------------------------------------- */
1492 ;;* This function is used to prevent marking of words explicitly */
1493 ;;* declared correct. */
1494 ;;*---------------------------------------------------------------------*/
1497 case-fold-search
1499 ;; Get localwords from the original buffer
1502 ;; Localwords parsing copied from ispell.el.
1505 string)
1506 ;; buffer-local words separated by a space, and can contain
1507 ;; any character other than a space. Not rigorous enough.
1511 ;; This can fail when string contains a word with invalid chars.
1512 ;; Error handling needs to be added between Ispell and Emacs.
1516 ;; Remove localwords matches from misspellings-buffer.
1517 ;; The usual mechanism of communicating the local words to ispell
1518 ;; does not affect the special ispell process used by
1519 ;; flyspell-large-region.
1528 ;;* ---------------------------------------------------------------
1529 ;;* flyspell-check-region-doublons
1530 ;;* ---------------------------------------------------------------
1532 "Check for adjacent duplicated words (doublons) in the given region."
1544 ;;*---------------------------------------------------------------------*/
1545 ;;* flyspell-large-region ... */
1546 ;;*---------------------------------------------------------------------*/
1557 ;; this is done, we can start checking...
1561 ;; Local dictionary becomes the global dictionary in use.
1568 c)
1578 ispell-current-personal-dictionary)))))
1580 ;; Check for extended character mode
1587 ;; Add ispell-extra-args
1590 ;; If we are using recent aspell or hunspell, make sure we use the right encoding
1591 ;; for communication. ispell or older aspell/hunspell does not support this
1603 end
1604 ispell-program-name
1605 nil
1606 buffer
1607 nil
1609 args)))
1619 ;;*---------------------------------------------------------------------*/
1620 ;;* flyspell-region ... */
1621 ;;* ------------------------------------------------------------- */
1622 ;;* Because `ispell -a' is too slow, it is not possible to use */
1623 ;;* it on large region. Then, when ispell is invoked on a large */
1624 ;;* text region, a new `ispell -l' process is spawned. The */
1625 ;;* pointed out words are then searched in the region a checked with */
1626 ;;* regular flyspell means. */
1627 ;;*---------------------------------------------------------------------*/
1628 ;;;###autoload
1630 "Flyspell text between BEG and END."
1634 ()
1644 ;;*---------------------------------------------------------------------*/
1645 ;;* flyspell-buffer ... */
1646 ;;*---------------------------------------------------------------------*/
1647 ;;;###autoload
1649 "Flyspell whole buffer."
1653 ;;*---------------------------------------------------------------------*/
1654 ;;* old next error position ... */
1655 ;;*---------------------------------------------------------------------*/
1659 ;;*---------------------------------------------------------------------*/
1660 ;;* flyspell-goto-next-error ... */
1661 ;;*---------------------------------------------------------------------*/
1663 "Go to the next previously detected error.
1664 In general FLYSPELL-GOTO-NEXT-ERROR must be used after
1665 FLYSPELL-BUFFER."
1673 ;; goto beginning of buffer
1679 ;; seek the next error
1689 ;; save the current location for next invocation
1696 ;;*---------------------------------------------------------------------*/
1697 ;;* flyspell-overlay-p ... */
1698 ;;*---------------------------------------------------------------------*/
1700 "Return true if O is an overlay used by flyspell."
1703 ;;*---------------------------------------------------------------------*/
1704 ;;* flyspell-delete-region-overlays, flyspell-delete-all-overlays */
1705 ;;* ------------------------------------------------------------- */
1706 ;;* Remove overlays introduced by flyspell. */
1707 ;;*---------------------------------------------------------------------*/
1709 "Delete overlays used by flyspell in a given region."
1713 "Delete all the overlays used by flyspell."
1716 ;;*---------------------------------------------------------------------*/
1717 ;;* flyspell-unhighlight-at ... */
1718 ;;*---------------------------------------------------------------------*/
1720 "Remove the flyspell overlay that are located at POS."
1730 ;;*---------------------------------------------------------------------*/
1731 ;;* flyspell-properties-at-p ... */
1732 ;;* ------------------------------------------------------------- */
1733 ;;* Is there an highlight properties at position pos? */
1734 ;;*---------------------------------------------------------------------*/
1736 "Return t if there is a text property at POS, not counting `local-map'.
1737 If variable `flyspell-highlight-properties' is set to nil,
1738 text with properties are not checked. This function is used to discover
1739 if the character at POS has any other property."
1748 ;;*---------------------------------------------------------------------*/
1749 ;;* make-flyspell-overlay ... */
1750 ;;*---------------------------------------------------------------------*/
1752 "Allocate an overlay to highlight an incorrect word.
1753 BEG and END specify the range in the buffer of that word.
1754 FACE and MOUSE-FACE specify the `face' and `mouse-face' properties
1755 for the overlay."
1766 flyspell-before-incorrect-word-string))
1769 flyspell-after-incorrect-word-string)))
1770 overlay))
1772 ;;*---------------------------------------------------------------------*/
1773 ;;* flyspell-highlight-incorrect-region ... */
1774 ;;*---------------------------------------------------------------------*/
1776 "Set up an overlay on a misspelled word, in the buffer from BEG to END.
1777 POSS is usually a list of possible spelling/correction lists,
1778 as returned by `ispell-parse-output'.
1779 It can also be the symbol `doublon', in the case where the word
1780 is itself incorrect, but suspiciously repeated."
1787 ;; we cleanup all the overlay that are in the region, not
1788 ;; beginning at the word start position
1795 ;; we cleanup current overlay at the same position
1797 ;; now we can use a new overlay
1800 beg end
1804 ;;*---------------------------------------------------------------------*/
1805 ;;* flyspell-highlight-duplicate-region ... */
1806 ;;*---------------------------------------------------------------------*/
1808 "Set up an overlay on a duplicate misspelled word, in the buffer from BEG to END.
1809 POSS is a list of possible spelling/correction lists,
1810 as returned by `ispell-parse-output'."
1817 ;; we cleanup current overlay at the same position
1819 ;; now we can use a new overlay
1822 'flyspell-duplicate
1825 ;;*---------------------------------------------------------------------*/
1826 ;;* flyspell-auto-correct-cache ... */
1827 ;;*---------------------------------------------------------------------*/
1837 ;;*---------------------------------------------------------------------*/
1838 ;;* flyspell-check-previous-highlighted-word ... */
1839 ;;*---------------------------------------------------------------------*/
1841 "Correct the closest previous word that is highlighted as misspelled.
1842 This function scans for a word which starts before point that has been
1843 highlighted by Flyspell as misspelled. If it finds one, it proposes
1844 a replacement for that word. With prefix arg N, check the Nth word
1845 before point that's highlighted as misspelled."
1850 ov ovs)
1871 ;;*---------------------------------------------------------------------*/
1872 ;;* flyspell-display-next-corrections ... */
1873 ;;*---------------------------------------------------------------------*/
1888 string))
1894 ;;*---------------------------------------------------------------------*/
1895 ;;* flyspell-abbrev-table ... */
1896 ;;*---------------------------------------------------------------------*/
1899 global-abbrev-table
1902 ;;*---------------------------------------------------------------------*/
1903 ;;* flyspell-define-abbrev ... */
1904 ;;*---------------------------------------------------------------------*/
1910 ;;*---------------------------------------------------------------------*/
1911 ;;* flyspell-auto-correct-word ... */
1912 ;;*---------------------------------------------------------------------*/
1914 "Correct the current word.
1915 This command proposes various successive corrections for the current word."
1917 ;; If we are not in the construct where flyspell should be active,
1918 ;; invoke the original binding of M-TAB, if that was recorded.
1928 ;; Use the correct dictionary.
1932 ;; We have already been using the function at the same location.
1944 flyspell-auto-correct-word)
1946 flyspell-auto-correct-word
1947 word)
1954 ;; Fetch the word to be checked.
1960 poss ispell-filter)
1962 ;; Now check spelling of word..
1965 ;; Wait until ispell has processed word.
1969 ;; Remove leading empty element.
1971 ;; Ispell process should return something after word is sent.
1972 ;; Tag word as valid (i.e., skip) otherwise.
1979 ;; Don't correct word.
1980 t)
1982 ;; Ispell error.
1985 ;; The word is incorrect, we have to propose a replacement.
1987 word)))
1995 ;; the save the current replacements
2003 replacements)
2012 word
2013 new-word)
2015 new-word)))
2021 old-max))))))))))
2025 ;;*---------------------------------------------------------------------*/
2026 ;;* flyspell-auto-correct-previous-pos ... */
2027 ;;*---------------------------------------------------------------------*/
2031 ;;*---------------------------------------------------------------------*/
2032 ;;* flyspell-auto-correct-previous-hook ... */
2033 ;;*---------------------------------------------------------------------*/
2035 "Hook to track successive calls to `flyspell-auto-correct-previous-word'.
2036 Sets `flyspell-auto-correct-previous-pos' to nil"
2042 ;;*---------------------------------------------------------------------*/
2043 ;;* flyspell-auto-correct-previous-word ... */
2044 ;;*---------------------------------------------------------------------*/
2046 "Auto correct the first misspelled word that occurs before point.
2047 But don't look beyond what's visible on the screen."
2061 ;; only reset if a new overlay exists
2067 ;; search for previous (new) flyspell overlay
2070 ;; check if its face has changed
2077 ;; if nothing new exits new-overlay should be nil
2089 ;; the point may have moved so reset this
2092 ;;*---------------------------------------------------------------------*/
2093 ;;* flyspell-correct-word ... */
2094 ;;*---------------------------------------------------------------------*/
2097 "Pop up a menu of possible corrections for a misspelled word.
2098 The word checked is the word at the mouse position."
2105 "Pop up a menu of possible corrections for misspelled word before point.
2106 If EVENT is non-nil, it is the mouse event that invoked this operation;
2107 that controls where to put the menu.
2108 If OPOINT is non-nil, restore point there after adjusting it for replacement."
2110 ;; use the correct dictionary
2119 poss ispell-filter)
2120 ;; now check spelling of word.
2123 ;; wait until ispell has processed word
2127 ;; Remove leading empty element
2129 ;; ispell process should return something after word is sent.
2130 ;; Tag word as valid (i.e., skip) otherwise
2137 ;; don't correct word
2138 t)
2140 ;; ispell error
2143 ;; The word is incorrect, we have to propose a replacement.
2145 poss word cursor-location start end opoint)))
2148 ;;*---------------------------------------------------------------------*/
2149 ;;* flyspell-do-correct ... */
2150 ;;*---------------------------------------------------------------------*/
2152 "The popup menu callback."
2155 nil)
2178 replace
2181 cursor-location)))
2191 nil)))
2193 ;;*---------------------------------------------------------------------*/
2194 ;;* flyspell-adjust-cursor-point ... */
2195 ;;*---------------------------------------------------------------------*/
2207 ;;*---------------------------------------------------------------------*/
2208 ;;* flyspell-emacs-popup ... */
2209 ;;*---------------------------------------------------------------------*/
2211 "The Emacs popup menu."
2216 mouse-pos
2227 corrects)
2228 '()))
2230 show-affix-info
2242 save)))
2246 ispell-dictionary))
2247 menu)))))
2249 ;;*---------------------------------------------------------------------*/
2250 ;;* Some example functions for real autocorrecting */
2251 ;;*---------------------------------------------------------------------*/
2253 "Check replacements for transposed characters.
2255 If the text between BEG and END is equal to a correction suggested by
2256 Ispell, after transposing two adjacent characters, correct the text,
2257 and return t.
2259 The third arg POSS is either the symbol `doublon' or a list of
2260 possible corrections as returned by `ispell-parse-output'.
2262 This function is meant to be added to `flyspell-incorrect-hook'."
2280 nil)))
2283 "Check replacements for doubled characters.
2285 If the text between BEG and END is equal to a correction suggested by
2286 Ispell, after removing a pair of doubled characters, correct the text,
2287 and return t.
2289 The third arg POSS is either the symbol `doublon' or a list of
2290 possible corrections as returned by `ispell-parse-output'.
2292 This function is meant to be added to `flyspell-incorrect-hook'."
2306 nil)))
2308 ;;*---------------------------------------------------------------------*/
2309 ;;* flyspell-already-abbrevp ... */
2310 ;;*---------------------------------------------------------------------*/
2315 ;;*---------------------------------------------------------------------*/
2316 ;;* flyspell-change-abbrev ... */
2317 ;;*---------------------------------------------------------------------*/
2323 ;;; flyspell.el ends here