Homepage: https://www.gnu.org/software/emacs
Author: Ken Stevens
Interface to spell checkers
INSTRUCTIONS
Use the variable `ispell-local-dictionary-alist' to specify
your own dictionaries.
Depending on the mail system you use, you may want to include these:
(add-hook 'news-inews-hook #'ispell-message)
(add-hook 'mail-send-hook #'ispell-message)
(add-hook 'mh-before-send-letter-hook #'ispell-message)
Ispell has a TeX parser and a nroff parser (the default).
The parsing is controlled by the variable ispell-parser. Currently
it is just a "toggle" between TeX and nroff, but if more parsers are
added it will be updated. See the variable description for more info.
TABLE OF CONTENTS
ispell-word
ispell-region
ispell-buffer
ispell-message
ispell-comments-and-strings
ispell-comment-or-string-at-point
ispell-continue
ispell-complete-word
ispell-complete-word-interior-frag
ispell-change-dictionary
ispell-kill-ispell
ispell-pdict-save
ispell-skip-region-alist
Commands in ispell-region:
Character replacement: Replace word with choice. May query-replace.
` ': Accept word this time.
`i': Accept word and insert into private dictionary.
`a': Accept word for this session.
`A': Accept word and place in buffer-local dictionary.
`r': Replace word with typed-in value. Rechecked.
`R': Replace word with typed-in value. Query-replaced in buffer. Rechecked.
`?': Show these commands
`x': Exit spelling buffer. Move cursor to original point.
`X': Exit spelling buffer. Leaves cursor at the current point, and permits
the check to be completed later.
`q': Quit spelling session (Kills ispell process).
`l': Look up typed-in replacement in alternate dictionary. Wildcards okay.
`u': Like `i', but the word is lower-cased first.
`m': Place entered value in personal dictionary, then recheck current word.
`C-l': redraws screen
`C-r': recursive edit
`C-z': suspend Emacs or iconify frame
Buffer-Local features:
There are a number of buffer-local features that can be used to customize
ispell for the current buffer. This includes language dictionaries,
personal dictionaries, parsing, and local word spellings. Each of these
local customizations are done either through local variables, or by
including the keyword and argument(s) at the end of the buffer (usually
prefixed by the comment characters). See the end of this file for
examples. The local keywords and variables are:
ispell-dictionary-keyword language-dictionary
uses local variable ispell-local-dictionary
ispell-pdict-keyword personal-dictionary
uses local variable ispell-local-pdict
ispell-parsing-keyword mode-arg extended-char-arg
ispell-words-keyword any number of local word spellings
Region skipping:
Place new regular expression definitions of regions you prefer not to
spell check in `ispell-skip-region-alist'. Mode-dependent features can
be added to latex by modifying `ispell-tex-skip-alists'.
`ispell-message' contains some custom skipping code for e-mail messages.
BUGS:
Need a way to select between different character mappings without separate
dictionary entries.
Multi-byte characters if not defined by current dictionary may result in the
evil "misalignment error" in some versions of Emacs.
On some versions of Emacs, growing the minibuffer fails.
see `ispell-help-in-bufferp'.
Recursive edits (?C-r or ?R) inside a keyboard text replacement check (?r)
can cause misalignment errors.