aspell: Upgrading from Aspell 0.50

1 
1 E.5 Upgrading from Aspell 0.50
1 ==============================
1 
1 The dictionary format has changed so dictionaries will need to be
1 recompiled.
1 
1    All data, by default, is now included in `LIBDIR/aspell-0.60' so
1 that multiple versions of Aspell can more peacefully coexist.  This
1 included both the dictionaries and the language data files which were
1 stored in `SHAREDIR/aspell' before Aspell 0.60.
1 
1    The format of the character data files has changed.  The new
1 character data files are installed with Aspell so you should not have
1 to worry about it unless you made a custom one.
1 
1    The dictionary option `strip-accents' has been removed.  For this
1 reason the old English dictionary (up to 0.51) will no longer work.  A
1 new English dictionary is now available which avoids using this option.
1 In addition the `ignore-accents' option is currently unimplemented.
1 
1    The flag `-l' is now a shortcut for `--lang', instead of `--list' as
1 it was with Aspell 0.50.
1 
1 E.5.1 Binary Compatibility
1 --------------------------
1 
1 The Aspell 0.60 library is binary compatible with the Aspell 0.50
1 library.  For this reason I chose _not_ to increment the major version
1 number (so-name) of the shared library by default which means programs
1 that were compiled for Aspell 0.50 will also work for Aspell 0.60.
1 However, this means that having both Aspell 0.50 and Aspell 0.60
1 installed at the same time can be pragmatic.  If you wish to allow both
1 Aspell 0.50 and 0.60 to be installed at the same time then you can use
1 the configure option `--incremented-soname' which will increment
1 so-name.  You should only use this option if you know what you are
1 doing.  It is up to you to somehow ensure that both the Aspell 0.50 and
1 0.60 executables can coexist.
1 
1    If after incrementing the so-name you wish to allow programs compiled
1 for Aspell 0.50 to use Aspell 0.60 instead (thus implying that Aspell
1 0.50 is not installed) then you can use a special compatibility library
1 which can be found in the `lib5' directory.  This directory will not be
1 entered when building or installing Aspell so you must manually build
1 and install this library.  You should build it after the rest of Aspell
1 is built.  The order in which this library is installed, with relation
1 to the rest of Aspell, is also important.  If it is installed _after_
1 the rest of Aspell then new programs will link to the old library
1 (which will work for Aspell 0.50 or 0.60) when built, if installed
1 _before_, new programs will link with the new library (Aspell 0.60
1 only).
1