The following options may be used to control which dictionaries to use
and how they behave.
base name of the dictionary to use. If this option is specified then
Aspell will either use this dictionary or die.
location of the main word list
language to use, it follows the same format of the LANG environmental
variable on most systems. It consists of the two letter ISO 639 language
code and an optional two letter ISO 3166 country code after a dash or
underscore. The default value is based on the value of the LC_MESSAGES
the preferred size of the word list
an extra information to distinguish two different words lists that have
the same lang and size.
search path for word list information files
list of available modules, modules that come first on this list have a
higher priority. Currently there is only one speller module.
These options modify the behavior of the various filters.
add or removes a filter
sets the filter mode. Mode is one if none, url, email, sgml, or
tex. (The short cut options -e may be used for email, -H for
Html/Sgml, or -t for Tex)
The encoding the input text is in. Valid values are utf-8,
iso8859-*, koi8-r, viscii, cp1252, machine unsigned
16, machine unsigned 32. However, the Aspell utility will
currently only function correctly with 8-bit encodings. utf-8 support is
planned for the future. The two machine unsigned encodings are
intended to be used by other programs using the Aspell library and it
is unlikely the Aspell utility will ever support these encodings.
email quote characters
number of chars that can appear before the quote char
create a backup file by appending
.bak to the file name. Only applies when the command is check.
time load time and suggest time in pipe mode.
reverse the order of the suggestions list
the keymapping to use, either
aspell for the default mapping or
ispell to use the same mapping that the ispell utility uses
In addition Aspell will try to make sense out of ispells command line
options so that it can function as a drop in replacement for ispell. If
Aspell is run without any command line options it will display a brief help
screen and quit.
Aspell can also accept options via a personal or global configuration
file. The exact files to used are specified by the options per-conf and
conf respectfully but the personal configuration file is normally
.aspell.conf located in the
Each line of the configuration file has the format:
option is any one of the standard library options above without the leading
dashes. For example the following line will set the default language to
There may any number of spaces between the option and the value however
it can only be spaces, i.e. there is no = between the option name and
the value. Comments may also be included by preceding them with a # as
anything from a # to a newline is ignored. Blank lines are also
allowed. Values set in the personal configuration file override those
in the global file. Options specified at either the command line or via
an environmental variable override those specified by either
The global configuration file for Aspell is
/etc/aspell.conf and the per user configuration file is