6c5c6b73a9de929f9aad3bf8c97ddc38a9ba1eac
[platform/upstream/aspell.git] / manual / aspell.html / Upgrading-from-Aspell-0_002e50.html
1 <html lang="en">
2 <head>
3 <title>Upgrading from Aspell 0.50 - 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="Installing.html#Installing" title="Installing">
9 <link rel="prev" href="Loadable-Filter-Notes.html#Loadable-Filter-Notes" title="Loadable Filter Notes">
10 <link rel="next" href="Upgrading-from-Aspell-_002e33_002fPspell-_002e12.html#Upgrading-from-Aspell-_002e33_002fPspell-_002e12" title="Upgrading from Aspell .33/Pspell .12">
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="Upgrading-from-Aspell-0.50"></a>
44 <a name="Upgrading-from-Aspell-0_002e50"></a>
45 Next:&nbsp;<a rel="next" accesskey="n" href="Upgrading-from-Aspell-_002e33_002fPspell-_002e12.html#Upgrading-from-Aspell-_002e33_002fPspell-_002e12">Upgrading from Aspell .33/Pspell .12</a>,
46 Previous:&nbsp;<a rel="previous" accesskey="p" href="Loadable-Filter-Notes.html#Loadable-Filter-Notes">Loadable Filter Notes</a>,
47 Up:&nbsp;<a rel="up" accesskey="u" href="Installing.html#Installing">Installing</a>
48 <hr>
49 </div>
50
51 <h3 class="appendixsec">E.5 Upgrading from Aspell 0.50</h3>
52
53 <p>The dictionary format has changed so dictionaries will need to be
54 recompiled.
55
56    <p>All data, by default, is now included in <samp><var>libdir</var><span class="file">/aspell-0.60</span></samp> so
57 that multiple versions of Aspell can more peacefully coexist.  This
58 included both the dictionaries and the language data files which were
59 stored in <samp><var>sharedir</var><span class="file">/aspell</span></samp> before Aspell 0.60.
60
61    <p>The format of the character data files has changed.  The new character
62 data files are installed with Aspell so you should not have to worry
63 about it unless you made a custom one.
64
65    <p>The dictionary option <samp><span class="option">strip-accents</span></samp> has been removed.  For
66 this reason the old English dictionary (up to 0.51) will no longer
67 work.  A new English dictionary is now available which avoids using
68 this option.  In addition the <samp><span class="option">ignore-accents</span></samp> option is
69 currently unimplemented.
70
71    <p>The flag <samp><span class="option">-l</span></samp> is now a shortcut for <samp><span class="option">--lang</span></samp>, instead of
72 <samp><span class="option">--list</span></samp> as it was with Aspell 0.50.
73
74    <p><a name="Binary-Compatibility"></a>
75
76 <h4 class="appendixsubsec">E.5.1 Binary Compatibility</h4>
77
78 <p>The Aspell 0.60 library is binary compatible with the Aspell 0.50
79 library.  For this reason I chose <em>not</em> to increment the major
80 version number (so-name) of the shared library by default which means
81 programs that were compiled for Aspell 0.50 will also work for Aspell
82 0.60.  However, this means that having both Aspell 0.50 and Aspell 0.60
83 installed at the same time can be pragmatic.  If you wish to allow both
84 Aspell 0.50 and 0.60 to be installed at the same time then you can use
85 the configure option <samp><span class="option">--incremented-soname</span></samp> which will increment
86 so-name.  You should only use this option if you know what you are
87 doing.  It is up to you to somehow ensure that both the Aspell 0.50 and
88 0.60 executables can coexist.
89
90    <p>If after incrementing the so-name you wish to allow programs compiled
91 for Aspell 0.50 to use Aspell 0.60 instead (thus implying that Aspell
92 0.50 is not installed) then you can use a special compatibility library
93 which can be found in the <samp><span class="file">lib5</span></samp> directory.  This directory will
94 not be entered when building or installing Aspell so you must manually
95 build and install this library.  You should build it after the rest of
96 Aspell is built.  The order in which this library is installed, with
97 relation to the rest of Aspell, is also important.  If it is installed
98 <em>after</em> the rest of Aspell then new programs will link to the old
99 library (which will work for Aspell 0.50 or 0.60) when built, if
100 installed <em>before</em>, new programs will link with the new library
101 (Aspell 0.60 only).
102
103    </body></html>
104