Next: 
Notes-on-the-Different-Suggestion-Modes.html#Notes-on-the-Different-Suggestion-ModesNotes on the Different Suggestion Modes ,
Previous: 
Notes-on-the-Prefix-Option.html#Notes-on-the-Prefix-OptionNotes on the Prefix Option ,
Up: 
Notes-on-Various-Options.html#Notes-on-Various-OptionsNotes on Various Options 4.4.3 Notes on Typo-Analysis and the Keyboard Definition File
Aspell .33 and better will, in general, give a higher priority to
certain misspellings which are likely to be due to typos such as
teh instead of the or hapoy instead of
happy.  However in order to do this well Aspell needs to know the
layout of the keyboard via the keyboard definition file.  The keyboard
definition file simply identifies the keys on the keyboard and which of
them are right next to each other.  It has an extension of 
.kbdand all non-ASCII characters are expected to be in UTF-8.
   
To identify a key use:
     key base other ...
   
where base is the base character that the key types, and
other are other keys that the key can produce.  For example
     key a A á Á
   
It generally is only necessary to list keys which type more than one
distinct letter as Aspell can derive the rest from the language data
file.  For example, it is not necessary to include the previously
mentioned key.
   
To identify two keys as being right next to each other simply list the
type keys right after each other.  For example the line:
     as
   
will indicate that `a' and `s' are right next to each other. 
If `
as' is listed as a entry it is not necessary to list `sa'
as an entry as that will be done automatically.  Also by 
right
next to each other
 I mean two keys that are close enough together that
it is easy to type one instead of the other.  On most keyboards this
means keys that are to the left or to the right of each other and
not keys that are below or above it.
   
The default for this option is normally standard.  However
the default can be changed via the language data file.  The normal
default, 
standard, should work well for most QWERTY like
keyboard layouts.  It may need minor adjusting for foreign keyboards. 
The 
dvorak option can be used for a Dvorak layout.
   
