(emacs)Spelling


Prev: Fixing Case Up: Fixit

Checking and Correcting Spelling
================================

   This section describes the commands to check the spelling of a single
word or of a portion of a buffer.

`M-$'
     Check and correct spelling of word at point (`ispell-word').

`M-x ispell-buffer'
     Check and correct spelling of each word in the buffer.

`M-x ispell-region'
     Check and correct spelling of each word in the region.

`M-x ispell-string RET WORD RET'
     Check spelling of WORD.

`M-x ispell-complete-word'
     Complete the word before point based on the spelling dictionary.

`M-x reload-ispell'
     Make the Ispell subprocess reread your private dictionary.

`M-x kill-ispell'
     Kill the Ispell subprocess.

   To check the spelling of the word around or next to point, and
optionally correct it as well, use the command `M-$' (`ispell-word').
If the word is not correct, the command offers you various alternatives
for what to do about it.

   To check the entire current buffer, use `M-x ispell-buffer'.  Use
`M-x ispell-region' to check just the current region.  Each time these
commands encounter an incorrect word, they ask you what to do.

   Whenever one of these commands finds an incorrect word, it displays a
list of alternatives, usually including several "near-misses"--words
that are close to the word being checked.  Here are the valid responses:

`SPC'
     Skip this word--continue to consider it incorrect, but don't
     change it here.

`r NEW RET'
     Replace the word (just this time) with NEW.

`DIGIT'
     Replace the word (just this time) with one of the displayed
     near-misses.  Each near-miss is listed with a digit; type that
     digit to select it.

`a'
     Accept the incorrect word--treat it as correct, but only in this
     editing session.

`i'
     Insert this word in your private dictionary file so that Ispell
     will consider it correct it from now on, even in future sessions.

`l REGEXP RET'
     Look in the dictionary for words that match REGEXP.  These words
     become the new list of "near-misses"; you can select one of them to
     replace with by typing a digit.

`C-g'
     Quit interactive spell checking.  You can restart it again
     afterward with `C-u M-$'.

   The command `ispell-complete-word', which is bound to the key
`M-TAB' in Text mode and related modes, performs completion based on
spelling correction.  Insert the beginning of a word, and then type
`M-TAB'; the command inserts as many more letters as can be uniquely
determined from the letters in the buffer, based on your currently
loaded dictionaries.  Note: Text Mode.

   The first time you use any of the spell checking commands, it starts
an Ispell subprocess.  The first thing the subprocess does is read your
private dictionary, which is the file `~/ispell.words'.  Words that you
"insert" with the `i' command are added to that file, but not right
away--only at the end of the interactive replacement procedure.  Use
the `M-x reload-ispell' command to reload your private dictionary from
`~/ispell.words' if you edit the file outside of Ispell.

   Once started, the Ispell subprocess continues to run (waiting for
something to do), so that subsequent spell checking commands complete
more quickly.  If you want to get rid of the Ispell process, use `M-x
kill-ispell'.  This is not usually necessary, since the process uses no
time except when you do spelling correction.


automatically generated by info2www