
                             Aspell .33 alpha                             
                        A More Intelligent Ispell                         
                                                                          
                              Kevin Atkinson                              
                     kevina at users sourceforge net                      

--------------------------------------------------------------------------
   
  * Contents
  * 1. Introduction
      + 1.1 Comparison to other spell checker engines
          o 1.1.1 Comparison to Ispell
              # 1.1.1.1 Features that only Aspell has
              # 1.1.1.2 Things that only Aspell will have real soon
              # 1.1.1.3 Things that, currently, only Ispell have
  * 2. Getting Started
      + 2.1 Requirements
      + 2.2 Obtaining
      + 2.3 Support
      + 2.4 Helping Out
      + 2.5 Compiling & Installing
          o 2.5.1 Generic Install Instructions
          o 2.5.2 General Problems
          o 2.5.3 Win32 Notes
          o 2.5.4 Compiling with Egcs and Gcc 2.8
          o 2.5.5 Upgrading from version .32.6
          o 2.5.6 Upgrading from version .32.1
          o 2.5.7 Upgrading from version .31.1
          o 2.5.8 Upgrading from version .30
          o 2.5.9 Upgrading from version .29.1
          o 2.5.10 Upgrading from version .29
          o 2.5.11 Upgrading from version .28.3
          o 2.5.12 Upgrading from version .28.2.1
          o 2.5.13 Upgrading from version .27.2
          o 2.5.14 Upgrading from version .25
          o 2.5.15 Upgrading from version .24
  * 3. Basic Usage
      + 3.1 Spellchecking Individual Files
      + 3.2 Using Aspell with other Applications
          o 3.2.1 With Applications that Expect Ispell
          o 3.2.2 With Emacs and Xemacs
          o 3.2.3 With LyX
          o 3.2.4 With VIM
          o 3.2.5 With Pine
  * 4. Managing Word Lists
      + 4.1 Creating an Individual Word List
          o 4.1.1 Format of the Replacement Word List
      + 4.2 Dumping the contents of the word list
  * 5. Customizing Aspell
      + 5.1 Specifying Options
          o 5.1.1 At the Command Line
              # 5.1.1.1 Boolean
              # 5.1.1.2 Value
              # 5.1.1.3 List
          o 5.1.2 Via a Configuration File
              # 5.1.2.1 Boolean
              # 5.1.2.2 Value
              # 5.1.2.3 List
          o 5.1.3 Via an Environmental Variable
      + 5.2 The Options
          o 5.2.1 Basic Options
          o 5.2.2 Dictionary Options
          o 5.2.3 Run-together Word Options
          o 5.2.4 Filter Options
          o 5.2.5 Aspell Utility Options
      + 5.3 Dumping Configuration Values
      + 5.4 Notes on various Options
          o 5.4.1 Pertaining to which word lists to use
          o 5.4.2 Notes on various filters and filter mode
              # 5.4.2.1 None Mode
              # 5.4.2.2 Url Filter/Mode
              # 5.4.2.3 Email Filter/Mode
              # 5.4.2.4 SGML Filter/Mode
              # 5.4.2.5 TEX Filter/Mode
          o 5.4.3 Notes on typo-analysis and the keyboard defination
            file
          o 5.4.4 Notes on the different suggestion modes
  * 6. Writing programs to use Aspell
      + 6.1 Though the Pspell API
          o 6.1.1 Notes About Thread Safety
      + 6.2 Through A Pipe
          o 6.2.1 Format of the Data Stream
      + 6.3 Notes of Storing Replacement Pairs
  * 7. International Support
      + 7.1 The Language Data File
      + 7.2 Compiling the Word List
      + 7.3 Phonetic Code
          o 7.3.1 Syntax of the transformation array
          o 7.3.2 How do I start finally?
              # 7.3.2.1 Things that come in handy
              # 7.3.2.2 What the phonetic code should do
      + 7.4 Controling the Behaviour of Run-together Words
  * 8. How Aspell Works
  * A. Changelog
      + Changes from .32.6 to .33 (August 28, 2000)
      + Changes from .32.5 to .32.6 (Nov 8, 2000)
      + Changes from .32.1 to .32.5 (August 18, 2000)
      + Changes from .32 to .32.1 (August 5, 2000)
      + Changes from .31.1 to .32 (July 23, 2000)
      + Changes from .31 to .31.1 (June 18, 2000)
      + Changes from .30.1 to .31 (June 11, 2000)
      + Changes from .30 to .30.1 (April 29, 2000)
      + Changes from .29.1 to .30 (April 2, 2000)
      + Changes from .29 to .29.1 (Feb 18, 2000)
      + Changes from .28.3 to .29 (Feb 6, 2000)
      + Changes from .28.2.1 to .28.3 (Nov 20, 1999)
      + Changes from .28.2 to .28.2.1 (Aug 25, 1999)
      + Changes from .28.1 to .28.2 (Aug 25, 1999)
      + Changes from .28 to .28.1 (July 27, 1999)
      + Changes from .27.2 to .28 (July 25, 1999)
      + Changes from .27.1 to .27.2 (Mar 1, 1999)
      + Changes from .27 to .27.1 (Feb 24, 1999)
      + Changes from .26.2 to .27 (Feb 22, 1999)
      + Changed from .26.1 to .26.2 (Jan 3, 1998)
      + Changed from .26 to .26.1 (Jan 3, 1998)
      + Changed from .25.1 to .26 (Jan 3, 1999)
      + Changes from .25 to .25.1 (Dec 10, 1998)
      + Changes from .24 to .25 (Nov 23, 1998)
      + Changes from .23 to .24 (Nov 8, 1998)
      + Changes from .22.1 to .23 (Oct 31, 1998)
      + Changes from .22 to .22.1 (Oct 27, 1998)
      + Changes from .21 to .22 (Oct 26, 1998)
      + Changes from .20 to .21 (Oct 13, 1998)
      + Changes from .11 to .20 (Oct 10, 1998)
      + Changes from .10 to .11 (Sep 12, 1998)
  * B. To Do
      + B.1 Things that will be done real soon
      + B.2 Things that need to be done
      + B.3 Things that I would like to get done
      + B.4 Things that will be done eventually
      + B.5 Good ideas that are worth implementing
      + B.6 Things that are not likely to get implemented
      + B.7 Notes and Status of various items
          o B.7.1 Affix Compression
          o B.7.2 Extremely Large Dictionaries
          o B.7.3 General region skipping
          o B.7.4 Word skipping by context
          o B.7.5 Hidden Markov Model
          o B.7.6 Email the Personal Dictionary
          o B.7.7 Words With Spaces in Them
  * C. Support for Gcc 2.7.2
  * D. Credits
  * E. Glossary and References
  * F. Copyright
      + F.1 LGPL
      + F.2 Ispell Copyright
  * About this document ...


--------------------------------------------------------------------------

