speller/aspell/doc/extra.txt

   1 INFORMATION ON THE PROVIDED DICTIONARIES
   2
   3 This word list package supports the following dialects of English:
   4
   5   American (en_US)
   6   British with "ise" spelling (en_GB-ise)
   7   British with "ize" spelling (en_GB-ize)
   8   Canadian (en_CA)
   9
  10 In addition generic English (en) is supported which is a combination
  11 of all the above.
  12
  13 For each dialect there is the option to either strip accents (for
  14 example cafe) or keep them (for example café).  The default is to
  15 strip them.
  16
  17 Combining these two options gives the following dictionaries.
  18
  19   en_US-wo_accents
  20   en_US-w_accents
  21   en_GB-ise-wo_accents
  22   en_GB-ise-w_accents
  23   en_GB-ize-wo_accents
  24   en_GB-ize-w_accents
  25   en_CA-wo_accents
  26   en_CA-w_accents
  27   en-wo_accents
  28   en-w_accents
  29
  30 in addition to the following aliases:
  31
  32   en_US = en_US-wo_accents
  33   en_GB = en_GB-ise-wo_accents
  34   en_GB-ise = en_GB-ise-wo_accents
  35   en_GB-ize = en_GB-ize-wo_accents
  36   en_GB-wo_accents = en_GB-ise-wo_accents
  37   en_GB-w_accents = en_GB-ize-w_accents
  38   en_CA = en_CA-wo_accents
  39   en = en-wo_accents
  40
  41   american-* = en_US-*
  42   britsh-* = en_GB-*
  43   canadian-* = en_CA-*
  44   english-* = en-*
  45
  46 If you are using Aspell 0.60 these aliases can be changed locally via
  47 "dict-alias" option.  For example if you prefer the "ize" spelling for
  48 British English add the line:
  49
  50   add-dict-alias en_GB en_GB-ize
  51
  52 to ".aspell.conf".
  53
  54 Great care has been taken so that that, for the most part, only one
  55 spelling for any particular word is included in the main dictionary.
  56 When two variants were considered equal I randomly picked one for
  57 inclusion in the main word list.  Unfortunately this means that my
  58 choice in how to spell a word may not match your choice.  For this
  59 reason the following auxiliary dictionaries are provided:
  60
  61   en_US-variant_0
  62   en_US-variant_1
  63   en_GB-variant_0
  64   en_GB-variant_1
  65   en_CA-variant_0
  66   en_CA-variant_1
  67   en-variant_2
  68
  69 These dictionaries are meant to be used in addition to one of the
  70 standard dictionaries. To specify them use the "extra-dicts" option.
  71 The "en_*-variant_0" dictionaries includes most variants which are
  72 considered almost equal, "variant_1" includes variants which are
  73 generally considered acceptable, and "variant_2" contains variants
  74 which are seldom used and may not even be considered correct.  It is
  75 only necessary to use on of these dictionaries since, for example,
  76 "en_US-variant_1" includes all the words in "en_US-variant_0".
  77
  78
  79 UPGRADING FROM ASPELL6-EN-0.01
  80
  81 If you are upgrading from the aspell6-en-0.01 package you should do a
  82
  83   rm `aspell config dict-dir`/en[-_]*.alias
  84
  85 to remove any old alias.  Otherwise aspell may get confused as this
  86 version installs the alias with the ".multi" extension instead of
  87 the ".alias" extension.