manual/aspell.html/Notes-on-Typo_002dAnalysis.html

   1 <html lang="en">
   2 <head>
   3 <title>Notes on Typo-Analysis - GNU Aspell 0.60.6.1</title>
   4 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   5 <meta name="description" content="Aspell 0.60.6.1 spell checker user's manual.">
   6 <meta name="generator" content="makeinfo 4.8">
   7 <link title="Top" rel="start" href="index.html#Top">
   8 <link rel="up" href="Notes-on-Various-Options.html#Notes-on-Various-Options" title="Notes on Various Options">
   9 <link rel="prev" href="Notes-on-the-Prefix-Option.html#Notes-on-the-Prefix-Option" title="Notes on the Prefix Option">
  10 <link rel="next" href="Notes-on-the-Different-Suggestion-Modes.html#Notes-on-the-Different-Suggestion-Modes" title="Notes on the Different Suggestion Modes">
  11 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
  12 <!--
  13 This is the user's manual for Aspell
  14
  15 GNU Aspell is a spell checker designed to eventually replace Ispell.
  16 It can either be used as a library or as an independent spell checker.
  17
  18 Copyright (C) 2000--2011 Kevin Atkinson.
  19
  20      Permission is granted to copy, distribute and/or modify this
  21      document under the terms of the GNU Free Documentation License,
  22      Version 1.1 or any later version published by the Free Software
  23      Foundation; with no Invariant Sections, no Front-Cover Texts and
  24      no Back-Cover Texts.  A copy of the license is included in the
  25      section entitled "GNU Free Documentation License".
  26    -->
  27 <meta http-equiv="Content-Style-Type" content="text/css">
  28 <style type="text/css"><!--
  29   pre.display { font-family:inherit }
  30   pre.format  { font-family:inherit }
  31   pre.smalldisplay { font-family:inherit; font-size:smaller }
  32   pre.smallformat  { font-family:inherit; font-size:smaller }
  33   pre.smallexample { font-size:smaller }
  34   pre.smalllisp    { font-size:smaller }
  35   span.sc    { font-variant:small-caps }
  36   span.roman { font-family:serif; font-weight:normal; }
  37   span.sansserif { font-family:sans-serif; font-weight:normal; }
  38 --></style>
  39 </head>
  40 <body>
  41 <div class="node">
  42 <p>
  43 <a name="Notes-on-Typo-Analysis"></a>
  44 <a name="Notes-on-Typo_002dAnalysis"></a>
  45 Next:&nbsp;<a rel="next" accesskey="n" href="Notes-on-the-Different-Suggestion-Modes.html#Notes-on-the-Different-Suggestion-Modes">Notes on the Different Suggestion Modes</a>,
  46 Previous:&nbsp;<a rel="previous" accesskey="p" href="Notes-on-the-Prefix-Option.html#Notes-on-the-Prefix-Option">Notes on the Prefix Option</a>,
  47 Up:&nbsp;<a rel="up" accesskey="u" href="Notes-on-Various-Options.html#Notes-on-Various-Options">Notes on Various Options</a>
  48 <hr>
  49 </div>
  50
  51 <h4 class="subsection">4.4.3 Notes on Typo-Analysis and the Keyboard Definition File</h4>
  52
  53 <p>Aspell .33 and better will, in general, give a higher priority to
  54 certain misspellings which are likely to be due to typos such as
  55 <code>teh</code> instead of <code>the</code> or <code>hapoy</code> instead of
  56 <code>happy</code>.  However in order to do this well Aspell needs to know the
  57 layout of the keyboard via the keyboard definition file.  The keyboard
  58 definition file simply identifies the keys on the keyboard and which of
  59 them are right next to each other.  It has an extension of <samp><span class="file">.kbd</span></samp>
  60 and all non-ASCII characters are expected to be in UTF-8.
  61
  62    <p>To identify a key use:
  63
  64 <pre class="example">     key <var>base</var> <var>other</var> ...
  65 </pre>
  66    <p class="noindent">where <var>base</var> is the base character that the key types, and
  67 <var>other</var> are other keys that the key can produce.  For example
  68
  69 <pre class="example">     key a A &aacute; &Aacute;
  70 </pre>
  71    <p>It generally is only necessary to list keys which type more than one
  72 distinct letter as Aspell can derive the rest from the language data
  73 file.  For example, it is not necessary to include the previously
  74 mentioned key.
  75
  76    <p>To identify two keys as being right next to each other simply list the
  77 type keys right after each other.  For example the line:
  78
  79 <pre class="example">     as
  80 </pre>
  81    <p class="noindent">will indicate that `<samp><span class="samp">a</span></samp>' and `<samp><span class="samp">s</span></samp>' are right next to each other.
  82 If `<samp><span class="samp">as</span></samp>' is listed as an entry it is not necessary to list `<samp><span class="samp">sa</span></samp>'
  83 as an entry as that will be done automatically.  Also by <dfn>right
  84 next to each other</dfn> I mean two keys that are close enough together that
  85 it is easy to type one instead of the other.  On most keyboards this
  86 means keys that are to the left or to the right of each other and
  87 <em>not</em> keys that are below or above it.
  88
  89    <p>The default for this option is normally <samp><span class="option">standard</span></samp>.  However
  90 the default can be changed via the language data file.  The normal
  91 default, <samp><span class="option">standard</span></samp>, should work well for most QWERTY like
  92 keyboard layouts.  It may need minor adjusting for foreign keyboards.
  93 The <samp><span class="option">dvorak</span></samp> option can be used for a Dvorak layout.
  94
  95    </body></html>
  96