| blob | dc6da4aab29ceef84562480a0090a1568abc8b05 |
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 <https://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 `https://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 ;;*---------------------------------------------------------------------*/
452 map)
463 map)
466 ;; dash character machinery
475 ;;*---------------------------------------------------------------------*/
476 ;;* Highlighting */
477 ;;*---------------------------------------------------------------------*/
483 "Flyspell face for misspelled words."
492 "Flyspell face for words that appear twice in a row.
493 See also `flyspell-duplicate-distance'."
499 ;;*---------------------------------------------------------------------*/
500 ;;* flyspell-mode ... */
501 ;;*---------------------------------------------------------------------*/
502 ;;;###autoload(defvar flyspell-mode nil "Non-nil if Flyspell mode is enabled.")
503 ;;;###autoload
505 "Toggle on-the-fly spell checking (Flyspell mode).
506 With a prefix argument ARG, enable Flyspell mode if ARG is
507 positive, and disable it otherwise. If called from Lisp, enable
508 the mode if ARG is omitted or nil.
510 Flyspell mode is a buffer-local minor mode. When enabled, it
511 spawns a single Ispell process and checks each word. The default
512 flyspell behavior is to highlight incorrect words.
514 Bindings:
520 Hooks:
521 This runs `flyspell-mode-hook' after flyspell mode is entered or exit.
523 Remark:
524 `flyspell-mode' uses `ispell-mode'. Thus all Ispell options are
525 valid. For instance, a different dictionary can be used by
526 invoking `ispell-change-dictionary'.
528 Consider using the `ispell-parser' to check your text. For instance
529 consider adding:
531 in your init file.
535 :lighter flyspell-mode-line-string
536 :keymap flyspell-mode-map
545 ;;;###autoload
547 "Unconditionally turn on Flyspell mode."
550 ;;;###autoload
552 "Unconditionally turn off Flyspell mode."
557 ;;*---------------------------------------------------------------------*/
558 ;;* flyspell-buffers ... */
559 ;;* ------------------------------------------------------------- */
560 ;;* For remembering buffers running flyspell */
561 ;;*---------------------------------------------------------------------*/
564 ;;*---------------------------------------------------------------------*/
565 ;;* flyspell-minibuffer-p ... */
566 ;;*---------------------------------------------------------------------*/
568 "Is BUFFER a minibuffer?"
572 ;;*---------------------------------------------------------------------*/
573 ;;* flyspell-accept-buffer-local-defs ... */
574 ;;*---------------------------------------------------------------------*/
579 ;; When flyspell-word is used inside a loop (e.g. when processing
580 ;; flyspell-changes), the calls to `ispell-accept-buffer-local-defs' end
581 ;; up dwarfing everything else, so only do it when the buffer has changed.
584 ;; Strange problem: If buffer in current window has font-lock turned on,
585 ;; but SET-BUFFER was called to point to an invisible buffer, this ispell
586 ;; call will reset the buffer to the buffer in the current window.
587 ;; However, it only happens at startup (fix by Albert L. Ting).
592 ;; The dictionary has changed
597 flyspell-dictionaries-that-consider-dash-as-word-delimiter)))))
600 ;; When local variables are loaded, see if the dictionary context
601 ;; has changed.
610 ;; Make sure we flush our caches when needed. Do it here rather than in
611 ;; flyspell-mode-on, since flyspell-region may be used without ever turning
612 ;; on flyspell-mode.
615 ;;*---------------------------------------------------------------------*/
616 ;;* flyspell-mode-on ... */
617 ;;*---------------------------------------------------------------------*/
619 "Turn Flyspell mode on. Do not use this; use `flyspell-mode' instead."
622 ;; local dictionaries setup
626 ;; we have to force ispell to accept the local definition or
627 ;; otherwise it could be too late, the local dictionary may
628 ;; be forgotten!
629 ;; Pass the `force' argument for the case where flyspell was active already
630 ;; but the buffer's local-defs have been edited.
632 ;; we put the `flyspell-delayed' property on some commands
634 ;; we put the `flyspell-deplacement' property on some commands
636 ;; we bound flyspell action to post-command hook
638 ;; we bound flyspell action to pre-command hook
640 ;; we bound flyspell action to after-change hook
642 ;; we bound flyspell action to hack-local-variables-hook
645 ;; set flyspell-generic-check-word-predicate based on the major mode
649 ;; the welcome message
651 flyspell-issue-welcome-flag
661 ;;*---------------------------------------------------------------------*/
662 ;;* flyspell-delay-commands ... */
663 ;;*---------------------------------------------------------------------*/
665 "Install the standard set of Flyspell delayed commands."
669 ;;*---------------------------------------------------------------------*/
670 ;;* flyspell-delay-command ... */
671 ;;*---------------------------------------------------------------------*/
673 "Set COMMAND to be delayed, for Flyspell.
674 When flyspell `post-command-hook' is invoked because a delayed command
675 has been used, the current word is not immediately checked.
676 It will be checked only after `flyspell-delay' seconds."
680 ;;*---------------------------------------------------------------------*/
681 ;;* flyspell-deplacement-commands ... */
682 ;;*---------------------------------------------------------------------*/
684 "Install the standard set of Flyspell deplacement commands."
688 ;;*---------------------------------------------------------------------*/
689 ;;* flyspell-deplacement-command ... */
690 ;;*---------------------------------------------------------------------*/
692 "Set COMMAND that implement cursor movements, for Flyspell.
693 When flyspell `post-command-hook' is invoked because a deplacement command
694 has been used, the current word is not checked."
698 ;;*---------------------------------------------------------------------*/
699 ;;* flyspell-word-cache ... */
700 ;;*---------------------------------------------------------------------*/
710 ;;*---------------------------------------------------------------------*/
711 ;;* The flyspell pre-hook, store the current position. In the */
712 ;;* post command hook, we will check, if the word at this position */
713 ;;* has to be spell checked. */
714 ;;*---------------------------------------------------------------------*/
722 ;;*---------------------------------------------------------------------*/
723 ;;* flyspell-previous-command ... */
724 ;;*---------------------------------------------------------------------*/
728 ;;*---------------------------------------------------------------------*/
729 ;;* flyspell-pre-command-hook ... */
730 ;;*---------------------------------------------------------------------*/
732 "Save the current buffer and point for Flyspell's post-command hook."
738 ;;*---------------------------------------------------------------------*/
739 ;;* flyspell-mode-off ... */
740 ;;*---------------------------------------------------------------------*/
741 ;;;###autoload
743 "Turn Flyspell mode off."
744 ;; We remove the hooks.
750 ;; We remove all the flyspell highlightings.
752 ;; We have to erase pre cache variables.
755 ;; We mark the mode as killed.
758 ;;*---------------------------------------------------------------------*/
759 ;;* flyspell-check-pre-word-p ... */
760 ;;*---------------------------------------------------------------------*/
762 "Return non-nil if we should check the word before point.
763 More precisely, it applies to the word that was before point
764 before the current command."
769 nil)
772 nil)
777 ispell-otherchars
782 nil)
790 ;; If other post-command-hooks change the buffer,
791 ;; flyspell-pre-point can lie past eob (bug#468).
796 ispell-otherchars
799 nil)
801 t)
804 t)
809 ;;*---------------------------------------------------------------------*/
810 ;;* The flyspell after-change-hook, store the change position. In */
811 ;;* the post command hook, we will check, if the word at this */
812 ;;* position has to be spell checked. */
813 ;;*---------------------------------------------------------------------*/
817 ;;*---------------------------------------------------------------------*/
818 ;;* flyspell-after-change-function ... */
819 ;;*---------------------------------------------------------------------*/
821 "Save the current buffer and point for Flyspell's post-command hook."
824 ;;*---------------------------------------------------------------------*/
825 ;;* flyspell-check-changed-word-p ... */
826 ;;*---------------------------------------------------------------------*/
828 "Return non-nil when the changed word has to be checked.
829 The answer depends of several criteria.
830 Mostly we check word delimiters."
838 ;;*---------------------------------------------------------------------*/
839 ;;* flyspell-check-word-p ... */
840 ;;*---------------------------------------------------------------------*/
842 "Return t when the word at `point' has to be checked.
843 The answer depends of several criteria.
844 Mostly we check word delimiters."
848 ;; The buffer is not filled enough.
849 nil)
859 ;; Yes because we have reached or typed a word delimiter.
860 t)
866 ;; The current command is not delayed, that
867 ;; is that we must check the word now.
873 ;;*---------------------------------------------------------------------*/
874 ;;* flyspell-debug-signal-no-check ... */
875 ;;*---------------------------------------------------------------------*/
883 ;;*---------------------------------------------------------------------*/
884 ;;* flyspell-debug-signal-pre-word-checked ... */
885 ;;*---------------------------------------------------------------------*/
896 ;;*---------------------------------------------------------------------*/
897 ;;* flyspell-debug-signal-word-checked ... */
898 ;;*---------------------------------------------------------------------*/
917 nil
930 ;; The current command is not delayed, that
931 ;; is that we must check the word now.
935 nil
943 ;; Yes because we have reached or typed a word delimiter.
946 ;; Yes because the user set up a no-delay configuration.
952 ;;*---------------------------------------------------------------------*/
953 ;;* flyspell-debug-signal-changed-checked ... */
954 ;;*---------------------------------------------------------------------*/
963 ;;*---------------------------------------------------------------------*/
964 ;;* flyspell-post-command-hook ... */
965 ;;* ------------------------------------------------------------- */
966 ;;* It is possible that we check several words: */
967 ;;* 1- the current word is checked if the predicate */
968 ;;* FLYSPELL-CHECK-WORD-P is true */
969 ;;* 2- the word that used to be the current word before the */
970 ;;* THIS-COMMAND is checked if: */
971 ;;* a- the previous word is different from the current word */
972 ;;* b- the previous word has not just been checked by the */
973 ;;* previous FLYSPELL-POST-COMMAND-HOOK */
974 ;;* 3- the words changed by the THIS-COMMAND that are neither the */
975 ;;* previous word nor the current word */
976 ;;*---------------------------------------------------------------------*/
978 "The `post-command-hook' used by flyspell to check a word on-the-fly."
983 ;; Prevent anything we do from affecting the mark.
984 deactivate-mark)
993 ;; FIXME: This should be asynchronous!
995 ;; we remember which word we have just checked.
996 ;; this will be used next time we will check a word
997 ;; to compare the next current word with the word
998 ;; that has been registered in the pre-command-hook
999 ;; that is these variables are used within the predicate
1000 ;; FLYSPELL-CHECK-PRE-WORD-P
1005 ;; when a word is not checked because of a delayed command
1006 ;; we do not disable the ispell cache.
1022 ;;*---------------------------------------------------------------------*/
1023 ;;* flyspell-notify-misspell ... */
1024 ;;*---------------------------------------------------------------------*/
1027 poss
1032 ;;*---------------------------------------------------------------------*/
1033 ;;* flyspell-word-search-backward ... */
1034 ;;*---------------------------------------------------------------------*/
1046 flyspell-not-casechars))
1047 p)
1064 r)))
1066 ;;*---------------------------------------------------------------------*/
1067 ;;* flyspell-word-search-forward ... */
1068 ;;*---------------------------------------------------------------------*/
1080 p)
1093 r)))
1097 ;;*---------------------------------------------------------------------*/
1098 ;;* flyspell-word ... */
1099 ;;*---------------------------------------------------------------------*/
1101 "Spell check a word.
1102 If the optional argument FOLLOWING, or, when called interactively
1103 `ispell-following-word', is non-nil, checks the following (rather
1104 than preceding) word when the cursor is not over a word. If
1105 optional argument KNOWN-MISSPELLING is non nil considers word a
1106 misspelling and skips redundant spell-checking step."
1110 ;; use the correct dictionary
1114 start end poss word ispell-filter)
1118 t
1120 ;; destructure return flyspell-word info list.
1124 ;; before checking in the directory, we check for doublons.
1129 flyspell-mark-duplications-flag
1132 ispell-dictionary)))
1149 ;; yes, this is a doublon
1151 nil)
1155 ;; this word had been already checked, we skip
1156 flyspell-word-cache-result)
1159 ;; this is a correct word (because a tex command)
1163 t)
1165 ;; we setup the cache
1169 ;; now check spelling of word.
1173 ;; put in verbose mode
1175 ;; we mark the ispell process so it can be killed
1176 ;; when emacs is exited without query
1178 ;; Wait until ispell has processed word.
1182 ;; (ispell-send-string "!\n")
1183 ;; back to terse mode.
1184 ;; Remove leading empty element
1186 ;; ispell process should return something after word is sent.
1187 ;; Tag word as valid (i.e., skip) otherwise
1192 ;; Else, this was a known misspelling to begin with, and
1193 ;; we should forge an ispell return value.
1196 ;; correct
1201 t)
1203 ;; correct
1208 t)
1214 t)
1219 word
1224 word
1230 word
1232 flyspell-duplicate-distance)))
1236 word
1237 (+ end
1238 flyspell-duplicate-distance))))))
1239 ;; This is a misspelled word which occurs
1240 ;; twice within flyspell-duplicate-distance.
1244 start end poss)
1246 nil)
1249 ;; Highlight the location as incorrect,
1250 ;; including offset specified in POSS.
1256 start)
1257 end poss)
1259 nil))))
1260 ;; return to original location
1263 res))))))))
1265 ;;*---------------------------------------------------------------------*/
1266 ;;* flyspell-math-tex-command-p ... */
1267 ;;* ------------------------------------------------------------- */
1268 ;;* This function uses the texmathp package to check if point */
1269 ;;* is within a TeX math environment. `texmathp' can yield errors */
1270 ;;* if the document is currently not valid TeX syntax. */
1271 ;;*---------------------------------------------------------------------*/
1275 nil
1280 ;;*---------------------------------------------------------------------*/
1281 ;;* flyspell-tex-command-p ... */
1282 ;;*---------------------------------------------------------------------*/
1284 "Return t if WORD is a TeX command."
1297 ;;*---------------------------------------------------------------------*/
1298 ;;* flyspell-get-word ... */
1299 ;;*---------------------------------------------------------------------*/
1301 "Return the word for spell-checking according to Ispell syntax.
1302 Optional argument FOLLOWING non-nil means to get the following
1303 \(rather than preceding) word when the cursor is not over a word.
1304 Optional second argument EXTRA-OTHERCHARS is a regexp of characters
1305 that may be included as part of a word (see `ispell-dictionary-alist')."
1316 flyspell-casechars
1319 extra-otherchars)
1321 did-it-once prevpt
1322 start end word)
1323 ;; find the word
1328 ;; move to front of word
1335 ispell-many-otherchars-p)
1348 ;; Now mark the word and save to string.
1350 nil
1357 ;;*---------------------------------------------------------------------*/
1358 ;;* flyspell-small-region ... */
1359 ;;*---------------------------------------------------------------------*/
1361 "Flyspell text between BEG and END."
1386 ;;*---------------------------------------------------------------------*/
1387 ;;* flyspell-external-ispell-process ... */
1388 ;;*---------------------------------------------------------------------*/
1392 ;;*---------------------------------------------------------------------*/
1393 ;;* flyspell-external-ispell-buffer ... */
1394 ;;*---------------------------------------------------------------------*/
1400 ;;*---------------------------------------------------------------------*/
1401 ;;* flyspell-external-point-words ... */
1402 ;;*---------------------------------------------------------------------*/
1404 "Mark words from a buffer listing incorrect words in order of appearance.
1405 The list of incorrect words should be in `flyspell-external-ispell-buffer'.
1406 \(We finish by killing that buffer and setting the variable to nil.)
1407 The buffer to mark them in is `flyspell-large-region-buffer'."
1411 case-fold-search)
1414 ;; Loop over incorrect words, in the order they were reported,
1415 ;; which is also the order they appear in the buffer being checked.
1417 ;; Bind WORD to the next one.
1419 ;; Here there used to be code to see if WORD is the same
1420 ;; as the previous iteration, and count the number of consecutive
1421 ;; identical words, and the loop below would search for that many.
1422 ;; That code seemed to be incorrect, and on principle, should
1423 ;; be unnecessary too. -- rms.
1427 word))
1431 ;; Iterate on string search until string is found as word,
1432 ;; not as substring.
1435 flyspell-large-region-end t)
1438 ;; Move back into the match
1439 ;; so flyspell-get-word will find it.
1446 ;; Size matches, we really found it.
1448 ;; Matches as part of a boundary-char separated
1449 ;; word.
1452 ;; Misspelling has higher length than
1453 ;; what flyspell considers the word.
1454 ;; Caused by boundary-chars mismatch.
1455 ;; Validating seems safe.
1457 ;; ispell treats beginning of some TeX
1458 ;; commands as nroff control sequences
1459 ;; and strips them in the list of
1460 ;; misspelled words thus giving a
1461 ;; non-existent word. Skip if ispell
1462 ;; is used, string is a TeX command
1463 ;; (char before beginning of word is
1464 ;; backslash) and none of the previous
1465 ;; conditions match.
1470 t
1471 nil))))
1474 ;; Search for next misspelled word will begin from
1475 ;; end of last validated match.
1477 ;; Record if misspelling is not found and try new one
1482 ;; we are done
1484 ;; Warn about not found misspellings
1487 ;; Kill and forget the buffer with the list of incorrect words.
1491 ;;*---------------------------------------------------------------------*/
1492 ;;* flyspell-process-localwords ... */
1493 ;;* ------------------------------------------------------------- */
1494 ;;* This function is used to prevent marking of words explicitly */
1495 ;;* declared correct. */
1496 ;;*---------------------------------------------------------------------*/
1499 case-fold-search
1501 ;; Get localwords from the original buffer
1504 ;; Localwords parsing copied from ispell.el.
1507 string)
1508 ;; buffer-local words separated by a space, and can contain
1509 ;; any character other than a space. Not rigorous enough.
1513 ;; This can fail when string contains a word with invalid chars.
1514 ;; Error handling needs to be added between Ispell and Emacs.
1518 ;; Remove localwords matches from misspellings-buffer.
1519 ;; The usual mechanism of communicating the local words to ispell
1520 ;; does not affect the special ispell process used by
1521 ;; flyspell-large-region.
1530 ;;* ---------------------------------------------------------------
1531 ;;* flyspell-check-region-doublons
1532 ;;* ---------------------------------------------------------------
1534 "Check for adjacent duplicated words (doublons) in the given region."
1546 ;;*---------------------------------------------------------------------*/
1547 ;;* flyspell-large-region ... */
1548 ;;*---------------------------------------------------------------------*/
1559 ;; this is done, we can start checking...
1563 ;; Local dictionary becomes the global dictionary in use.
1570 c)
1580 ispell-current-personal-dictionary)))))
1582 ;; Check for extended character mode
1589 ;; Add ispell-extra-args
1592 ;; If we are using recent aspell or hunspell, make sure we use the right encoding
1593 ;; for communication. ispell or older aspell/hunspell does not support this
1605 end
1606 ispell-program-name
1607 nil
1608 buffer
1609 nil
1611 args)))
1621 ;;*---------------------------------------------------------------------*/
1622 ;;* flyspell-region ... */
1623 ;;* ------------------------------------------------------------- */
1624 ;;* Because `ispell -a' is too slow, it is not possible to use */
1625 ;;* it on large region. Then, when ispell is invoked on a large */
1626 ;;* text region, a new `ispell -l' process is spawned. The */
1627 ;;* pointed out words are then searched in the region a checked with */
1628 ;;* regular flyspell means. */
1629 ;;*---------------------------------------------------------------------*/
1630 ;;;###autoload
1632 "Flyspell text between BEG and END."
1636 ()
1646 ;;*---------------------------------------------------------------------*/
1647 ;;* flyspell-buffer ... */
1648 ;;*---------------------------------------------------------------------*/
1649 ;;;###autoload
1651 "Flyspell whole buffer."
1655 ;;*---------------------------------------------------------------------*/
1656 ;;* old next error position ... */
1657 ;;*---------------------------------------------------------------------*/
1661 ;;*---------------------------------------------------------------------*/
1662 ;;* flyspell-goto-next-error ... */
1663 ;;*---------------------------------------------------------------------*/
1665 "Go to the next previously detected error.
1666 In general FLYSPELL-GOTO-NEXT-ERROR must be used after
1667 FLYSPELL-BUFFER."
1675 ;; goto beginning of buffer
1681 ;; seek the next error
1691 ;; save the current location for next invocation
1698 ;;*---------------------------------------------------------------------*/
1699 ;;* flyspell-overlay-p ... */
1700 ;;*---------------------------------------------------------------------*/
1702 "Return true if O is an overlay used by flyspell."
1705 ;;*---------------------------------------------------------------------*/
1706 ;;* flyspell-delete-region-overlays, flyspell-delete-all-overlays */
1707 ;;* ------------------------------------------------------------- */
1708 ;;* Remove overlays introduced by flyspell. */
1709 ;;*---------------------------------------------------------------------*/
1711 "Delete overlays used by flyspell in a given region."
1715 "Delete all the overlays used by flyspell."
1718 ;;*---------------------------------------------------------------------*/
1719 ;;* flyspell-unhighlight-at ... */
1720 ;;*---------------------------------------------------------------------*/
1722 "Remove the flyspell overlay that are located at POS."
1732 ;;*---------------------------------------------------------------------*/
1733 ;;* flyspell-properties-at-p ... */
1734 ;;* ------------------------------------------------------------- */
1735 ;;* Is there an highlight properties at position pos? */
1736 ;;*---------------------------------------------------------------------*/
1738 "Return t if there is a text property at POS, not counting `local-map'.
1739 If variable `flyspell-highlight-properties' is set to nil,
1740 text with properties are not checked. This function is used to discover
1741 if the character at POS has any other property."
1750 ;;*---------------------------------------------------------------------*/
1751 ;;* make-flyspell-overlay ... */
1752 ;;*---------------------------------------------------------------------*/
1754 "Allocate an overlay to highlight an incorrect word.
1755 BEG and END specify the range in the buffer of that word.
1756 FACE and MOUSE-FACE specify the `face' and `mouse-face' properties
1757 for the overlay."
1764 ;; If misspelled text has a 'keymap' property, let that remain in
1765 ;; effect for the bindings that flyspell-mouse-map doesn't override.
1771 flyspell-before-incorrect-word-string))
1774 flyspell-after-incorrect-word-string)))
1775 overlay))
1777 ;;*---------------------------------------------------------------------*/
1778 ;;* flyspell-highlight-incorrect-region ... */
1779 ;;*---------------------------------------------------------------------*/
1781 "Set up an overlay on a misspelled word, in the buffer from BEG to END.
1782 POSS is usually a list of possible spelling/correction lists,
1783 as returned by `ispell-parse-output'.
1784 It can also be the symbol `doublon', in the case where the word
1785 is itself incorrect, but suspiciously repeated."
1792 ;; we cleanup all the overlay that are in the region, not
1793 ;; beginning at the word start position
1800 ;; we cleanup current overlay at the same position
1802 ;; now we can use a new overlay
1805 beg end
1809 ;;*---------------------------------------------------------------------*/
1810 ;;* flyspell-highlight-duplicate-region ... */
1811 ;;*---------------------------------------------------------------------*/
1813 "Set up an overlay on a duplicate misspelled word, in the buffer from BEG to END.
1814 POSS is a list of possible spelling/correction lists,
1815 as returned by `ispell-parse-output'."
1822 ;; we cleanup current overlay at the same position
1824 ;; now we can use a new overlay
1827 'flyspell-duplicate
1830 ;;*---------------------------------------------------------------------*/
1831 ;;* flyspell-auto-correct-cache ... */
1832 ;;*---------------------------------------------------------------------*/
1842 ;;*---------------------------------------------------------------------*/
1843 ;;* flyspell-check-previous-highlighted-word ... */
1844 ;;*---------------------------------------------------------------------*/
1846 "Correct the closest previous word that is highlighted as misspelled.
1847 This function scans for a word which starts before point that has been
1848 highlighted by Flyspell as misspelled. If it finds one, it proposes
1849 a replacement for that word. With prefix arg N, check the Nth word
1850 before point that's highlighted as misspelled."
1855 ov ovs)
1876 ;;*---------------------------------------------------------------------*/
1877 ;;* flyspell-display-next-corrections ... */
1878 ;;*---------------------------------------------------------------------*/
1893 string))
1899 ;;*---------------------------------------------------------------------*/
1900 ;;* flyspell-abbrev-table ... */
1901 ;;*---------------------------------------------------------------------*/
1904 global-abbrev-table
1907 ;;*---------------------------------------------------------------------*/
1908 ;;* flyspell-define-abbrev ... */
1909 ;;*---------------------------------------------------------------------*/
1915 ;;*---------------------------------------------------------------------*/
1916 ;;* flyspell-auto-correct-word ... */
1917 ;;*---------------------------------------------------------------------*/
1919 "Correct the current word.
1920 This command proposes various successive corrections for the current word."
1922 ;; If we are not in the construct where flyspell should be active,
1923 ;; invoke the original binding of M-TAB, if that was recorded.
1933 ;; Use the correct dictionary.
1937 ;; We have already been using the function at the same location.
1949 flyspell-auto-correct-word)
1951 flyspell-auto-correct-word
1952 word)
1959 ;; Fetch the word to be checked.
1965 poss ispell-filter)
1967 ;; Now check spelling of word..
1970 ;; Wait until ispell has processed word.
1974 ;; Remove leading empty element.
1976 ;; Ispell process should return something after word is sent.
1977 ;; Tag word as valid (i.e., skip) otherwise.
1984 ;; Don't correct word.
1985 t)
1987 ;; Ispell error.
1990 ;; The word is incorrect, we have to propose a replacement.
1992 word)))
2000 ;; the save the current replacements
2008 replacements)
2017 word
2018 new-word)
2020 new-word)))
2026 old-max))))))))))
2030 ;;*---------------------------------------------------------------------*/
2031 ;;* flyspell-auto-correct-previous-pos ... */
2032 ;;*---------------------------------------------------------------------*/
2036 ;;*---------------------------------------------------------------------*/
2037 ;;* flyspell-auto-correct-previous-hook ... */
2038 ;;*---------------------------------------------------------------------*/
2040 "Hook to track successive calls to `flyspell-auto-correct-previous-word'.
2041 Sets `flyspell-auto-correct-previous-pos' to nil"
2047 ;;*---------------------------------------------------------------------*/
2048 ;;* flyspell-auto-correct-previous-word ... */
2049 ;;*---------------------------------------------------------------------*/
2051 "Auto correct the first misspelled word that occurs before point.
2052 But don't look beyond what's visible on the screen."
2066 ;; only reset if a new overlay exists
2072 ;; search for previous (new) flyspell overlay
2075 ;; check if its face has changed
2082 ;; if nothing new exits new-overlay should be nil
2094 ;; the point may have moved so reset this
2097 ;;*---------------------------------------------------------------------*/
2098 ;;* flyspell-correct-word ... */
2099 ;;*---------------------------------------------------------------------*/
2102 "Pop up a menu of possible corrections for a misspelled word.
2103 The word checked is the word at the mouse position."
2110 "Pop up a menu of possible corrections for misspelled word before point.
2111 If EVENT is non-nil, it is the mouse event that invoked this operation;
2112 that controls where to put the menu.
2113 If OPOINT is non-nil, restore point there after adjusting it for replacement."
2115 ;; use the correct dictionary
2124 poss ispell-filter)
2125 ;; now check spelling of word.
2128 ;; wait until ispell has processed word
2132 ;; Remove leading empty element
2134 ;; ispell process should return something after word is sent.
2135 ;; Tag word as valid (i.e., skip) otherwise
2142 ;; don't correct word
2143 t)
2145 ;; ispell error
2148 ;; The word is incorrect, we have to propose a replacement.
2150 poss word cursor-location start end opoint)))
2153 ;;*---------------------------------------------------------------------*/
2154 ;;* flyspell-do-correct ... */
2155 ;;*---------------------------------------------------------------------*/
2157 "The popup menu callback."
2160 nil)
2183 replace
2186 cursor-location)))
2196 nil)))
2198 ;;*---------------------------------------------------------------------*/
2199 ;;* flyspell-adjust-cursor-point ... */
2200 ;;*---------------------------------------------------------------------*/
2212 ;;*---------------------------------------------------------------------*/
2213 ;;* flyspell-emacs-popup ... */
2214 ;;*---------------------------------------------------------------------*/
2216 "The Emacs popup menu."
2221 mouse-pos
2232 corrects)
2233 '()))
2235 show-affix-info
2247 save)))
2251 ispell-dictionary))
2252 menu)))))
2254 ;;*---------------------------------------------------------------------*/
2255 ;;* Some example functions for real autocorrecting */
2256 ;;*---------------------------------------------------------------------*/
2258 "Check replacements for transposed characters.
2260 If the text between BEG and END is equal to a correction suggested by
2261 Ispell, after transposing two adjacent characters, correct the text,
2262 and return t.
2264 The third arg POSS is either the symbol `doublon' or a list of
2265 possible corrections as returned by `ispell-parse-output'.
2267 This function is meant to be added to `flyspell-incorrect-hook'."
2285 nil)))
2288 "Check replacements for doubled characters.
2290 If the text between BEG and END is equal to a correction suggested by
2291 Ispell, after removing a pair of doubled characters, correct the text,
2292 and return t.
2294 The third arg POSS is either the symbol `doublon' or a list of
2295 possible corrections as returned by `ispell-parse-output'.
2297 This function is meant to be added to `flyspell-incorrect-hook'."
2311 nil)))
2313 ;;*---------------------------------------------------------------------*/
2314 ;;* flyspell-already-abbrevp ... */
2315 ;;*---------------------------------------------------------------------*/
2320 ;;*---------------------------------------------------------------------*/
2321 ;;* flyspell-change-abbrev ... */
2322 ;;*---------------------------------------------------------------------*/
2328 ;;; flyspell.el ends here