| 1 |
<?xml version="1.0" encoding="UTF-8"?> |
| 2 |
<!DOCTYPE html PUBLIC "-//ABISOURCE//DTD XHTML plus AWML 2.2//EN" "http://www.abisource.com/2004/xhtml-awml/xhtml-awml.mod"> |
| 3 |
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:awml="http://www.abisource.com/2004/xhtml-awml/"> |
| 4 |
<head> |
| 5 |
<!-- ======================================================= --> |
| 6 |
<!-- Created by AbiWord, a free, Open Source wordprocessor. --> |
| 7 |
<!-- For more information visit http://www.abisource.com. --> |
| 8 |
<!-- ======================================================= --> |
| 9 |
<meta http-equiv="content-type" content="text/html;charset=UTF-8" /> |
| 10 |
<title>AbiWord Build Guide</title> |
| 11 |
<meta name="Title" content="AbiWord Build Guide" /> |
| 12 |
<meta name="Subject" content="Instructions for building AbiWord from source" /> |
| 13 |
<style type="text/css"> |
| 14 |
<!-- |
| 15 |
@media print, projection, embossed { |
| 16 |
body { |
| 17 |
padding-top:1in; |
| 18 |
padding-bottom:1in; |
| 19 |
padding-left:1in; |
| 20 |
padding-right:1in; |
| 21 |
} |
| 22 |
} |
| 23 |
body { |
| 24 |
text-indent:0in; |
| 25 |
text-align:left; |
| 26 |
font-variant:normal; |
| 27 |
text-decoration:none; |
| 28 |
font-weight:normal; |
| 29 |
color:#000000; |
| 30 |
font-size:12pt; |
| 31 |
font-style:normal; |
| 32 |
widows:2; |
| 33 |
font-family:'Times New Roman'; |
| 34 |
} |
| 35 |
table { |
| 36 |
} |
| 37 |
td { |
| 38 |
border-collapse:collapse; |
| 39 |
text-align:left; |
| 40 |
vertical-align:top; |
| 41 |
} |
| 42 |
p, h1, h2, h3, li { |
| 43 |
color:#000000; |
| 44 |
font-family:'Times New Roman'; |
| 45 |
font-size:12pt; |
| 46 |
text-align:left; |
| 47 |
vertical-align:normal; |
| 48 |
} |
| 49 |
h1 { |
| 50 |
font-family:'Luxi Sans'; |
| 51 |
font-size:17pt; |
| 52 |
font-weight:bold; |
| 53 |
margin-bottom:0.2056in; |
| 54 |
margin-top:0.1389in; |
| 55 |
page-break-after:avoid; |
| 56 |
} |
| 57 |
h2 { |
| 58 |
font-family:'Luxi Sans'; |
| 59 |
font-size:14pt; |
| 60 |
font-weight:bold; |
| 61 |
margin-bottom:0.0417in; |
| 62 |
margin-top:0.3056in; |
| 63 |
page-break-after:avoid; |
| 64 |
} |
| 65 |
*.normal_unspaced { |
| 66 |
} |
| 67 |
h3 { |
| 68 |
font-family:'Luxi Sans'; |
| 69 |
font-weight:bold; |
| 70 |
margin-bottom:0.0813in; |
| 71 |
margin-top:0.0813in; |
| 72 |
page-break-after:avoid; |
| 73 |
} |
| 74 |
*.heading_4 { |
| 75 |
font-weight:bold; |
| 76 |
margin-bottom:0.0813in; |
| 77 |
margin-top:0.0813in; |
| 78 |
} |
| 79 |
*.plain_text { |
| 80 |
font-family:'Courier New'; |
| 81 |
} |
| 82 |
*.command_text { |
| 83 |
color:#0000ff; |
| 84 |
font-size:10pt; |
| 85 |
} |
| 86 |
--> |
| 87 |
</style> |
| 88 |
</head> |
| 89 |
<body> |
| 90 |
<div> |
| 91 |
<h1 id="__AbiTOC0__"><span xml:lang="en-US" lang="en-US">AbiWord Build Instructions</span></h1> |
| 92 |
<p>AbiWord is a C++ application which has a cross-platform architecture consisting of a large platform-independent core and a number of front-ends which use the native GUI of each of the platforms it supports. As a consequence of this, there are a number of different build systems used by AbiWord and a large number of build options. This document gives an introductory guide to building AbiWord and attempts to cover these various build options. However, the build changes often and inevitably there will be discrepancies between this guide and the reality of building AbiWord. If you find any errors or omissions, don't be afraid to ask about them on the mailing lists, or to file bugs at <a href="http://bugzilla.abisource.com/">http://bugzilla.abisource.com/</a>.</p> |
| 93 |
<h2 id="__AbiTOC1__">Contents<a name="unix" id="unix"></a></h2> |
| 94 |
<ul> |
| 95 |
<li class="normal_unspaced"><span xml:lang="en-GB" lang="en-GB"> </span><a href="#unix">Unix</a></li> |
| 96 |
<li class="normal_unspaced"><span xml:lang="en-GB" lang="en-GB"> </span><a href="#windows">Windows</a></li> |
| 97 |
<li class="normal_unspaced"><span xml:lang="en-GB" lang="en-GB"> </span><a href="#qnx">QNX</a></li> |
| 98 |
<li class="normal_unspaced"><span xml:lang="en-GB" lang="en-GB"> </span><a href="#macosx">Mac OS X</a> </li> |
| 99 |
</ul> |
| 100 |
<h2 id="__AbiTOC2__"><span style="text-decoration:underline" xml:lang="en-US" lang="en-US">Unix</span><span style="text-decoration:underline" xml:lang="en-US" lang="en-US">:</span></h2> |
| 101 |
<h3 id="__AbiTOC3__">Prerequisites:</h3> |
| 102 |
<p><span xml:lang="en-US" lang="en-US">The principal build system on Unix systems (including Linux, Solaris, etc.) is based on the GNU automake tool. To compile and build AbiWord, you will need:</span></p> |
| 103 |
<ol> |
| 104 |
<li><span xml:lang="en-US" lang="en-US"> A </span><span xml:lang="en-US" lang="en-US">reasonably working C and C++ compiler (GNU's gcc and g++ come to mind, though others should work as well)</span></li> |
| 105 |
<li><span xml:lang="en-US" lang="en-US"> GNU's make (called gmake sometimes); see </span><a href="#nongnumake"><span xml:lang="en-US" lang="en-US">Notes on using non-GNU make</span></a><span xml:lang="en-US" lang="en-US"> below.</span></li> |
| 106 |
<li><span xml:lang="en-US" lang="en-US"> A Bourne compatible shell, such as sh, bash, zsh, ksh...</span> </li> |
| 107 |
</ol> |
| 108 |
<p id="__AbiTOC4__" class="heading_4" awml:style="Heading 4">GTK+-2.0</p> |
| 109 |
<p><span xml:lang="en-US" lang="en-US">AbiWord-2.4's Unix GUI is GTK+-2.2 based, which means that AbiWord on Unix does its drawing using the excellent GTK+ and GDK graphical tools. Therefore you will need GTK+-2.2 or 2.4 and its prerequisites installed, and their ancillary development packages. A list of the required packages and the packages themselves can be found at </span><a href="http://www.gtk.org/"><span xml:lang="en-US" lang="en-US">http://www.gtk.org/</span></a><span xml:lang="en-US" lang="en-US">. Alternately, your OS provider might have pre-built packages for you, or they might be available from some trusted third party (collectively referred to as a </span><span xml:lang="en-US" lang="en-US">"distribution") </span><span xml:lang="en-US" lang="en-US">. We always recommend going with the tools your distribution provides, but you are in no means required to do so.</span></p> |
| 110 |
<p id="__AbiTOC5__" class="heading_4" awml:style="Heading 4"><span xml:lang="en-US" lang="en-US">zlib</span></p> |
| 111 |
<p>AbiWord also requires zlib. Zlib is usually installed on every machine under the sun, even those sold by Sun<span style="vertical-align:super">TM</span>. But, if for some reason you don't have it or you just want to get it anyway, <a href="http://www.gzip.org/zlib/">http://www.gzip.org/zlib/</a> is the place for you. See also: <span class="command_text plain_text" style="">configure --with-zlib</span></p> |
| 112 |
<p id="__AbiTOC6__" class="heading_4" awml:style="Heading 4" dir="ltr"><span xml:lang="en-US" lang="en-US">libpng</span></p> |
| 113 |
<p>AbiWord also requires libpng. Like zlib, libpng is installed on most machines already. However, you may get the latest and greatest libpng here:<a href="%20http:%2f%2fwww.libpng.org/pub/png/%20"> http://www.libpng.org/pub/png/</a>. See also: <span class="command_text plain_text" style="">configure --with-libpng</span></p> |
| 114 |
<p id="__AbiTOC7__" class="heading_4" awml:style="Heading 4" dir="ltr"><span xml:lang="en-US" lang="en-US">iconv</span></p> |
| 115 |
<p>AbiWord also requires a <span style="font-style:italic">working</span> iconv implementation. Note, that thing that ships on your Solaris 8, HP/UX, or AIX box isn't considered "working." AbiWord requires GNU libiconv 1.8 or later to be installed. Most every Linux box and some BSD boxen should be in the clear here, as the standard C library ships with an equivalent version of this package. If you're not on Linux or BSD, get libiconv here: <a href="http://www.gnu.org/software/libiconv/">http://www.gnu.org/software/libiconv/</a>. See also: <span class="command_text plain_text" style="">configure --with-libiconv</span></p> |
| 116 |
<p id="__AbiTOC8__" class="heading_4" awml:style="Heading 4" dir="ltr"><span xml:lang="en-US" lang="en-US">fribidi</span></p> |
| 117 |
<p><span xml:lang="en-US" lang="en-US">AbiWord also requires the Fribidi library, version 0.10.4 or higher, which is available at </span><a href="http://sourceforge.net/projects/fribidi/"><span xml:lang="en-US" lang="en-US">http://sourceforge.net/projects/fribidi/</span></a><span xml:lang="en-US" lang="en-US">. (Note: Do not use the fribidi in AbiWord's CVS since that is for Windows only!) See also: </span><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US">configure --with-fribidi</span></p> |
| 118 |
<p id="__AbiTOC9__" class="heading_4" awml:style="Heading 4"><span xml:lang="en-US" lang="en-US">expat/libxml2</span></p> |
| 119 |
<p>AbiWord also requires an XML parser in order to work. Don't be too worried about what that means - your system probably already has a working one installed. If you're in doubt, you can go grab expat (<a href="http://sourceforge.net/projects/expat/">http://sourceforge.net/projects/expat/</a>) or (preferably) libxml2 (<a href="http://xmlsoft.org/">http://xmlsoft.org/</a>) or you can also get expat from AbiWord's CVS (<span class="command_text plain_text" style="">cvs co expat</span>). See also: <span class="command_text plain_text" style="">configure --with-expat</span> and <span class="command_text plain_text" style="">configure --with-libxml2</span></p> |
| 120 |
<p id="__AbiTOC10__" class="heading_4" awml:style="Heading 4" dir="ltr"><span xml:lang="en-US" lang="en-US">popt</span></p> |
| 121 |
<p>AbiWord also requires a little library called POPT to parse through command line arguments. POPT is probably installed on your Linux box, but if not, or if you are on most BSD or many Solaris or something else entirely that doesn't have it, you can get it here (<a href="http://developer.gnome.org/arch/misc/popt.html">http://developer.gnome.org/arch/misc/popt.html</a>) or you can also get popt from AbiWord's CVS (<span class="command_text plain_text" style="">cvs co popt</span>). See also: <span class="command_text plain_text" style="">configure --with-popt</span></p> |
| 122 |
<p id="__AbiTOC11__" class="heading_4" awml:style="Heading 4"><span xml:lang="en-US" lang="en-US">aspell/pspell</span></p> |
| 123 |
<p><span xml:lang="en-US" lang="en-US">AbiWord can optionally take advantage of the Aspell/Pspell spell checkers. Get them at </span><a href="http://aspell.net/"><span xml:lang="en-US" lang="en-US">http://aspell.net/</span></a><span xml:lang="en-US" lang="en-US"> if you're so inclined. A lot of newer distributions ship aspell/pspell. Don't worry if you don't get this, AbiWord will fall back to using its built-in ispell spell checker. Dictionaries for our ispell checker can be found at </span><a href="http://www.abisource.com/download/abispell.phtml"><span xml:lang="en-US" lang="en-US">http://www.abisource.com/download/abispell.phtml</span></a><span xml:lang="en-US" lang="en-US">. See also: </span><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US">configure --with-pspell</span></p> |
| 124 |
<p id="__AbiTOC12__" class="heading_4" awml:style="Heading 4"><span xml:lang="en-US" lang="en-US">enchant</span></p> |
| 125 |
<p><span xml:lang="en-US" lang="en-US">enchant is a new wrapper library that provides a tidy, single interface around the various dictionary libraries available, such as aspell, ispell, uspsell, myspell,... See description of enchant at </span><a href="http://www.abisource.com/enchant/"><span xml:lang="en-US" lang="en-US">http://www.abisource.com/enchant/</span></a><span xml:lang="en-US" lang="en-US">. AbiWord will use the enchant library if it finds it.</span></p> |
| 126 |
<p id="__AbiTOC13__" class="heading_4" awml:style="Heading 4"><span xml:lang="en-US" lang="en-US">Xft2/fontconfig</span></p> |
| 127 |
<p><span xml:lang="en-US" lang="en-US">AbiWord takes advantage of the Xft2/FontConfig X11 font extensions. Your copy of AbiWord will look so pretty that you'll be the envy of all of your friends, peers, and coworkers. Get these at </span><a href="http://www.fontconfig.org/"><span xml:lang="en-US" lang="en-US">http://www.fontconfig.org/</span></a><span xml:lang="en-US" lang="en-US">.</span></p> |
| 128 |
<p id="__AbiTOC15__" class="heading_4" awml:style="Heading 4"><span xml:lang="en-US" lang="en-US">perl</span></p> |
| 129 |
<p><span xml:lang="en-US" lang="en-US">AbiWord can be scripted (controlled and added onto via extensions) via a PERL interface if you so wish. PERL is available from </span><a href="http://www.perl.org/"><span xml:lang="en-US" lang="en-US">http://www.perl.org/</span></a><span xml:lang="en-US" lang="en-US">. See also: </span><span class="command_text plain_text" style="">configure --enable-scripting</span></p> |
| 130 |
<h3 id="__AbiTOC16__"><span xml:lang="en-US" lang="en-US">Getting the source:</span></h3> |
| 131 |
<p><span xml:lang="en-US" lang="en-US">Well, if you're here, you've probably downloaded the latest and greatest AbiWord sources. If not, you can always get the latest AbiWord source and binary packages from </span><a href="http://sourceforge.net/projects/abiword/"><span xml:lang="en-US" lang="en-US">http://sourceforge.net/projects/abiword/</span></a><span xml:lang="en-US" lang="en-US">. If you're more of the CVS type, you can find CVS instructions for checking out AbiWord here: </span><a href="http://www.abisource.com/developers/download.phtml"><span xml:lang="en-US" lang="en-US">http://www.abisource.com/developers/download.phtml</span></a><span xml:lang="en-US" lang="en-US">.</span></p> |
| 132 |
<p><span xml:lang="en-US" lang="en-US">If you have the big-bad source tar-ball, you can skip to the next section. If you're getting the source from CVS and are on Unix, here's what you need to cvs checkout:</span></p> |
| 133 |
<ul> |
| 134 |
<li><span xml:lang="en-US" lang="en-US"> </span><span xml:lang="en-US" lang="en-US">abi (Absolutely vital)</span></li> |
| 135 |
<li><span xml:lang="en-US" lang="en-US"> </span><span xml:lang="en-US" lang="en-US">abidistfiles (needed if you plan to make install)</span></li> |
| 136 |
<li dir="ltr" style="text-align:left"><span xml:lang="en-US" lang="en-US"> </span><span xml:lang="en-US" lang="en-US">wv (highly recommended) Note: you can also get wv release tar-balls from wvWare's official site on SourceForge, </span><a href="http://sourceforge.net/projects/wvware/"><span xml:lang="en-US" lang="en-US">http://sourceforge.net/projects/wvware/</span></a><span xml:lang="en-US" lang="en-US">. For building AbiWord, however, the version of wv can be critical and so it is usually bundled with abi; for CVS AbiWord use AbiWord's CVS wv (use cvs co -r wv-1-0-0-STABLE wv). See also: </span><span class="command_text plain_text" style="">configure --with-sys-wv</span><span xml:lang="en-US" lang="en-US">.</span></li> |
| 137 |
<li><span xml:lang="en-US" lang="en-US"> </span><span xml:lang="en-US" lang="en-US">abiword-plugins (optional, for extra importer/exporters, nifty tools, and other toys)</span> </li> |
| 138 |
</ul> |
| 139 |
<p style="margin-left:0pt;text-indent:0in"><span xml:lang="en-US" lang="en-US">And, if you don't have these already:</span></p> |
| 140 |
<ul> |
| 141 |
<li><span xml:lang="en-US" lang="en-US"> libjpeg (optional but recommended)</span></li> |
| 142 |
<li><span xml:lang="en-US" lang="en-US"> popt (if you don't have it)</span></li> |
| 143 |
<li><span xml:lang="en-US" lang="en-US"> libpng (not optional but on most systems already)</span></li> |
| 144 |
<li><span xml:lang="en-US" lang="en-US"> zlib (not optional but on most systems already)</span></li> |
| 145 |
<li><span xml:lang="en-US" lang="en-US"> expat (either this or libxml2 is required, both can be found elsewhere)</span></li> |
| 146 |
<li><span xml:lang="en-US" lang="en-US"> libiconv (if you have a missing or broken implementation)</span></li> |
| 147 |
<li><span xml:lang="en-US" lang="en-US"> psiconv (if you want to build the psion importer plugin)</span> </li> |
| 148 |
</ul> |
| 149 |
<p style="margin-left:0pt;text-indent:0in"></p> |
| 150 |
<h3 id="__AbiTOC17__">Configuring what you want built:</h3> |
| 151 |
<p>Because AbiWord uses the automake/autoconf build tools, you may already be familiar with this step and some of its more-common behaviors, quirks, and options.</p> |
| 152 |
<p><span xml:lang="en-US" lang="en-US">If you enter the "abi" directory, you'll find a little (big) shell script there named "configure." This program will help you determine what features get built into AbiWord. If you're in a rush, uninterested, or clueless, you might just try:</span></p> |
| 153 |
<p class="normal_unspaced" awml:style="Normal Unspaced"> <span class="command_text plain_text" style="">./configure</span></p> |
| 154 |
<p class="normal_unspaced" awml:style="Normal Unspaced"> <span class="command_text plain_text" style="">make</span></p> |
| 155 |
<p><span xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">make install</span></p> |
| 156 |
<p><span xml:lang="en-US" lang="en-US">which is also known as the "standard unix build practice." If you do this, more power to you. If you're interested in what you can play with, however, read on.</span></p> |
| 157 |
<p><span xml:lang="en-US" lang="en-US">Common build options:</span></p> |
| 158 |
<ul> |
| 159 |
<li><span xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">--prefix=/some/path</span><span xml:lang="en-US" lang="en-US"> will let you put AbiWord in a particular directory. </span><span class="command_text plain_text" style="">/usr</span><span xml:lang="en-US" lang="en-US"> is a </span><span xml:lang="en-US" lang="en-US">common value</span><span xml:lang="en-US" lang="en-US">, </span><span class="command_text plain_text" style="">/usr/local</span><span xml:lang="en-US" lang="en-US"> is the default.</span></li> |
| 160 |
<li><span xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">--disable-shared</span><span xml:lang="en-US" lang="en-US"> will disable building a dynamically linked version of AbiWord. This means that AbiWord will be statically-linked with libgtk2.a, libglib2.a, ... if these exist. See </span><span class="command_text plain_text" style="">--enable-static</span><span xml:lang="en-US" lang="en-US"> below.</span></li> |
| 161 |
<li><span xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">--enable-static</span><span xml:lang="en-US" lang="en-US"> will build a statically linked version of AbiWord. This means that your resulting binary will be huge, and have all of its dependencies (gtk2, glib2, etc.) included in it. Beware that many operating environments don't include the static versions of most of abi's dependencies, which are required to link</span><span xml:lang="en-US" lang="en-US"> statically</span><span xml:lang="en-US" lang="en-US">.</span></li> |
| 162 |
<li><span xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">--enable-debug</span><span xml:lang="en-US" lang="en-US"> will include useful messages and special symbols if you're a developer. If you're an ordinary user, steer clear of this option. It won't suit your palette. It definitely increases the size of the resulting binary.</span></li> |
| 163 |
<li><span xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">--enable-scripting</span><span xml:lang="en-US" lang="en-US"> will enable you to script AbiWord using PERL. This is a cool feature if you have PERL installed, so I recommend trying it out.</span></li> |
| 164 |
<li><span xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">--with-XXX</span><span xml:lang="en-US" lang="en-US"> where </span><span class="command_text plain_text" style="">XXX</span><span xml:lang="en-US" lang="en-US"> is the name of some resource/library. Options for these include "yes", "no", and a path to </span><span class="command_text plain_text" style="">XXX</span><span xml:lang="en-US" lang="en-US">'s installation directory. So one could do:</span> |
| 165 |
<ul> |
| 166 |
<li><span xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">./configure --with-pspell=no</span><span xml:lang="en-US" lang="en-US"> [don't use pspell; same as </span><span class="command_text plain_text" style="">--without-pspell</span><span xml:lang="en-US" lang="en-US">]</span></li> |
| 167 |
<li><span xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">./confi</span><span class="command_text plain_text" style="">gure --with-pspell=yes</span><span xml:lang="en-US" lang="en-US"> [use pspell, let configure try to find where it is installed; same as </span><span class="command_text plain_text" style="">--with-pspell</span><span xml:lang="en-US" lang="en-US">]</span></li> |
| 168 |
<li><span xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">./configure --with-pspell=/path/to/pspell</span><span xml:lang="en-US" lang="en-US"> [use pspell, but use the pspell found under that path] </span> </li> |
| 169 |
</ul> |
| 170 |
</li> |
| 171 |
</ul> |
| 172 |
<p>As always, <span class="command_text plain_text" style="">./configure --help</span> will help shed some more light on these, and show you some more options that I'm intentionally excluding here. In most cases, configure will do what you want. It will find all of the dependencies and create a nice build environment for the AbiWord project. Running configure without any arguments is probably a good thing to do on most Linux and BSD systems. Solaris, HP/UX, and AIX people will probably have to pass a few of the "<span class="command_text plain_text" style="">--with</span>" options to configure in order to get a working AbiWord.</p> |
| 173 |
<p>After running configure (assuming that configure worked and didn't spout any nasty messages at you), type '<span class="command_text plain_text" style="">make</span>' and go grab a cup of coffee. AbiWord can build in about 8 minutes on a P4 1800. Your build times will vary depending on your configuration options, how good your machine is, what load your machine is under, ... as usual, multi-processor machines can use the jobserver (<span class="command_text plain_text" style="">-j</span>) mode.</p> |
| 174 |
<p>When the '<span class="command_text plain_text" style="">make</span>' part of this process is finished, you will want to install AbiWord. You can achieve this through typing '<span class="command_text plain_text" style="">make install</span>' - this part may require you to be superuser (root), depending on your permissions and where you chose as your prefix (the default, /usr/local, usually requires superuser permission). You can do this through typing '<span class="command_text plain_text" style="">su</span>' or '<span class="command_text plain_text" style="">sudo</span>'. Please consult your manual pages or local system(s) administrator if you have questions.</p> |
| 175 |
<h3 id="__AbiTOC18__">NOTES FOR SOLARIS USERS:</h3> |
| 176 |
<p>If using the deprecated "diving make" build system, it may be necessary to suppress the static build ("<span class="command_text plain_text" style="">make UNIX_CAN_BUILD_STATIC=0</span>") and also, if the wv library is to be made correctly, to set "<span class="command_text plain_text" style="">CC=gcc</span>" and "<span class="command_text plain_text" style="">export CC</span>" even though the path is set to /usr/local/bin:$PATH. Please see <a href="http://bugzilla.abisource.com/show_bug.cgi?id=4200">bug 4200</a>.</p> |
| 177 |
<h3 id="__AbiTOC19__"><a name="nongnumake" id="nongnumake">NOTES ON USING NON-GNU MAKE</a>:</h3> |
| 178 |
<p>Some incarnations of '<span class="command_text plain_text" style="">make</span>', even though they are not GNU's, understand (or have an option to understand) GNU's syntax. This will work fine, if it either can be told to use GNUmakefile (as the makefile input), or (if it looks for Makefile) from wherever you've run configure do:</p> |
| 179 |
<p><span class="command_text plain_text" style="">for d in `find -name GNUmakefile | tr -d "GNUmakefile"`; do mv -f $d/GNUmakefile $d/Makefile; done</span></p> |
| 180 |
<p>This will change all files in that directory and its subdirectories named GNUmakefile to Makefile, overwriting any files named Makefile that are in the way. (Note: If you do this in abi/, and later want to try the diving make build system, you must re-extract the Makefiles or first move them to a safe place.)</p> |
| 181 |
<h2 id="__AbiTOC20__"><a name="windows" id="windows"><span style="text-decoration:underline" xml:lang="en-US" lang="en-US">Windows</span></a><span style="text-decoration:underline" xml:lang="en-US" lang="en-US">:</span></h2> |
| 182 |
<p></p> |
| 183 |
<p>There are <span xml:lang="en-US" lang="en-US">4</span><span xml:lang="en-US" lang="en-US"> different ways to build AbiWord on Windows:</span></p> |
| 184 |
<p></p> |
| 185 |
<p style="margin-left:0pt;text-indent:0in"><span xml:lang="en-US" lang="en-US"> 1. Using the so-called "diving make" build system using MSYS and MINGW (used</span></p> |
| 186 |
<p style="margin-left:0pt;text-indent:0in"><span xml:lang="en-US" lang="en-US"> for our releases at the moment)</span></p> |
| 187 |
<p style="margin-left:0pt;text-indent:0in"><span xml:lang="en-US" lang="en-US"> 2. Using the so-called "diving make" build system using</span><span xml:lang="en-US" lang="en-US"> </span><span xml:lang="en-US" lang="en-US">Microsoft Visual C++ 5.0</span></p> |
| 188 |
<p style="margin-left:0pt;text-indent:0in"><span xml:lang="en-US" lang="en-US"> or greater and the cygwin unix shell layer</span></p> |
| 189 |
<p style="margin-left:0pt;text-indent:0in"><span xml:lang="en-US" lang="en-US"> 3. Using Microsoft Visual C++ 6 or 7.1 project files</span></p> |
| 190 |
<p style="margin-left:0pt;text-indent:0in"><span xml:lang="en-US" lang="en-US"> 4. Using the autoconf style build system using </span><span xml:lang="en-US" lang="en-US">MSYS and MINGW</span></p> |
| 191 |
<p style="margin-left:0pt;text-indent:0in"></p> |
| 192 |
<p><span xml:lang="en-US" lang="en-US">Do get anything done, we first need to get the source code. </span></p> |
| 193 |
<p></p> |
| 194 |
<p><span style="font-weight:bold;font-family:'Luxi Sans'" xml:lang="en-US" lang="en-US">Getting the source (this does NOT apply to the autoconf build system; If you intend to use this, skip immediately to section 4)</span></p> |
| 195 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">There are two methods for getting the AbiWord source code; source tar.gz files and CVS.</span></p> |
| 196 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 197 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">The source tar.gz files are packaged for building AbiWord. You can find the latest version of the tar.gz on</span><span xml:lang="en-US" lang="en-US"> </span><a href="http://www.abisource.com/download/"><span xml:lang="en-US" lang="en-US">http://www.abisource.com/download/</span></a><span xml:lang="en-GB" lang="en-GB">. They will be typically labelled abiword-<version>.tar.gz. Once download you can use WinZip or command line tools from MSYS or cygwin to unpackage the file and install the abiword sources locally to your hard disk. The command line to unpackage the file from MSYS or cygwin is "tar xvfz abiword-*.tar.gz"</span><span xml:lang="en-US" lang="en-US">.</span></p> |
| 198 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 199 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">Concurrent Versions Systems (CVS) is used by the developers to maintain the source files of the project. Information on CVS can be located at there web site </span><a href="http://www.cvshome.org/"><span xml:lang="en-GB" lang="en-GB">http://www.cvshome.org/</span></a><span xml:lang="en-GB" lang="en-GB">. An excellent Window GUI for CVS is WinCVS and can be located at </span><a href="http://www.wincvs.org/"><span xml:lang="en-GB" lang="en-GB">http://www.wincvs.org/</span></a><span xml:lang="en-GB" lang="en-GB">, with links to other great CVS tools</span><span xml:lang="en-US" lang="en-US">; alternately, you can download and install the MSYS DTK which includes a CVS client.</span></p> |
| 200 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 201 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">For AbiWord, the CVSROOT environment variable should be:</span></p> |
| 202 |
<p dir="ltr" style="text-align:center;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB"> :pserver:[email protected]:/cvsroot</span></p> |
| 203 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">The password for the anoncvs user is anoncvs.</span></p> |
| 204 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 205 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">From the command line version of CVS, a user would</span><span xml:lang="en-US" lang="en-US">:</span><span xml:lang="en-GB" lang="en-GB"> </span></p> |
| 206 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 207 |
<p class="normal_unspaced" awml:style="Normal Unspaced" dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">cd c:\existing_dir_for_cvs_download</span></p> |
| 208 |
<p class="normal_unspaced" awml:style="Normal Unspaced" dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">set CVSROOT=:pserver:[email protected]:/cvsroot</span></p> |
| 209 |
<p class="normal_unspaced" awml:style="Normal Unspaced" dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">set HOME=c:\existing_dir_for_.cvspass_file</span></p> |
| 210 |
<p class="normal_unspaced" awml:style="Normal Unspaced" dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">set HOMEDRIVE=c:\</span></p> |
| 211 |
<p class="normal_unspaced" awml:style="Normal Unspaced" dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">set HOMEPATH=\existing_dir_for_.cvspass_file</span></p> |
| 212 |
<p class="normal_unspaced" awml:style="Normal Unspaced" dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">cvs login</span></p> |
| 213 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">cvs checkout <modules listed below></span></p> |
| 214 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 215 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">CVS modules required to check out are:</span></p> |
| 216 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 217 |
<ul> |
| 218 |
<li dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> abi</span></li> |
| 219 |
<li dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> abidistfiles</span><span xml:lang="en-US" lang="en-US"> (only needed for make canonical and make distribution)</span></li> |
| 220 |
<li dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-US" lang="en-US"> </span><span xml:lang="en-GB" lang="en-GB">expat</span></li> |
| 221 |
<li dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> fribidi</span></li> |
| 222 |
<li dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> libiconv</span></li> |
| 223 |
<li dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> libpng</span></li> |
| 224 |
<li dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> popt</span></li> |
| 225 |
<li dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> wv</span><span xml:lang="en-US" lang="en-US"> (use cvs co -r wv-1-0-0-STABLE wv)</span> </li> |
| 226 |
</ul> |
| 227 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 228 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">The following modules may optionally be checked out as well:</span></p> |
| 229 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 230 |
<ul> |
| 231 |
<li dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> MSVC6 (if attempting to use MSVC project files)</span></li> |
| 232 |
<li dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> MSVC71 (like the above, but for Visual Studio .Net and later)</span> </li> |
| 233 |
</ul> |
| 234 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 235 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">You will need the "zlib" library to build AbiWord. The zlib "compiled DLL" version can be found at </span><a href="http://www.gzip.org/zlib/"><span xml:lang="en-GB" lang="en-GB">http://www.gzip.org/zlib/</span></a><span xml:lang="en-GB" lang="en-GB">. </span><span xml:lang="en-US" lang="en-US">Extract the complete archive (i.e. headers, library files, and the compiled dll) to a peer directory named 'libs\zlib\'.</span></p> |
| 236 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 237 |
<br> |
| 238 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in">Note: As of the time of writing (Oct 2005), if you are using the Microsoft Visual C++ project files, you need to follow a slightly different procedure than that described above. Instead of obtaining zlib from http://www.gzip.org you need to check out the module "zlib" from CVS along with the modules listed above. You also need to check out the "psiconv" modules.</p> |
| 239 |
<br> |
| 240 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in">WARNING: The version of zlib on the CVS server is not as up to date as the version provided by www.gzip.org. As such, it almost certainly contains security vulnerabilities.</p> |
| 241 |
<br> |
| 242 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">To build the distribution installer of AbiWord, you will need the latest version of NSIS 2, as well as the md5dll and untgz plugins. These packages can be found at </span><a href="http://nsis.sourceforge.net/"><span xml:lang="en-GB" lang="en-GB">http://nsis.sourceforge.net/</span></a><span xml:lang="en-US" lang="en-US">. Additionally, the command make canonical can be used to build a directory structure useful for testing spellchecking and alternate languages. </span><span xml:lang="en-GB" lang="en-GB">Install them according to the instructions. If you do not install NSIS to C:\Program Files\NSIS, you will need to </span><span xml:lang="en-US" lang="en-US">add makensis.exe to your PATH variable.</span></p> |
| 243 |
<p></p> |
| 244 |
<h3 id="__AbiTOC21__">1.<span xml:lang="en-US" lang="en-US"> </span>Diving make using MSYS and MINGW</h3> |
| 245 |
<p><span style="font-weight:bold" xml:lang="en-US" lang="en-US">Prerequisites:</span><span xml:lang="en-US" lang="en-US"> </span><span xml:lang="en-US" lang="en-US">MSYS and MinGW free GNU build tools</span></p> |
| 246 |
<p></p> |
| 247 |
<p>MSYS and MinGW provide a Windows port of popular GNU building tools and compilers. MinGW provides the compiler, headers, and libraries to build Window binaries. Information about it and how to download it can be found at <a href="http://www.mingw.org/">http://www.mingw.org/</a>. MSYS was developed to provide MinGW an operating shell compliant with various GNU building scripts. Information on MSYS can be found at <a href="http://www.mingw.org/msys.shtml">http://www.mingw.org/msys.shtml</a>.</p> |
| 248 |
<p></p> |
| 249 |
<p><span style="font-weight:bold" xml:lang="en-US" lang="en-US">Building AbiWord</span></p> |
| 250 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-US" lang="en-US">S</span><span xml:lang="en-GB" lang="en-GB">tart MSYS</span><span xml:lang="en-US" lang="en-US"> and c</span><span xml:lang="en-GB" lang="en-GB">hange </span><span xml:lang="en-US" lang="en-US">the </span><span xml:lang="en-GB" lang="en-GB">directory to the location of where you download/installed the AbiWord source:</span></p> |
| 251 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 252 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">cd /path/to/abi</span></p> |
| 253 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 254 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">AbiWord uses a diving makefile build system. Begin the build process by typing </span></p> |
| 255 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 256 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">make</span></p> |
| 257 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 258 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">This will build the AbiWord application and any associated tools and libraries. The binary will be located in a subdirectory src/WIN32_etc.../bin or src/MINGW32_etc.../bin To build an installable executable, issue the following command</span><span xml:lang="en-US" lang="en-US">:</span></p> |
| 259 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 260 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">make distribution</span></p> |
| 261 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 262 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">A setup_abiword.exe will be built and located in a dist subdirectory, if your NSIS and plugin installs are correctly set up.</span></p> |
| 263 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">Several build options are available and are detailed in the BUILD.txt file. They are used during the build by replacing the make command above with:</span></p> |
| 264 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 265 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">make option1 option2</span></p> |
| 266 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 267 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">The following are common for the Windows build:</span></p> |
| 268 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 269 |
<p class="normal_unspaced" awml:style="Normal Unspaced" dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">ABI_BUILD_VERSION=x.y.z Set the version number for the build</span></p> |
| 270 |
<p class="normal_unspaced" awml:style="Normal Unspaced" dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">ABI_OPT_DEBUG=1 Builds a debug version of AbiWord</span></p> |
| 271 |
<p class="normal_unspaced" awml:style="Normal Unspaced" dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">ABI_OPT_PERL=1 Enables Perl scripting</span></p> |
| 272 |
<p class="normal_unspaced" awml:style="Normal Unspaced" dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">ABI_OPT_LIBJPEG=1 Enables you to view JPEG images</span></p> |
| 273 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">ABI_OPT_CURL=1 Enables automatic dictionary downloading</span></p> |
| 274 |
<p></p> |
| 275 |
<h3 id="__AbiTOC22__">2.<span xml:lang="en-US" lang="en-US"> </span>Diving make using MSYS and MINGW</h3> |
| 276 |
<p id="__AbiTOC23__" class="heading_4" awml:style="Heading 4" dir="ltr"><span xml:lang="en-US" lang="en-US">Prerequisites:</span><span xml:lang="en-US" lang="en-US"> </span><span xml:lang="en-US" lang="en-US">Microsoft Visual C++ 5.0 or greater and the cygwin unix shell layer</span></p> |
| 277 |
<p>For builders/developers with Microsoft Visual C++ (MSVC) compilers, there are two methods for building AbiWord; command line with cygwin tools (intermittently maintained, and may not work) or the Microsoft Developer Project files (actively maintained, and will work). MSVC 5 building is not actively done and will minimally require an updated Win32 platform SDK.</p> |
| 278 |
<p dir="ltr">Building via MSVC command line using cygwin tools is the traditional method for building AbiWord and is used for the release builds. You can find information about the cygwin tools at <a href="http://www.cygwin.com/">http://www.cygwin.com/</a>. Beyond the packages in the Base category during the Cygwin installation, only the "libintl1", "libiconv2" and "make" packages are required to build AbiWord. The exact programs required are: cp, cut, echo, expr, make, mkdir, pwd, rm, sed, sh (bash), tar, uname, along with cygwin specific cygpath.exe and cygwin1.dll. To obtain the source you may also want the cvs client.</p> |
| 279 |
<p dir="ltr"></p> |
| 280 |
<p dir="ltr"><span style="font-weight:bold" xml:lang="en-US" lang="en-US">Building AbiWord</span></p> |
| 281 |
<p dir="ltr"><span xml:lang="en-US" lang="en-US">Start the sygwin command/cmd shell. Run VCVARS32.BAT which sets appropriate environment variables pointing paths, includes, libs that come with MSVC. You will find this batch function typically in the bin directory under VC98. Once these environment variables are set, from the same shell, launch cygwin. Typically this is done via a cygwin.bat batch file located where you installed cygwin.</span></p> |
| 282 |
<p dir="ltr"></p> |
| 283 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">Change directory to the location of where you download/installed the AbiWord source</span><span xml:lang="en-US" lang="en-US">. Y</span><span xml:lang="en-GB" lang="en-GB">ou will need to change directory to the full path where the AbiWord source is located using the /cygdrive folder. For example, if your AbiWord source is in the /usr/src/abi directory of your Cygwin installation and Cygwin is installed in C:\cygwin, you will need to change directory to</span><span xml:lang="en-US" lang="en-US">:</span></p> |
| 284 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 285 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">cd /cygdrive/c/cygwin/usr/src/abi</span></p> |
| 286 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 287 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">AbiWord uses a diving makefile build system. Begin the build process by typing </span></p> |
| 288 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 289 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">make</span></p> |
| 290 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 291 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">This will build the AbiWord application and any associated tools and libraries. The binary will be located in a subdirectory src/WIN32_etc.../bin or src/MINGW32_etc.../bin To build an installable executable, issue the following command</span><span xml:lang="en-US" lang="en-US">:</span></p> |
| 292 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 293 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">make distribution</span></p> |
| 294 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 295 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">A setup_abiword.exe will be built and located in a dist subdirectory, if your NSIS and plugin installs are correctly set up.</span></p> |
| 296 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">Several build options are available and are detailed in the BUILD.txt file. They are used during the build by replacing the make command above with:</span></p> |
| 297 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 298 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">make option1 option2</span></p> |
| 299 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 300 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">The following are common for the Windows build:</span></p> |
| 301 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 302 |
<p class="normal_unspaced" awml:style="Normal Unspaced" dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">ABI_BUILD_VERSION=x.y.z Set the version number for the build</span></p> |
| 303 |
<p class="normal_unspaced" awml:style="Normal Unspaced" dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">ABI_OPT_DEBUG=1 Builds a debug version of AbiWord</span></p> |
| 304 |
<p class="normal_unspaced" awml:style="Normal Unspaced" dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">ABI_OPT_PERL=1 Enables Perl scripting</span></p> |
| 305 |
<p class="normal_unspaced" awml:style="Normal Unspaced" dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">ABI_OPT_LIBJPEG=1 Enables you to view JPEG images</span></p> |
| 306 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB">ABI_OPT_CURL=1 Enables automatic dictionary downloading</span></p> |
| 307 |
<p dir="ltr"></p> |
| 308 |
<h3 id="__AbiTOC24__">3.<span xml:lang="en-US" lang="en-US"> </span>Using Microsoft Visual C++ 6 or 7.1 project files</h3> |
| 309 |
<p>The <span xml:lang="en-US" lang="en-US">third</span> method is to try the MSVC6<span xml:lang="en-US" lang="en-US"> or MSVC7.1</span> project files that have been generated. These project files are actively maintained and are only available for MSVC 6.0 and <span xml:lang="en-US" lang="en-US">7.1</span>. See the "Getting the sources" section below to use CVS to download the latest versions of these project files.</p> |
| 310 |
<p></p> |
| 311 |
<p><span style="font-weight:bold" xml:lang="en-US" lang="en-US">Building AbiWord</span></p> |
| 312 |
<p><span xml:lang="en-GB" lang="en-GB">If attempting to use the MSVC project files, follow the instructions in </span><span xml:lang="en-US" lang="en-US">the</span><span xml:lang="en-GB" lang="en-GB"> README.TXT file</span><span xml:lang="en-US" lang="en-US"> located in the directory holding the project files.</span></p> |
| 313 |
<p></p> |
| 314 |
<h3 id="__AbiTOC25__">4.<span xml:lang="en-US" lang="en-US"> </span>Using the autoconf style build system using MSYS and MINGW</h3> |
| 315 |
<p dir="ltr" style="text-align:left"><span xml:lang="en-US" lang="en-US">We assume that you have a 'recent' mingw and msys installed, including a recent w32api. Furthermore we assume you are installing all software in the /home/foobar/local prefix. Make sure to change this to match your setup.</span></p> |
| 316 |
<p dir="ltr" style="text-align:left"></p> |
| 317 |
<p dir="ltr" style="text-align:left"><span xml:lang="en-US" lang="en-US">1. Prerequisites:</span></p> |
| 318 |
<ul> |
| 319 |
<li dir="ltr" style="text-align:left"><span xml:lang="en-US" lang="en-US"> </span><span xml:lang="en-US" lang="en-US"> pkgconfig, libiconv, gettext and glib</span> </li> |
| 320 |
</ul> |
| 321 |
<p dir="ltr" style="text-align:left;margin-left:0pt;text-indent:0in"></p> |
| 322 |
<p dir="ltr" style="text-align:left"><span xml:lang="en-US" lang="en-US"> Download and install the binaries and developer files from</span></p> |
| 323 |
<p dir="ltr" style="text-align:left"><span xml:lang="en-US" lang="en-US"> </span><a href="http://www.gimp.org/%7etml/gimp/win32/downloads.html"><span xml:lang="en-US" lang="en-US">http://www.gimp.org/~tml/gimp/win32/downloads.html</span></a></p> |
| 324 |
<p dir="ltr" style="text-align:left"></p> |
| 325 |
<ul> |
| 326 |
<li dir="ltr" style="text-align:left"><span xml:lang="en-US" lang="en-US"> </span><span xml:lang="en-US" lang="en-US"> popt</span> </li> |
| 327 |
</ul> |
| 328 |
<p dir="ltr" style="text-align:left;margin-left:0pt;text-indent:0in"></p> |
| 329 |
<p dir="ltr" style="text-align:left"><span xml:lang="en-US" lang="en-US"> Download and install the binaries and developer files from</span></p> |
| 330 |
<p dir="ltr" style="text-align:left"><span xml:lang="en-US" lang="en-US"> </span><a href="http://gnuwin32.sourceforge.net/packages/popt.htm"><span xml:lang="en-US" lang="en-US">http://gnuwin32.sourceforge.net/packages/popt.htm</span></a></p> |
| 331 |
<p dir="ltr" style="text-align:left"></p> |
| 332 |
<p><span xml:lang="en-US" lang="en-US">2. Start msys, and set up your environment </span>by executing:</p> |
| 333 |
<p></p> |
| 334 |
<p><span class="command_text plain_text" style=""> </span><span class="command_text plain_text" style="">export PKG_CONFIG_PATH=/home/foobar/local/lib/pkgconfig/</span></p> |
| 335 |
<p><span class="command_text plain_text" style=""> </span><span class="command_text plain_text" style="">export PATH=/home/foobar/local/bin:$PATH</span></p> |
| 336 |
<p></p> |
| 337 |
<p><span xml:lang="en-US" lang="en-US">3. </span>We will compile the rest of the AbiWord dependencies ourselves. Feel free to use<span xml:lang="en-US" lang="en-US"> </span>precompiled libraries, but we can't guarantee their correct functioning.</p> |
| 338 |
<p></p> |
| 339 |
<ul> |
| 340 |
<li><span xml:lang="en-GB" lang="en-GB"> </span>fribidi (download the source tarball from <a href="http://fribidi.org/">http://fribidi.org/</a>) </li> |
| 341 |
</ul> |
| 342 |
<p style="margin-left:0pt"></p> |
| 343 |
<p dir="ltr" style="text-align:left"><span xml:lang="en-US" lang="en-US"> </span>NOTE: You'll need to patch the fribidi sources first if you are using<span xml:lang="en-US" lang="en-US"> v</span>ersion 0.10.4 or<span xml:lang="en-US" lang="en-US"> </span>0.10.5. <span xml:lang="en-US" lang="en-US">T</span>o do this, open the file fribidi_benchmark.c, and simply remove the line <span xml:lang="en-US" lang="en-US"> </span>"#include<span xml:lang="en-US" lang="en-US"> </span><sys/times.h>", around line 31.<span xml:lang="en-US" lang="en-US"> Next, replace the contents of the function utime (void) around line 91 with the single line: return 0; (we don't need it anyway).</span></p> |
| 344 |
<p dir="ltr" style="text-align:left"></p> |
| 345 |
<p dir="ltr" style="text-align:left"> To build fribidi, execute the following commands (where x.y.z is the fribidi version number):</p> |
| 346 |
<p dir="ltr" style="text-align:left"></p> |
| 347 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">cd fribidi-x.y.z</span></p> |
| 348 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">./configure --prefix=/home/foobar/local</span></p> |
| 349 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">make</span></p> |
| 350 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">make install</span></p> |
| 351 |
<p dir="ltr" style="text-align:left"></p> |
| 352 |
<ul> |
| 353 |
<li dir="ltr" style="text-align:left"><span xml:lang="en-GB" lang="en-GB"> </span> zlib (download the source tarball from <a href="http://www.zlib.net/">http://www.zlib.net/</a>) </li> |
| 354 |
</ul> |
| 355 |
<p dir="ltr" style="text-align:left"></p> |
| 356 |
<p dir="ltr" style="text-align:left"> To build zlib, execute the following commands (where x.y.z is the zlib version number):</p> |
| 357 |
<p dir="ltr" style="text-align:left"></p> |
| 358 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style=""> cd zlib-x.y.z</span></p> |
| 359 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style=""> ./configure --prefix=/home/foobar/local</span></p> |
| 360 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style=""> make</span></p> |
| 361 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style=""> make install</span></p> |
| 362 |
<p dir="ltr" style="text-align:left"></p> |
| 363 |
<ul> |
| 364 |
<li dir="ltr" style="text-align:left"><span xml:lang="en-GB" lang="en-GB"> </span> libpng (download the autoconf enabled tarball from <a href="http://libpng.sourceforge.net/">http://libpng.sourceforge.net/</a>) </li> |
| 365 |
</ul> |
| 366 |
<p dir="ltr" style="text-align:left"></p> |
| 367 |
<p dir="ltr" style="text-align:left"> To build libpng, execute the following commands (where x.y.z is the libpng version number):</p> |
| 368 |
<p dir="ltr" style="text-align:left"></p> |
| 369 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">cd libpng-x.y.z-config</span></p> |
| 370 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">./autogen.sh</span></p> |
| 371 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">./configure --prefix=/home/foobar/local</span><span class="command_text plain_text" style=""> </span><span class="command_text plain_text" style="">CFLAGS="-I/home/foobar/local/include" LDFLAGS="-L/home/foobar/local/lib" </span></p> |
| 372 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">make</span></p> |
| 373 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">make install</span></p> |
| 374 |
<p dir="ltr" style="text-align:left"></p> |
| 375 |
<ul> |
| 376 |
<li dir="ltr" style="text-align:left"><span xml:lang="en-GB" lang="en-GB"> </span> libxml2 (download the source tarball from <a href="http://xmlsoft.org/">http://xmlsoft.org/</a>) </li> |
| 377 |
</ul> |
| 378 |
<p dir="ltr" style="text-align:left"></p> |
| 379 |
<p dir="ltr" style="text-align:left"> To build libxml2, execute the following commands (where x.y.z is the libxml2 version number):</p> |
| 380 |
<p dir="ltr" style="text-align:left"></p> |
| 381 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">./configure --without-ftp --without-http --prefix=/home/foobar/local/</span></p> |
| 382 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">make</span></p> |
| 383 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">make install</span></p> |
| 384 |
<p dir="ltr" style="text-align:left"></p> |
| 385 |
<ul> |
| 386 |
<li dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"> <span xml:lang="en-US" lang="en-US">libgsf (download the source tarball for version >= 1.12.1 from </span><a href="ftp://ftp.gnome.org/pub/gnome/sources/libgsf/"><span xml:lang="en-US" lang="en-US">ftp://ftp.gnome.org/pub/gnome/sources/libgsf/</span></a><span xml:lang="en-US" lang="en-US">)</span> </li> |
| 387 |
</ul> |
| 388 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in;margin-left:0pt;text-indent:0in"></p> |
| 389 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span xml:lang="en-GB" lang="en-GB"> To build </span><span xml:lang="en-US" lang="en-US">libgsf</span><span xml:lang="en-GB" lang="en-GB">, execute the following commands (where x.y.z is the </span><span xml:lang="en-US" lang="en-US">libgsf</span><span xml:lang="en-GB" lang="en-GB"> version number):</span></p> |
| 390 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"></p> |
| 391 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">cd </span><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US">libgsf</span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">-x.y.z</span></p> |
| 392 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span style="font-size:10pt;font-family:'Courier New';color:#0000ff" xml:lang="en-US" lang="en-US"> ./configure --prefix=/home/foobar/local/ --with-zlib=/home/foobar/local/</span></p> |
| 393 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">make</span></p> |
| 394 |
<p dir="ltr" style="text-align:left;margin-bottom:0.0000in;margin-top:0.0000in;margin-right:0.0000in"><span class="command_text plain_text" style="" xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="" xml:lang="en-GB" lang="en-GB">make install</span><span xml:lang="en-US" lang="en-US"> </span></p> |
| 395 |
<p dir="ltr" style="text-align:left"></p> |
| 396 |
<ul> |
| 397 |
<li dir="ltr" style="text-align:left"><span xml:lang="en-GB" lang="en-GB"> </span> wvWare (shipped with the AbiWord source distribution) </li> |
| 398 |
</ul> |
| 399 |
<p dir="ltr" style="text-align:left"></p> |
| 400 |
<p dir="ltr" style="text-align:left"><span xml:lang="en-US" lang="en-US"> </span>NOTE: at the moment you'll need the not-yet released wvWare >= 1.1.0, which is available in AbiWord's<span xml:lang="en-US" lang="en-US"> </span>cvs<span xml:lang="en-US" lang="en-US">.</span></p> |
| 401 |
<p dir="ltr" style="text-align:left"></p> |
| 402 |
<p dir="ltr" style="text-align:left"><span xml:lang="en-US" lang="en-US"> </span>To build wvWare, execute the following commands (where x.y.z is the AbiWord version number):</p> |
| 403 |
<p dir="ltr" style="text-align:left"></p> |
| 404 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style=""> cd abiword-x.y.z/wv</span></p> |
| 405 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style=""> ./autogen.sh</span></p> |
| 406 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style=""> ./configure --with-png=/home/foobar/local --with-zlib=/home/foobar/local --prefix=/home/foobar/local</span></p> |
| 407 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style=""> make</span></p> |
| 408 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style=""> make install</span></p> |
| 409 |
<p dir="ltr" style="text-align:left"></p> |
| 410 |
<p dir="ltr" style="text-align:left"><span xml:lang="en-US" lang="en-US">4</span>. To build AbiWord, execute the following commands (where x.y.z is the AbiWord version number):</p> |
| 411 |
<p dir="ltr" style="text-align:left"></p> |
| 412 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style=""> cd abiword-x.y.z/abi</span></p> |
| 413 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style=""> ./autogen.sh</span></p> |
| 414 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style=""> ./configure --with-sys-wv --with-libxml2 --with-zlib=/home/foobar/local --prefix=/home/foobar/local</span></p> |
| 415 |
<p dir="ltr" style="text-align:left"><span class="command_text plain_text" style=""> make</span></p> |
| 416 |
<p dir="ltr" style="text-align:left"></p> |
| 417 |
<p dir="ltr" style="text-align:left"><span xml:lang="en-US" lang="en-US">NOTE</span>: "make install" doesn't work yet; instead just place the AbiWord-2.x binary that can be found in ./src/wp/main/win together with the glib, libgsf, libiconv, popt, libintl and libxml2 dll's in a directory of your liking. That should work just fine for now.</p> |
| 418 |
<p></p> |
| 419 |
<h2 id="__AbiTOC26__"><a name="qnx" id="qnx"><span style="text-decoration:underline" xml:lang="en-US" lang="en-US">QNX</span></a><span style="text-decoration:underline" xml:lang="en-US" lang="en-US">:</span></h2> |
| 420 |
<h3 id="__AbiTOC27__"><span xml:lang="en-US" lang="en-US">Prerequisites: </span></h3> |
| 421 |
<p>(See also: <a href="#windows">Windows</a> and <a href="#unix">Unix</a> requirements for more information)</p> |
| 422 |
<ul> |
| 423 |
<li><span xml:lang="en-GB" lang="en-GB"> </span>abi</li> |
| 424 |
<li><span xml:lang="en-GB" lang="en-GB"> </span>abidistfiles</li> |
| 425 |
<li dir="ltr" style="text-align:left"><span xml:lang="en-GB" lang="en-GB"> </span>wv<span xml:lang="en-US" lang="en-US"> (use cvs co -r wv-1-0-0-STABLE wv)</span> </li> |
| 426 |
</ul> |
| 427 |
<p>You also need to have libpng, libiconv, libfribidi and libxml2. All except libfribidi are available from the QNX 3rd party CD. FriBiDi can be downloaded from <a href="http://www.qnxzone.com/%7etravis/packages/fribidi_x86-0.10.4-x86-public.qpr">http://www.qnxzone.com/~travis/packages/fribidi_x86-0.10.4-x86-public.qpr</a></p> |
| 428 |
<p>Building on QNX is similar to the other unix-like platforms. We rely on the command line utilities bash, sed, gawk, etc. </p> |
| 429 |
<p>There are 2 ways to build and run AbiWord:</p> |
| 430 |
<ol> |
| 431 |
<li><span xml:lang="en-GB" lang="en-GB"> </span>Developer Style: just cd to abi and type '<span class="command_text plain_text" style="">make</span>'. To run AbiWord, <span class="command_text plain_text" style="">cd</span> to the bin directory and type '<span class="command_text plain_text" style="">AbiWord -lib ../AbiSuite</span>' -- this will help AbiWord find the dictionary and other support files.</li> |
| 432 |
<li><span xml:lang="en-GB" lang="en-GB"> </span>End-User Style: just <span class="command_text plain_text" style="">cd</span> to abi and type '<span class="command_text plain_text" style="">make distribution ABI_BUILD_VERSION=x.y.z</span>' This will build a QNX 'Repository in a File' (src/pkg/qnx/abiword-x.y.z.qpr). Install this with '<span class="command_text plain_text" style="">pkg-installer -u abiword-x.y.z.qpr</span>'. </li> |
| 433 |
</ol> |
| 434 |
<h2 id="__AbiTOC28__"><a name="macosx" id="macosx"><span style="text-decoration:underline" xml:lang="en-US" lang="en-US">Mac OS X</span></a><span style="text-decoration:underline">:</span></h2> |
| 435 |
<p id="__AbiTOC29__" class="heading_4" awml:style="Heading 4">X11 AbiWord</p> |
| 436 |
<p>The official build method on Mac OS X is to use Project Builder to build the Cocoa front end. However, it is possible also to build for X11 - see the section on building for <a href="#unix">Unix</a>. Note: You will need to specify <span class="command_text plain_text" style="">--disable-Cocoa</span> to configure. Apple's X11.app and X11 SDK betas are one source of X11, unfortunately based on XFree86 4.2 and lacking fontconfig/Xft2 - hopefully Apple will get its act together. XDarwin may be a better choice until then. fink (<a href="http://fink.sourceforge.net/">http://fink.sourceforge.net/</a>) provides most of the packages needed by AbiWord.</p> |
| 437 |
<h3 id="__AbiTOC30__"><span xml:lang="en-US" lang="en-US">Prerequisites (Cocoa):</span></h3> |
| 438 |
<p><span xml:lang="en-US" lang="en-US">Currently fink </span><span xml:lang="en-US" lang="en-US">(</span><a href="http://fink.sourceforge.net/"><span xml:lang="en-US" lang="en-US">http://fink.sourceforge.net/</span></a><span xml:lang="en-US" lang="en-US">), in particular the libiconv and glib2 packages, is required in order to build the Cocoa port. Other dependencies are covered by modules in AbiWord's CVS. To get the source do:</span></p> |
| 439 |
<p class="normal_unspaced" awml:style="Normal Unspaced"> <span class="command_text plain_text" style="">cvs -d:pser</span><span class="command_text plain_text" style="">ver:[email protected]:/cvsroot login</span></p> |
| 440 |
<p class="normal_unspaced" awml:style="Normal Unspaced"> CVS password: (<span class="command_text plain_text" style="">anoncvs</span>)</p> |
| 441 |
<p><span xml:lang="en-US" lang="en-US"> </span><span class="command_text plain_text" style="">cvs -d:pserver:[email protected]:/cvsroot -z3 co abicocoa</span></p> |
| 442 |
<p>This will check out a number of modules, including several which end in "pbx" - these contain the Project Builder files.<a href="http://fink.sourceforge.net/"></a></p> |
| 443 |
<p></p> |
| 444 |
</div> |
| 445 |
</body> |
| 446 |
</html> |