aspell: Spellchecking Individual Files
1
1 3.1 Spellchecking Individual Files
1 ==================================
1
1 To use Aspell to spellcheck a file use:
1
1 aspell check [OPTIONS] FILENAME
1
1 at the command line where `FILENAME' is the file you want to check and
1 `OPTIONS' is any number of optional options. Some of the more useful
1 ones include:
1
1 -mode=MODE
1 the mode to use when checking files. The available modes are
1 `none', `url', `email', `sgml', `tex', `texinfo', `nroff', among
11 others. For more information on the various modes see ⇒Notes
on Various Filters and Filter Modes.
1
1 -dont-backup
1 don't create a backup file. Normally, if there are any corrections
1 the Aspell utility will append `.bak' to the existing file name
1 and then create a new file with corrections made during spell
1 checking.
1
1 -sug-mode=MODE
1 the suggestion mode to use where mode is one of `ultra', `fast',
1 `normal', or `bad-spellers'. For more information on these modes
1 see ⇒Notes on the Different Suggestion Modes.
1
1 -lang=NAME/-l NAME
1 the language the document is written in. The default depends on
1 the current locale.
1
1 -encoding=NAME
1 encoding the document is expected to be in. The default depends
1 on the current locale.
1
1 -master=NAME/-d NAME
1 the main dictionary to use.
1
1 -keymapping=NAME
1 the keymapping to use. Either `aspell' for the default mapping or
1 `ispell' to use the same mapping that the Ispell utility uses.
1
11 For more information on the available options, please see ⇒
Customizing Aspell.
1
1 For example to check the file `foo.txt':
1
1 aspell check foo.txt
1
1 and to check the file `foo.txt' using the `bad-spellers' suggestion
1 mode and the American English dictionary:
1
1 aspell check --sug-mode=bad-spellers -d en_US foo.txt
1
1 If the `mode' option is not given, then Aspell will use the
1 extension of the file to determine the current mode. If the extension
1 is `.tex', then `tex' mode will be used, if the extension is `.html',
1 `.htm', `.php', or `.sgml' it will check the file in `sgml' mode,
1 otherwise it will use `url' mode.
1
1 For more information on the various modes that can be used, see
1 ⇒Notes on Various Filters and Filter Modes.
1
1 If Aspell was compiled with curses support and the `TERM'
1 environment variable is set to a capable terminal type then Aspell will
1 use a nice full screen interface, otherwise it will use a simpler
1 "dumb" terminal interface where the misspelled word is surrounded by
1 two '*'. In either case the interface should be self explanatory.
1
1 If Aspell is compiled with a version of the curses library that
1 support wide characters then Aspell can also check UTF-8 text.
1 Furthermore, the document will be displayed in the encoding defined by
1 the current locale. This encoding does not necessarily have to be the
1 same encoding that the document is in. This means that is is possible
1 to check an 8-bit encoding such as ISO-8859-1 on an UTF-8 terminal. To
1 do so simply set the `encoding' option to `iso-8859-1'. Furthermore it
1 is also possible to check an UTF-8 document on an 8-bit terminal
1 provided that the document can be successfully converted into that
1 encoding.
1