aspell [options] <command>
aspell is a utility program that connects to the Aspell library so that
it can function as an ispell -a replacement, as an independent spell
checker, as a test utility to test out Aspell library features, and as
a utility for managing dictionaries used by the library.
The Aspell library contains an interface allowing other programs direct
access to its functions and therefore reducing the complex task of
spell checking to simple library calls. The default library does not
contain dictionary word lists. To add language dictionaries, please
check your distro first for modified dictionaries, otherwise look here
for base language dictionaries <http://aspell.net>.
The following information describes the commands and options used by
the Aspell Utility.
This manual page is maintained separately from the official documenta-
tion so it may be out of date or incomplete. The official documenta-
tion is maintained as a Texinfo manual. See the `aspell' entry in info
for more complete documentation.
<command> is one of:
Send a brief Aspell Utility usage message to standard output.
This is a short summary listing more common spell-check commands
help Send a detailed Aspell Utility help message to standard output.
This is a complete list showing all commands, options, filters
Print version number of Aspell Library and Utility to standard
check <file>, -c <file>
Spell-check a single file.
Run Aspell in ispell -a compatibility mode.
list Produce a list of misspelled words from standard input.
Dump all current configuration options to standard output.
Send the current value of <key> to standard output.
munch-list [simple] [single|multi] [keep]
Reduce the size of a word list via affix compression.
conv <from> <to> [<norm-form>]
Converts <from> one encoding <to> another.
norm (<norm-map>|<from> <norm-map> <to>) [<norm-form>]
Perform Unicode normalization.
Lists available dictionaries, filters, or modes.
dump|create|merge master|personal|repl <wordlist>
dump, create, or merge a master, personal, or replacement word
The following options may be used to control which dictionaries to use
and how they behave.
--master=<name>, -d <name>
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 dictionary word list.
--lang=<string>, -l <string>
Language to use. It follows the same format of the LANG envi-
ronmental variable on most systems. It consists of the two let-
ter 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 locale.
The preferred size of the dictionary word list. This consists
of a two char digit code describing the size of the list, with
typical values of: 10=tiny, 20=really small, 30=small, 40=med-
small, 50=med, 60=med-large, 70=large, 80=huge, 90=insane.
Any extra information to distinguish this variety of dictionary
from other dictionaries which may have the same lang and size.
Please use the variety option since it replaces jargon as a bet-
ter choice. jargon will be removed in the future.
--word-list-path=<list of directories>
Search path for word list information files.
--personal=<file>, -p <file>
Personal word list file name.
--ignore=<integer>, -W <integer>
Ignore words <= <integer> characters in length.
Ignore case when checking words.
Ignore commands to store replacement pairs.
Save the replacement word list on save all.
Suggestion <mode> = ultra|fast|normal|bad-spellers
These options modify the behavior of the various filters.
Add or remove a filter.
Add or remove paths searched for filters.
--mode=<string>, -e, -H, -t, -n
Sets the filter mode. Mode is one of none, url, email, html,
tex or nroff. The alternative shortcut options are '-e' for
email, '-H' for Html/Sgml, '-t' for Tex or '-n' for Nroff.
encoding the document is expected to be in. The default depends
on the current locale.
Add or Remove a list of email quote characters.
Number of chars that can appear before the quote char.
Add or remove a list of HTML attributes to always check. For
example, look inside alt= tags.
Add or remove a list of HTML attributes to always skip while
Add or remove a list of SGML attributes to always check for
Add or remove a list of SGML attributes to always skip while
These may be used to control the behavior of run-together words.
--run-together, --dont-run-together, -C, -B
Consider run-together words valid.
Maximum number of words that can be strung together.
Minimal length of interior words.
Miscellaneous options that don't fall under any other category.
Main configuration file. This file overrides Aspell's global
Location of main configuration file.
Location of language data files.
Use this keyboard layout for suggesting possible words. These
spelling errors happen if a user accidently presses a key next
to the intended correct key.
Alternative location of language data files. This directory is
searched before data-dir.
Directory Location for personal wordlist files.
Personal configuration file. This file overrides options found
in the global config file.
ASPELL UTILITY OPTIONS
These options are part of the aspell Utility and work independently of
--backup, --dont-backup, -b, -x
The aspell utility creates a backup file by making a copy and
appending .bak to file name. This only applies when the command
is check <file> and the backup file is only created if any
spelling modifications take place.
Use byte offsets instead of character offsets.
--guess, --dont-guess, -m, -P
will simply report the misspelling and make no attempt at sug-
gestions or possible corrections.
Time the load time and suggest a time in pipe mode.
In addition Aspell will try to make sense out of Ispell's 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 accept options via global or personal configuration files so
that you do not need to specify them each time at the command line.
The default global configuration file is /etc/aspell.conf or another
file specified by option --conf and is checked first. The default per
user configuration file ~/.aspell.conf located in the $HOME directory
(or another file specified by option --per-conf) is checked next and
overrides options set in the global config file. Options specified at
either the command line or via an environmental variable override those
specified by either configuration file.
Each line of the configuration file has the format:
where 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 Swiss German:
There may be 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. The /etc/aspell.conf file is a good example of how
to set these options and the Aspell Manual has more detailed info.
aspell-import(1), prezip-bin(1), run-with-aspell(1), word-list-com-
Aspell is fully documented in its Texinfo manual. See the `aspell'
entry in info for more complete documentation.
Support for Aspell can be found on the Aspell mailing lists. Instruc-
tions for joining the various mailing lists (and an archive of them)
can be found off the Aspell home page at <http://aspell.net>. Bug
reports should be submitted via the Sourceforge Tracker rather than
being posted to the mailing lists.
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2016
All Rights Reserved.