source: xsoft/office/abiword.xml@ 7ff7653

10.0 10.1 11.0 11.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 7ff7653 was 7ff7653, checked in by Wayne Blaszczyk <wblaszcz@…>, 12 years ago

Added new package, enchant-1.5.0.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@8195 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 13.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY AbiWord-download-http "http://www.abisource.com/downloads/abiword/&AbiWord-version;/source/abiword-&AbiWord-version;.tar.bz2">
8 <!ENTITY AbiWord-download-ftp " ">
9 <!ENTITY AbiWord-md5sum "8ed5fb282b9741aca75b9e47500d39a1">
10 <!ENTITY AbiWord-size "25 MB">
11 <!ENTITY AbiWord-buildsize "262 MB (additional 210 MB to build and install the API docs)">
12 <!ENTITY AbiWord-time "4.5 SBU (to build and install the program, docs and all plugins)">
13 <!ENTITY AbiWord-minor-version "2.4">
14 <!ENTITY AbiWord-under-version "2_4">
15]>
16
17<sect1 id="abiword" xreflabel="AbiWord-&AbiWord-version;">
18 <?dbhtml filename="AbiWord.html" ?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>AbiWord-&AbiWord-version;</title>
26
27 <indexterm zone="abiword">
28 <primary sortas="a-AbiWord">AbiWord</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to AbiWord</title>
33
34 <para>The <application>AbiWord</application> package contains a word
35 processing application. This is useful for writing reports, letters and
36 other formatted documents.</para>
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>Download (HTTP): <ulink url="&AbiWord-download-http;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download (FTP): <ulink url="&AbiWord-download-ftp;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download MD5 sum: &AbiWord-md5sum;</para>
48 </listitem>
49 <listitem>
50 <para>Download size: &AbiWord-size;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated disk space required: &AbiWord-buildsize;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated build time: &AbiWord-time;</para>
57 </listitem>
58 </itemizedlist>
59
60 <bridgehead renderas="sect3">AbiWord Dependencies</bridgehead>
61
62 <bridgehead renderas="sect4">Required</bridgehead>
63 <para role="required"><xref linkend="fribidi"/> and
64 <xref linkend="libgnomeprintui"/></para>
65
66 <bridgehead renderas="sect4">Optional</bridgehead>
67 <para role="optional"><xref linkend="libgnomeui"/> (for GNOME-2 support),
68 <xref linkend="gucharmap"/>,
69 <xref linkend="enchant"/> (uses
70 <xref linkend="aspell"/>),
71 <ulink url="http://wvware.sourceforge.net/">wv</ulink> (with
72 <ulink url="http://sourceforge.net/projects/wvware">libwmf</ulink> installed first), and
73 <ulink url="http://valgrind.org/">Valgrind</ulink></para>
74
75 <bridgehead renderas="sect4">Optional for Plugins</bridgehead>
76 <para role="optional"><xref linkend="libgsf"/> (to build the OpenDocument/OpenOffice plugin),
77 <xref linkend="poppler"/> (for the pdf plugin, requires installing with unsupported xpdf headers),
78 <xref linkend="librsvg"/>,
79 <!-- Currently Broken <xref linkend="html-tidy"/>, -->
80 <!-- Currently Broken <ulink url="http://www.inter7.com/index.php?page=eps">EPS</ulink>, -->
81 <xref linkend="nautilus"/> (for GNOME-2 support),
82 <xref linkend="goffice"/> (you must use a version of
83 <ulink url="&gnome-download-http;/goffice/0.2/">GOffice &lt;0.3.0</ulink>),
84 <ulink url="http://www.abisource.com/projects/link-grammar/">Link Grammar</ulink>,
85 <ulink url="http://aiksaurus.sourceforge.net/">Aiksaurus</ulink>,
86 <ulink url="http://www.gnome-db.org/">libgnomedb version &lt;1.3.0</ulink>* (requires
87 <ulink url="http://www.gnome-db.org/">libgda version &lt;1.3.0</ulink>),
88 <ulink url="http://sourceforge.net/projects/wvware">libwmf</ulink>,
89 <ulink url="http://helm.cs.unibo.it/mml-widget/">GtkMathView</ulink> (requires
90 <ulink url="http://sourceforge.net/projects/gmetadom/">Gnome DOM Bindings</ulink> which requires
91 <ulink url="http://gdome2.cs.unibo.it/">gdome2</ulink>),
92 <ulink url="http://libwpd.sourceforge.net/">libwpd</ulink>,
93 <ulink url="http://libots.sourceforge.net/">OTS</ulink>, and
94 <ulink url="http://software.frodo.looijaard.name/psiconv/">Psiconv</ulink></para>
95
96 <para>* The
97 <application>libgda</application>/<application>libgnomedb</application>
98 stack required for <application>AbiWord</application> database
99 access may conflict with the versions used by the
100 <xref linkend="gnumeric"/> database plugin. Though the libraries
101 themselves pose no conflict, the executables and support files will
102 overwrite one another. Note that the current (version 3.0.x) stack does not
103 pose a conflict with any of the previous versions (but does not support
104 <application>AbiWord</application> or <application>Gnumeric</application>
105 database access. <application>AbiWord</application> requires versions
106 &lt;1.3.0 (1.2.2 is known to work).</para>
107
108 <para condition="html" role="usernotes">User Notes:
109 <ulink url="&blfs-wiki;/abiword"/></para>
110
111 </sect2>
112
113 <sect2 role="installation">
114 <title>Installation of AbiWord</title>
115
116 <para>Install <application>AbiWord</application> by running the following
117 commands:</para>
118
119<screen><userinput>cd abi &amp;&amp;
120./configure --prefix=/usr &amp;&amp;
121make &amp;&amp;
122
123cd ../abiword-plugins &amp;&amp;
124sed -i 's/dictionary_file)/reinterpret_cast&lt;const unsigned char *&gt;(&amp;)/' \
125 tools/ots/xp/AbiOts.cpp &amp;&amp;
126
127./configure --prefix=/usr --without-inter7eps &amp;&amp;
128make &amp;&amp;
129
130cd ..</userinput></screen>
131
132 <para>If you wish to create the API documentation,
133 <xref linkend="doxygen"/> must be installed and issue the following
134 commands:</para>
135
136<screen><userinput>pushd abi &amp;&amp;
137doxygen &amp;&amp;
138popd</userinput></screen>
139
140 <para>This package's test suite requires <ulink
141 url="http://valgrind.org/">Valgrind</ulink>. Though the end message will
142 indicate the tests failed, there will actually be many tests that run
143 to a successful completion. Run the tests by issuing the following
144 commands:</para>
145
146<screen><userinput>pushd abi &amp;&amp;
147make check &amp;&amp;
148popd</userinput></screen>
149
150 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
151
152<screen role="root"><userinput>cd abi &amp;&amp;
153make install &amp;&amp;
154
155install -v -m755 -d /usr/share/doc/abiword-&AbiWord-version; &amp;&amp;
156install -v -m644 docs/*.* \
157 /usr/share/doc/abiword-&AbiWord-version; &amp;&amp;
158
159cd ../abiword-plugins &amp;&amp;
160make install &amp;&amp;
161
162cd ..</userinput></screen>
163
164 <para><application>AbiWord</application> is now installed and must be used
165 to build the Help files. Issue the following commands as an unprivileged
166 user:</para>
167
168<screen><userinput>pushd abiword-docs &amp;&amp;
169./make-html.sh &amp;&amp;
170cd ..</userinput></screen>
171
172<!-- removing this as it does exactly the same thing as
173 the make-html.sh does ./make-gnome-html.sh &amp;&amp; -->
174
175 <para>Then as the <systemitem class="username">root</systemitem> user,
176 install the help files:</para>
177
178<screen role="root"><userinput>install -v -m644 man/abiword.1 /usr/share/man/man1 &amp;&amp;
179install -v -m644 Manual/en/Abiword_Manual.abw \
180 /usr/share/doc/abiword-&AbiWord-version; &amp;&amp;
181cp -v -Rf help /usr/share/AbiSuite-&AbiWord-minor-version;/AbiWord &amp;&amp;
182find /usr/share/AbiSuite-&AbiWord-minor-version;/AbiWord/help \
183 -type d -exec chmod -v 755 {} \;</userinput></screen>
184
185 <para>If you have a <application>GNOME</application> installation, issue
186 the following commands as the <systemitem class="username">root</systemitem>
187 user to install the <application>AbiWord</application> Bonobo component
188 description file:</para>
189
190<screen role="root"><userinput>install -v -m644 abidistfiles/GNOME_AbiWord_Control_&AbiWord-under-version;.server \
191 $(pkg-config --variable=prefix ORBit-2.0)/lib/bonobo/servers &amp;&amp;
192
193if [ $(pkg-config --variable=prefix ORBit-2.0) != "/usr" ]; then
194 rmdir -v /usr/lib/{bonobo/servers,bonobo}
195fi</userinput></screen>
196
197 <para>If you built the API documentation, install it by issuing the
198 following commands as the <systemitem class="username">root</systemitem>
199 user:</para>
200
201<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/abiword-&AbiWord-version;/api &amp;&amp;
202
203for FILENAME in $(ls abi/docs/dox/html); do
204 install -v -m644 abi/docs/dox/html/${FILENAME} \
205 /usr/share/doc/abiword-&AbiWord-version;/api
206done</userinput></screen>
207
208 </sect2>
209
210 <sect2 role="commands">
211 <title>Command Explanations</title>
212
213 <para><parameter>--without-inter7eps</parameter>: Some of the headers from
214 the <application>EPS</application> package are not compatible with
215 <application>GCC</application>-&gcc-version;. This parameter prevents
216 linking to the package and incurring a build failure.</para>
217
218 <para><command>sed -i '...' tools/ots/xp/AbiOts.cpp </command>:
219 This command is used to fix an incompatibility with
220 <application>GCC</application> and the
221 <application>libots</application> package.</para>
222
223 <para><command>if [ ... != "/usr" ]; then ...;fi</command>:
224 This command is used to remove unneeded directories if the
225 <application>GNOME</application> installation is in any prefix
226 other than <filename class='directory'>/usr</filename>.</para>
227
228 </sect2>
229
230 <sect2 role="configuration">
231 <title>Configuring AbiWord</title>
232
233 <sect3 id="abiword-config">
234 <title>Config File</title>
235
236 <para><filename>~/.AbiSuite/templates/normal.awt</filename></para>
237
238 <indexterm zone="abiword abiword-config">
239 <primary sortas="e-AA.AbiSuite-templates-normal">~/.AbiSuite/templates/normal.awt</primary>
240 </indexterm>
241
242 </sect3>
243
244 <sect3>
245 <title>Configuration Information</title>
246
247 <para>Choose the right template for your language and locale from the
248 list produced by the following command:</para>
249
250<screen><userinput>ls /usr/share/AbiSuite-&AbiWord-minor-version;/templates</userinput></screen>
251
252 <para>Create the folder
253 <filename class='directory'>~/.AbiSuite/templates</filename> then copy the
254 <filename>normal.awt</filename> you want into it:</para>
255
256<screen><userinput>install -v -m750 -d ~/.AbiSuite/templates &amp;&amp;
257install -v -m640 /usr/share/AbiSuite-&AbiWord-minor-version;/templates/normal.awt-<replaceable>&lt;lang&gt;</replaceable> \
258 ~/.AbiSuite/templates/normal.awt</userinput></screen>
259
260 <para>Change <replaceable>&lt;lang&gt;</replaceable> in the above
261 command to fit the name of the file you want.</para>
262
263 <para>If you have <xref linkend="desktop-file-utils"/> installed,
264 you should run the <command>update-desktop-database</command> command
265 to update the mimeinfo cache and allow the Help system to work.</para>
266
267 </sect3>
268
269 </sect2>
270
271 <sect2 role="content">
272 <title>Contents</title>
273
274 <segmentedlist>
275 <segtitle>Installed Programs</segtitle>
276 <segtitle>Installed Libraries</segtitle>
277 <segtitle>Installed Directories</segtitle>
278
279 <seglistitem>
280 <seg>abiword, AbiWord-&AbiWord-minor-version;, ttfadmin.sh, and ttftool</seg>
281 <seg>Numerous plugin library support modules</seg>
282 <seg>/usr/lib/AbiWord-&AbiWord-minor-version; and
283 /usr/share/AbiSuite-&AbiWord-minor-version;</seg>
284 </seglistitem>
285 </segmentedlist>
286
287 <variablelist>
288 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
289 <?dbfo list-presentation="list"?>
290 <?dbhtml list-presentation="table"?>
291
292 <varlistentry id="abiword-prog">
293 <term><command>abiword</command></term>
294 <listitem>
295 <para>is a symbolic link to the main
296 <command>AbiWord-&AbiWord-minor-version;</command>
297 executable.</para>
298 <indexterm zone="abiword abiword-prog">
299 <primary sortas="g-abiword">abiword</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="AbiWord-version-number">
305 <term><command>AbiWord-&AbiWord-minor-version;</command></term>
306 <listitem>
307 <para>is the word-processing program executable.</para>
308 <indexterm zone="abiword AbiWord-version-number">
309 <primary sortas="b-AbiWord-&AbiWord-minor-version;">AbiWord-&AbiWord-minor-version;</primary>
310 </indexterm>
311 </listitem>
312 </varlistentry>
313
314 <varlistentry id="ttfadmin.sh">
315 <term><command>ttfadmin.sh</command></term>
316 <listitem>
317 <para>generates support files required by
318 <application>AbiWord</application> for each TrueType font in a
319 given directory.</para>
320 <indexterm zone="abiword ttfadmin.sh">
321 <primary sortas="b-ttfadmin.sh">ttfadmin.sh</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325
326 <varlistentry id="ttftool">
327 <term><command>ttftool</command></term>
328 <listitem>
329 <para>is a utility for processing TrueType fonts.</para>
330 <indexterm zone="abiword ttftool">
331 <primary sortas="b-ttftool">ttftool</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 </variablelist>
337
338 </sect2>
339
340</sect1>
Note: See TracBrowser for help on using the repository browser.