aspell: Upgrading from Aspell .33/Pspell .12

1 
1 E.6 Upgrading from Aspell .33/Pspell .12
1 ========================================
1 
1 Aspell has undergone an extremely large number of changes since the
1 previous Aspell/Pspell release.  For one thing Pspell has been merged
1 with Aspell so there in no longer two separate libraries you have to
1 worry about.
1 
1    Because of the massive changes between Aspell/Pspell and Aspell 0.50
1 you may want to clean out the old files before installing the the new
1 Aspell.  To do so do a `make uninstall' in the original Aspell and
1 Pspell source directories.
1 
1    The way dictionaries are handled has also changed.  This includes a
1 change in the naming conventions of both language names and
1 dictionaries.  Due to the language name change, your old personal
1 dictionaries will not be recognized.  However, you can import the old
1 dictionaries by running the `aspell-import' script.  This also means
1 that dictionaries designed to work with older versions of Aspell are
1 not likely to function correctly.  Fortunately new dictionary packages
1 are available for most languages.  You can find them off of the Aspell
1 home page at `http://aspell.net'.
1 
1    The Pspell ABI is now part of Aspell except that the name of
1 everything has changed due to the renaming of Pspell to Aspell.  In
1 particular please note the following name changes:
1 
1      pspell -> aspell
1      manager -> speller
1      emulation -> enumeration
1      master_word_list -> main_word_list
1 
1    Please also note that the name of the `language-tag' option has
1 changed to `lang'.  However, for backward compatibility the
1 `language-tag' option will still work.
1 
1    However, you should also be able to build applications that require
1 Pspell with the new Aspell as a backward compatibility header file is
1 provided.
1 
1    Due to a change in the way dictionaries are handled, scanning for
1 `.pwli' files in order to find out which dictionaries are available
1 will no longer work.  This means that programs that relied on this
1 technique may have problems finding dictionaries.  Fortunately, GNU
1 Aspell now provided a uniform way to list all installed dictionaries
1 via the c API.  See the file `list-dicts.c' in the `examples/'
1 directory for an example of how to do this.  Unfortunately there isn't
1 any simple way to find out which dictionaries are installed which will
1 work with both the old Aspell/Pspell and the new GNU Aspell.
1