source: xsoft/office/abiword.xml@ af988bf0

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since af988bf0 was af988bf0, checked in by Douglas R. Reno <renodr@…>, 5 months ago

Fix building Abiword with GCC-11

  • Property mode set to 100644
File size: 11.8 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-minor-version "3.0">
8 <!ENTITY AbiWord-docs-version "3.0.2">
9
10 <!ENTITY AbiWord-download-http
11 "https://www.abisource.com/downloads/abiword/&AbiWord-version;/source/abiword-&AbiWord-version;.tar.gz">
12 <!ENTITY AbiWord-download-ftp " ">
13 <!ENTITY AbiWord-md5sum "04e31887049a8c72297881bc153b77c4">
14 <!ENTITY AbiWord-size "11 MB">
15
16 <!ENTITY AbiWordDocs-download-http
17 "https://www.abisource.com/downloads/abiword/&AbiWord-docs-version;/source/abiword-docs-&AbiWord-docs-version;.tar.gz">
18 <!ENTITY AbiWordDocs-md5sum "c92c0e1e2081db20757231a53d80c338">
19 <!ENTITY AbiWordDocs-size "1.5 MB">
20
21 <!ENTITY AbiWord-buildsize "605 MB, with docs (76 MB installed)">
22 <!ENTITY AbiWord-time "2.4 SBU (Using parallelism=4, with docs)">
23]>
24
25<sect1 id="abiword" xreflabel="AbiWord-&AbiWord-version;">
26 <?dbhtml filename="AbiWord.html" ?>
27
28 <sect1info>
29 <date>$Date$</date>
30 </sect1info>
31
32 <title>AbiWord-&AbiWord-version;</title>
33
34 <indexterm zone="abiword">
35 <primary sortas="a-AbiWord">AbiWord</primary>
36 </indexterm>
37
38 <sect2 role="package">
39 <title>Introduction to AbiWord</title>
40
41 <para>
42 <application>AbiWord</application> is a word processor which is useful for
43 writing reports, letters and other formatted documents.
44 </para>
45
46 &lfs101_checked;
47
48 <bridgehead renderas="sect3">Package Information</bridgehead>
49 <itemizedlist spacing="compact">
50 <listitem>
51 <para>
52 Download (HTTP): <ulink url="&AbiWord-download-http;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download (FTP): <ulink url="&AbiWord-download-ftp;"/>
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download MD5 sum: &AbiWord-md5sum;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download size: &AbiWord-size;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated disk space required: &AbiWord-buildsize;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Estimated build time: &AbiWord-time;
78 </para>
79 </listitem>
80 </itemizedlist>
81
82 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
83 <itemizedlist spacing="compact">
84 <listitem>
85 <para>
86 AbiWord Docs: <ulink url="&AbiWordDocs-download-http;"/>
87 </para>
88 </listitem>
89 <listitem>
90 <para>
91 AbiWord Docs MD5 sum: &AbiWordDocs-md5sum;
92 </para>
93 </listitem>
94 <listitem>
95 <para>
96 AbiWord Docs size: &AbiWordDocs-size;
97 </para>
98 </listitem>
99 <listitem>
100 <para>
101 Required patch:
102 <ulink url="&patch-root;/abiword-&AbiWord-version;-gcc11_fixes-1.patch"/>
103 </para>
104 </listitem>
105 </itemizedlist>
106
107 <bridgehead renderas="sect3">AbiWord Dependencies</bridgehead>
108
109 <bridgehead renderas="sect4">Required</bridgehead>
110 <para role="required">
111 <xref linkend="boost"/>,
112 <xref linkend="curl"/>,
113 <xref linkend="fribidi"/>,
114 <xref linkend="goffice010"/>, and
115 <xref linkend="wv"/>
116 </para>
117
118 <bridgehead renderas="sect4">Recommended</bridgehead>
119 <para role="recommended">
120 <xref linkend="enchant"/>
121 </para>
122
123 <bridgehead renderas="sect4">Optional</bridgehead>
124 <para role="optional">
125 <xref linkend="dbus-glib"/>,
126 <xref linkend="evolution-data-server"/>,
127 <xref linkend="gobject-introspection"/>,
128 <xref linkend="libchamplain"/>,
129 <xref linkend="libgcrypt"/>,
130 <xref linkend="libical"/>,
131 <xref linkend="libsoup"/>,
132 <xref linkend="redland"/>,
133 <xref linkend="telepathy-glib"/>,
134 <xref linkend="valgrind"/>.
135 <ulink url="http://aiksaurus.sourceforge.net/">Aiksaurus</ulink>,
136 <ulink url="http://helm.cs.unibo.it/mml-widget/">GtkMathView</ulink>,
137 <ulink url="https://sourceforge.net/projects/wvware">libwmf</ulink>,
138 <ulink url="https://sourceforge.net/projects/libwpd/">libwpd</ulink>,
139 <ulink url="https://sourceforge.net/projects/libwpg/">libwpg</ulink>,
140 <ulink url="https://sourceforge.net/projects/libwps/">libwps</ulink>,
141 <ulink url="http://www.abisource.com/projects/link-grammar/">
142 Link Grammar Parser</ulink>,
143 <ulink url="&gnome-download-http;/loudmouth">Loudmouth</ulink>,
144 <ulink url="https://sourceforge.net/projects/otslibrary/">OTS</ulink>, and
145 <ulink url="http://software.frodo.looijaard.name/psiconv/">Psiconv</ulink>
146 </para>
147
148 <note>
149 <para>
150 To enable many of the optional dependencies, review the information
151 from <command>./configure --help</command> for the necessary switches
152 you must pass to the <command>configure</command> script.
153 </para>
154 </note>
155
156
157 <para condition="html" role="usernotes">
158 User Notes: <ulink url="&blfs-wiki;/abiword"/>
159 </para>
160 </sect2>
161
162 <sect2 role="installation">
163 <title>Installation of AbiWord</title>
164
165 <para>
166 First, fix a build failure when using GCC-11:
167 </para>
168
169<screen><userinput remap="pre">patch -Np1 -i ../abiword-&AbiWord-version;-gcc11_fixes-1.patch</userinput></screen>
170
171 <para>
172 Install <application>AbiWord</application> by running the following
173 commands:
174 </para>
175
176<screen><userinput>sed -e "s/free_suggestions/free_string_list/" \
177 -e "s/_to_personal//" \
178 -e "s/in_session/added/" \
179 -i src/af/xap/xp/enchant_checker.cpp &amp;&amp;
180
181./configure --prefix=/usr &amp;&amp;
182make</userinput></screen>
183
184 <para>
185 This program does not come with a functional test suite.
186 </para>
187
188 <para>
189 Now, as the <systemitem class="username">root</systemitem> user:
190 </para>
191
192<screen role="root"><userinput>make install</userinput></screen>
193
194 <note>
195 <para>
196 In order to install the local help files,
197 a graphics session is recommended.
198 </para>
199 </note>
200
201 <para>
202 If you wish to install the local help files, untar and build them first:
203 </para>
204
205 <note>
206 <para>
207 The current version of the docs expands to abiword-docs-3.0.1
208 and not the expected abiword-docs-3.0.2.
209 </para>
210 </note>
211
212<!-- I had to hardcode the docs version here, as it doesn't decompress to
213 abiword-docs-3.0.2. -->
214<screen><userinput>tar -xf ../abiword-docs-&AbiWord-docs-version;.tar.gz &amp;&amp;
215cd abiword-docs-3.0.1 &amp;&amp;
216./configure --prefix=/usr &amp;&amp;
217make</userinput></screen>
218
219 <para>
220 and then, as the <systemitem class="username">root</systemitem> user:
221 </para>
222
223<screen role="root"><userinput>make install</userinput></screen>
224
225 </sect2>
226
227 <sect2 role="commands">
228 <title>Command Explanations</title>
229
230 <para>
231 <command>sed ...</command>: This command corrects the source for
232 changes in the dependency <xref linkend="enchant"/>.
233 </para>
234<!--
235 <para>
236 <parameter>- -without-evolution-data-server</parameter>: This switch
237 disables <application>AbiWord</application>
238 <application>Evolution Data Server</application> support which is known
239 to fail when using recent versions of
240 <application>Evolution Data Server</application>.
241 </para>
242-->
243 <para>
244 <option>--enable-plugins="collab openxml goffice grammar"</option>: Build
245 some or all plugins. The openxml plugin enables
246 <application>Abiword</application> to open some .docx files.
247 The grammar plugin requires
248 <ulink url="http://www.abisource.com/projects/link-grammar/">Link Grammar
249 Parser</ulink>
250 </para>
251
252 </sect2>
253
254 <sect2 role="configuration">
255 <title>Configuring AbiWord</title>
256
257 <sect3 id="abiword-config">
258 <title>Config File</title>
259
260 <para>
261 <filename>~/.AbiSuite/templates/normal.awt</filename>
262 </para>
263
264 <indexterm zone="abiword abiword-config">
265 <primary sortas="e-AA.AbiSuite-templates-normal">~/.AbiSuite/templates/normal.awt</primary>
266 </indexterm>
267 </sect3>
268
269 <sect3>
270 <title>Configuration Information</title>
271
272 <para>
273 Choose the right template for your language and locale from the list
274 produced by the following command:
275 </para>
276
277<screen><userinput>ls /usr/share/abiword-&AbiWord-minor-version;/templates</userinput></screen>
278
279 <para>
280 Create the folder
281 <filename class='directory'>~/.AbiSuite/templates</filename> then copy
282 the <filename>normal.awt</filename> you want into it:
283 </para>
284
285<screen><userinput>install -v -m750 -d ~/.AbiSuite/templates &amp;&amp;
286install -v -m640 /usr/share/abiword-&AbiWord-minor-version;/templates/normal.awt-<replaceable>&lt;lang&gt;</replaceable> \
287 ~/.AbiSuite/templates/normal.awt</userinput></screen>
288
289 <para>
290 Change <replaceable>&lt;lang&gt;</replaceable> by the above command to
291 fit the name of the file you want.
292 </para>
293
294 <para>
295 If you are using multiple languages, you may need to edit the template
296 to use a font with greater coverage (e.g. one of the
297 <xref linkend="dejavu-fonts"/>,
298 <!--
299 <ulink url="http://dejavu.sourceforge.net/">DejaVu fonts</ulink>), -->
300 because <application>Abiword</application> does not use
301 <application>fontconfig</application> and can only display glyphs that
302 are provided in the chosen font.
303 </para>
304
305 <para>
306 If you have <xref linkend="desktop-file-utils"/> installed, you should
307 run the <command>update-desktop-database</command> command to update the
308 mimeinfo cache and allow the Help system to work.
309 </para>
310
311 <para>
312 If you have <xref linkend="xdg-utils"/> installed, you should
313 run the <command>xdg-icon-resource forceupdate --theme hicolor</command>
314 command, for the installed icon to be displayed in the menu item.
315 </para>
316
317 </sect3>
318
319 </sect2>
320
321 <sect2 role="content">
322 <title>Contents</title>
323
324 <segmentedlist>
325 <segtitle>Installed Program</segtitle>
326 <segtitle>Installed Library</segtitle>
327 <segtitle>Installed Directories</segtitle>
328
329 <seglistitem>
330 <seg>
331 abiword
332 </seg>
333 <seg>
334 libabiword-&AbiWord-minor-version;.so
335 </seg>
336 <seg>
337 /usr/include/abiword-&AbiWord-minor-version;,
338 /usr/lib/abiword-&AbiWord-minor-version;, and
339 /usr/share/abiword-&AbiWord-minor-version;
340 </seg>
341 </seglistitem>
342 </segmentedlist>
343
344 <variablelist>
345 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
346 <?dbfo list-presentation="list"?>
347 <?dbhtml list-presentation="table"?>
348
349 <varlistentry id="abiword-prog">
350 <term><command>abiword</command></term>
351 <listitem>
352 <para>
353 is the word processor, a wrapper for the functions in
354 libabiword-&AbiWord-minor-version; - it can also be used on the
355 command line, see <command>man 1 abiword</command>
356 </para>
357 <indexterm zone="abiword abiword-prog">
358 <primary sortas="b-abiword">abiword</primary>
359 </indexterm>
360 </listitem>
361 </varlistentry>
362
363 <varlistentry id="libabiword">
364 <term><filename class="libraryfile">libabiword-&AbiWord-minor-version;.so</filename></term>
365 <listitem>
366 <para>
367 provides functions to access MS Word documents
368 </para>
369 <indexterm zone="abiword libabiword">
370 <primary sortas="c-libabiword">libabiword-&AbiWord-minor-version;.so</primary>
371 </indexterm>
372 </listitem>
373 </varlistentry>
374
375 </variablelist>
376
377 </sect2>
378
379</sect1>
Note: See TracBrowser for help on using the repository browser.