OLD/aviword.txt

   1 TITLE:          Abiword
   2 LFS VERSION:    any
   3 AUTHOR:         J. E. Garrott Sr <johnga@primenet.com>
   4
   5 SYNOPSIS:
   6         How to install Abiword shared.
   7
   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.
  11
  12 The URL for the sources is:
  13
  14         http://www.abisource.com/downloads/Version-x.y.zz/lf/
  15
  16         where x.y.zz is currently 0.7.13
  17
  18 or, if you prefer:
  19
  20         ftp.abisources.com/releases/x.y.zz/src/lf
  21
  22
  23 The required files and approximate sizes (for Linux only :)
  24 (Actually, you have a choice.  You can download .zip versions
  25 of the following. . .if you wish.)
  26
  27     abi-x.y.zz.tar.gz           4.4M
  28     abidistfiles-x.y.zz.tar.gz  546k
  29     expat-x.y.zz.tar.gz          65k
  30     libiconv-x.y.zz.tar.gz      1.4M
  31     libpng-x.y.zz.tar.gz        228k
  32     unixfonts-x.y.zz.tar.gz     1.8M
  33     wv-x.y.zz.tar.gz            1.1M
  34     zlib-x.y.zz.tar.gz          168k
  35
  36
  37 You don't have to download anything, such as zlib or libpng that
  38 you already have, except xpat.  It is likely that your don't have
  39 anything else.  It is also important that the other
  40 files are untarred and unzipped in the same directory as abi-x.y.zz
  41
  42 In addition, you must have XFree86 installed.  I used 3.3.6, 4.01,
  43 and 4.02.
  44
  45 Also gtk, glib, gdk, etc.  Version 2.2 or higher.
  46
  47 After downloading the necessary files, untar and unzip them
  48 in whatever directory you wish.  (I build everything in /usr/src,
  49 but this is arbritrary.)
  50
  51 BUILD_DIR=/usr/src   (You don't have to set a shell variable.  Just
  52 substitute the value whereever $BUILD_DIR occurs below.)
  53
  54 Preparation:
  55
  56         Now, because I know you didn't read the Developer's FAQ . . .:-)
  57         I will tell you how to build the shared version.  (You didn't make
  58         static versions of everything, including XFree86, did you?)
  59
  60         First, cd to $BUILD_DIR/abi/src/config/platforms
  61         (Below 0.7.13, cd to $BUILD_DIR/abi-x.y.zz/src/config/platforms)
  62
  63         Then edit the file linux.mk, changing "UNIX_CAN_BUILD_STATIC=1"
  64         to "UNIX_CAN_BUILD_STATIC=0".  (Without the quotes, naturally :)
  65
  66
  67         No, you are not done yet.  We now come to the reason I decided to
  68         write this little note.  The following edit is not in the FAQ.
  69
  70         cd to $BUILD_DIR/abi/src/config/require/unix and
  71         (Below 0.7.13, cd to $BUILD_DIR/abi-x.y.zz/src/config/require/unix and)
  72         edit the Makefile.
  73
  74         Change all occurances of "libz.a" to "libz.so".
  75         Change all occurances of "libpng.a" to "libpng.so".
  76         Again without the quotes in both cases.
  77
  78         Note:   For version 0.7.13, you must also edit the file
  79                         $BUILD_DIR/psiconv/psiconv/generate_layout.c
  80                         Line 81 contains the C++ comment "// Unknown byte".
  81                         Delete this line or wrap it in a C comment.
  82
  83 Compiling:
  84
  85         You may wish to install the binaries somewhere else.
  86         INSTALL_DIR=/usr/local  (See the comment to BUILD_DIR above.)
  87
  88         cd $BUILD_DIR
  89
  90         for versions below 0.7.13, ln -s abi-x.y.zz abi
  91
  92         cd abi
  93
  94         Simple way:
  95                 make
  96                 make install
  97
  98         Harder, but nicer:
  99                 make distribution prefix=$INSTALL_DIR \
 100                         ABI_BUILD_VERSION=x.y.zz ABI_DIST_TARGET=<fmt>
 101                 where <fmt> is one of 'tgz', 'rpm', 'deb', 'slp', 'pkg'.
 102                 This will place the appropriate file(s) in abi/dist.  They
 103                 may then be installed in the normal manner.  If you want to
 104                 install in /usr/local, then leave out the prefix= argument.
 105
 106                 Well, since this is a hint, in abi/dist there is a file,
 107                 abisuite-x.y.zz-Linux_i386_shared.tar.gz.  Untar this somewhere,
 108                 enter the resulting abisuite-x.y.zz-Linux_i386_shared directory
 109                 and run install.sh.  You should now be up and running.
 110
 111                 Try typing "abiword &".  It should come up.  (What?  You didn't
 112                 forget to put $INSTALL_DIR in your path, I hope.)
 113
 114                 NOTE:   I had to compile as root.  When I compiled as a user,
 115                                 the compile bombed out at the file ev_UnixToolbar.cpp.
 116                                 Haven't traced this down yet.
 117
 118 Now save $BUILD_DIR/abi-x.y.zz/dist/abisuite-x.y.zz-Linux_i386_shared.tar.gz
 119 to whereever you save such things.  (If you're not going to save it,
 120 why did you create it in the first place?)
 121
 122 If you have any problems, the best place to air them is at
 123 lfs-apps@linuxfromscratch.org, so others can possibly benefit from
 124 the answers.  However, I will certainly try to answer any questions
 125 on this install that are directed to me privately.
 126 Just remember, it may be a case of the blind leading the blind.