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