Typo
[linux_from_scratch_hints.git] / OLD / abiword.txt
blobc9f0b1434a74d0f9ca1c64398747b6af59367780
1 TITLE:          Installation of Abiword
2 LFS VERSION:    any
3 AUTHOR:         J. E. Garrot, Sr <johnga@primenet.com>
5 SYNOPSIS:
6         How to install Abiword from source.
8 HINT:
9 Abiword is quite easy to install, but there are a couple of
10 gotcha's.  Note that I did not install the gnome version.
12 The URL for the sources is:
14     http://www.abisource.com/downloads/Version-0.7.11/lf/
16 or, if you prefer:
18     ftp://ftp.abisources.com/releases/0.7.1/src/lf
20 The required files and approximate sizes (for Linux only :)
21 (Actually, you have a choice.  You can download .zip versions
22 of the following. . .if you wish.)
24     abi-0.7.11.tar.gz           4.4M
25     abidistfiles-0.7.11.tar.gz  546k
26     expat-0.7.11.tar.gz          65k
27     libiconv-0.7.11.tar.gz      1.4M
28     libpng-0.7.11.tar.gz        228k
29     unixfonts-0.7.11.tar.gz     1.8M
30     wv-0.7.11.tar.gz            1.1M
31     zlib-0.7.11.tar.gz          168k
33 You don't have to download anything that you already have,
34 except xpat.  It is important that the other files are untarred
35 and unzipped in the same directory as abi-0.7.11
37 In addition, you must have XFree86 installed.  I used 4.01, but
38 3.3.6 should work fine.
40 Also gtk, glib, gdk, etc.  Version 2.2 or higher.
42 After downloading the necessary files, untar and unzip them
43 in whatever directory you wish.  (I build everything in /usr/src,
44 but this is arbritrary.)
46 BUILD_DIR=/usr/src   (You don't have to set a shell variable.  Just
47 substitute the value whereever $BUILD_DIR occurs below.)
49 Preparation:
51     Now, because I know you didn't read the Developer's FAQ . . .:-)
52     I will tell you how to build the shared version.  (You didn't make
53     static versions of everything, including XFree86, did you?)
55     First, cd to $BUILD_DIR/abi-0.7.11/src/config/platforms
57     Then edit the file linux.mk, changing "UNIX_CAN_BUILD_STATIC=1"
58     to "UNIX_CAN_BUILD_STATIC=0".  (Without the quotes, naturally :)
60     No, you are not done yet.  We now come to the reason I decided to
61     write this little note.  The following edit is not in the FAQ.
63     cd to $BUILD_DIR/abi-0.7.11/src/config/require/unix and
64     edit the Makefile.
66     Change all occurances of "libz.a" to "libz.so".
67     Change all occurances of "libpng.a" to "libpng.so".
68     Again without the quotes in both cases.
70 Compiling:
72     You may wish to install the binaries somewhere else.
73     INSTALL_DIR=/usr/local  (See the comment to BUILD_DIR above.)
75     cd $BUILD_DIR
77     ln -s abi-0.7.11 abi
78     cd abi
80     Simple way:
82         make
83         make install
85     Harder, but nicer:
87         make distribution prefix=$INSTALL_DIR \
88         ABI_BUILD_VERSION=0.7.11 ABI_DIST_TARGET=<fmt>
90         where <fmt> is one of 'tgz', 'rpm', 'deb', 'slp', 'pkg'.
92         This will place the appropriate file(s) in abi/dist.  They
93         may then be installed in the normal manner.  If you want to
94         install in /usr/local, then leave out the prefix= argument.
96         Well, since this is a hint, in abi/dist there is a file,
97         abisuite-0.7.11-Linux_i386_shared.tar.gz.  Untar this somewhere,                enter the resulting abisuite-0.7.11-Linux_i386_shared directory
98         and run install.sh.  You should now be up and running.
100         Try typing "abiword &".  It should come up.  (What?  You didn't
101         forget to put $INSTALL_DIR in your path, I hope.)
103 Now save $BUILD_DIR/abi-0.7.11/dist/abisuite-0.7.11-Linux_i386_shared.tar.gz
104 to whereever you save such things.  (If you're not going to save it,
105 why did you create it in the first place?)
107 If you have any problems, the best place to air them is at
108 lfs-apps@linuxfromscratch.org, so others can possibly benefit from
109 the answers.  However, I will certainly try to answer any questions
110 on this install that are directed to me privately.
111 Just remember, it may be a case of the blind leading the blind.