Node: How Aspell Selects an Appropriate Dictionary, Next: Listing Available Dictionaries, Previous: Using aspell-import, Up: Working With Dictionaries
If the master
option is set in any fashion (via the command
line, the ASPELL_CONF
environment variable, or a configuration
file) Aspell will look for a dictionary of that name. If one could
not be found, it will complain.
Otherwise it will use the value of the lang
option to search
for an appropriate dictionary. If more than one dictionary is found
for the given language string then it will look for a dictionary with
a matching variety if the variety
option is set. If it is not
set it will look for a dictionary without a variety. If after matching
the lang
and variety
there is still more than one
dictionary available it will find one with the size closest to the
value of the size
option. The default size is 60. If Aspell
cannot find a dictionary based on the lang
option then it
will give up and complain.
If the lang
option is not explicitly set its value will be
based on the LC_MESSAGES
locale. This locale is generally taken
from the LC_MESSAGES
environment variable or the LANG
environment variable if LC_MESSAGES
is not set. However, if
Aspell is being used as a library from within another program which
already explicitly set the locale then it will use the locale of the
library rather than the environment variables. If Aspell cannot
determine the language from the LC_MESSAGES
locale than it will
default to en_US
.
The list option dict-alias
can be used to influence which dictionary
is selected by creating an alias from one dictionary name to another.
This option is most useful when there is more than one dictionary for a
given language. For example add-dict-alias en_US en_US-w_accents
will cause Aspell to choose the accented version of the American English
dictionary instead of the non-accented version. To add an alias use:
add-dict-alias NAME VAL