5.2 How Aspell Selects an Appropriate Dictionary

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