source: archive/suites/openoffice.xml

trunk
Last change on this file was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 17 months ago

Remove sect1info tags

They only contain a date tag that is nowhere used.

  • Property mode set to 100644
File size: 21.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 openoffice-download-http "http://download.openoffice.org/&openoffice-version;/source.html"> -->
8 <!-- <!ENTITY openoffice-download-ftp "ftp://ftp.ussg.iu.edu/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src.tar.gz"> -->
9 <!ENTITY openoffice-core-download-http "http://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_core.tar.bz2">
10 <!ENTITY openoffice-core-download-ftp "ftp://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_core.tar.bz2">
11 <!ENTITY openoffice-core-md5sum "4fa713fb796bc57e5eb9dfb0758adda0">
12 <!ENTITY openoffice-core-size "205 MB">
13 <!ENTITY openoffice-system-download-http "http://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_system.tar.bz2">
14 <!ENTITY openoffice-system-download-ftp "ftp://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_system.tar.bz2">
15 <!ENTITY openoffice-system-md5sum "e6405c8108bdcf4cc2bf066d88aa5ae1">
16 <!ENTITY openoffice-system-size "59 MB">
17 <!ENTITY openoffice-buildsize "4.9-7.3 GB (depending on configured options)">
18 <!ENTITY openoffice-time "96-109 SBU (depending on configured options)">
19]>
20
21<sect1 id="openoffice" xreflabel="OpenOffice-&openoffice-version;">
22 <?dbhtml filename="openoffice.html" ?>
23
24
25 <title>OpenOffice-&openoffice-version;</title>
26
27 <indexterm zone="openoffice">
28 <primary sortas="a-OpenOffice">OpenOffice</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to OpenOffice</title>
33
34 <para><application>OpenOffice</application> is an office suite, the
35 open source sibling of <application>StarOffice</application>.</para>
36
37 <bridgehead renderas="sect3">Package Information</bridgehead>
38 <itemizedlist spacing="compact">
39 <listitem>
40 <para>OpenOffice Core Download (HTTP): <ulink url="&openoffice-core-download-http;"/></para>
41 </listitem>
42 <listitem>
43 <para>OpenOffice Core Download (FTP): <ulink url="&openoffice-core-download-ftp;"/></para>
44 </listitem>
45 <listitem>
46 <para>OpenOffice Core Download MD5 sum: &openoffice-core-md5sum;</para>
47 </listitem>
48 <listitem>
49 <para>OpenOffice Core Download size: &openoffice-core-size;</para>
50 </listitem>
51 <listitem>
52 <para>OpenOffice System Download (HTTP): <ulink url="&openoffice-system-download-http;"/></para>
53 </listitem>
54 <listitem>
55 <para>OpenOffice System Download (FTP): <ulink url="&openoffice-system-download-ftp;"/></para>
56 </listitem>
57 <listitem>
58 <para>OpenOffice System Download MD5 sum: &openoffice-system-md5sum;</para>
59 </listitem>
60 <listitem>
61 <para>OpenOffice System Download size: &openoffice-system-size;</para>
62 </listitem>
63 <listitem>
64 <para>Estimated disk space required: &openoffice-buildsize;</para>
65 </listitem>
66 <listitem>
67 <para>Estimated build time: &openoffice-time;</para>
68 </listitem>
69 </itemizedlist>
70
71 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
72 <itemizedlist spacing='compact'>
73 <listitem>
74 <para>Required patch:
75 <ulink url="&patch-root;/OOo_&openoffice-version;-build_with_db5-1.patch"/>
76 </para>
77 </listitem>
78 <listitem>
79 <para>Required download:
80 <ulink url="ftp://ftp.mozilla.org/pub/mozilla.org/seamonkey/releases/1.1.14/seamonkey-1.1.14.source.tar.bz2"/></para>
81 </listitem>
82 <listitem>
83 <para>Optional download if you would like to localize the
84 installation:
85 <ulink url="ftp://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_l10n.tar.bz2"/></para>
86 </listitem>
87 <listitem>
88 <para>Optional download if you need to support the old
89 <application>StarOffice-5.2</application> file formats:
90 <ulink url="ftp://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_binfilter.tar.bz2"/></para>
91 </listitem>
92 <listitem>
93 <para>Optional download if you want to build additional extensions
94 for <application>OpenOffice</application>:
95 <ulink url="ftp://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_extensions.tar.bz2"/></para>
96 </listitem>
97 <listitem>
98 <para>Optional download if you want to build the office development kit
99 (cross platform requirement is not optional):
100 <ulink url="http://tools.openoffice.org/unowinreg_prebuild/680/unowinreg.dll"/></para>
101 </listitem>
102 </itemizedlist>
103 <bridgehead renderas="sect3">OpenOffice Dependencies</bridgehead>
104
105 <bridgehead renderas="sect4">Required</bridgehead>
106 <para role="required"><xref linkend="apache-ant"/>,
107 <xref linkend="gtk2"/>,
108 <xref linkend="libidl"/>,
109 <application>Perl Modules</application>
110 <xref linkend="perl-xml-parser"/> and
111 <xref linkend="perl-archive-zip"/>,
112 <xref linkend="unzip"/>,
113 <xref linkend="which"/>, and
114 <xref linkend="zip"/></para>
115
116 <bridgehead renderas="sect4">Optional</bridgehead>
117 <para role="optional"><ulink
118 url="http://packages.debian.org/testing/libdevel/libaltlinuxhyph-dev">ALTLinuxhyph</ulink>,
119 <xref linkend="boost"/>,
120 <xref linkend="cups"/>,
121 <xref linkend="curl"/>,
122 <xref linkend="db"/> (built with Java support),
123 <xref linkend="desktop-file-utils"/>,
124 <ulink url="http://www.easysw.com/epm/">EPM</ulink>,
125 <xref linkend="evolution"/>,
126 <!--<xref linkend="gnome-vfs"/> (should use \-\-enable-gio instead),-->
127 <!-- <xref linkend="kde"/>, -->
128 <xref linkend="libjpeg"/>,
129 <ulink url="http://www.mega-nerd.com/libsndfile/">libsndfile</ulink>,
130 <xref linkend="libtiff"/>,
131 <ulink url="http://freshmeat.net/projects/libwpd/">libwpd</ulink>,
132 <xref linkend="libxslt"/>,
133 <xref linkend="libxml2"/>,
134 <xref linkend="linux-pam"/>,
135 <ulink url="http://lingucomponent.openoffice.org/MySpell-3.zip">MySpell</ulink>,
136 <ulink url="http://lingucomponent.openoffice.org/thesaurus.html">MyThes</ulink>,
137 <xref linkend="neon"/>,
138 <xref linkend="openldap"/>,
139 <xref linkend="python2"/>,
140 <xref linkend="sane"/>,
141 <xref linkend="startup-notification"/>, and
142 <xref linkend="unixodbc"/></para>
143
144 <para condition="html" role="usernotes">User Notes:
145 <ulink url="&blfs-wiki;/openoffice"/></para>
146
147 </sect2>
148
149 <sect2 role="installation">
150 <title>Installation of OpenOffice</title>
151
152 <para>The <application>OpenOffice</application> source code is
153 distributed in several tarballs. You should extract each from the
154 same top-level directory before entering the build directory. At
155 a minimum, you will need to extract the <quote>core</quote> and
156 <quote>system</quote> tarballs. Note that the source directory name
157 is not consistent with the tarball name and will be named
158 <filename class='directory'>OOO320_m19</filename>.</para>
159
160 <para>It is possible to build with a system-installed
161 <application>Mozilla</application>, however, it requires a very intrusive
162 patch, and is version specific. Additionally, you'll need to build against
163 <xref linkend="seamonkey"/> or <xref linkend="thunderbird"/> for full
164 LDAP and address book functionality. Instead, use the in-tree
165 <application>Seamonkey</application> build. Copy the tarball into
166 the source tree with the following command:</para>
167
168<screen><userinput>cp ../seamonkey-1.1.14-source.tar.bz2 moz/download/</userinput></screen>
169
170 <para>If you want to optimize the build, edit the appropriate makefile in
171 <filename>solenv/inc/</filename> and add the desired optimization
172 flags to the <envar>CFLAGSOPT</envar> variable. The makefiles are arch
173 specific, for instance edit <filename>unxlngi6.mk</filename> for i686, or
174 <filename>unxlngx6.mk</filename> for x86_64. Some users have reported
175 problems with <option>-fomit-frame-pointer</option>. The best option is to
176 not use any custom optimizations.</para>
177
178 <note>
179 <para>Because of the complexity of the
180 <application>OpenOffice</application> build system, it is not possible to
181 provide generic build instructions for all systems. You should review
182 the output of <command>configure --help</command> and take advantage of
183 any system installed programs and libraries available using the
184 <parameter>--enable-*</parameter>, <parameter>--disable-*</parameter>,
185 and <parameter>--with-system-*</parameter> parameters, and provide any
186 additional environment variables needed.</para>
187 </note>
188
189 <para><application>OpenOffice</application> fails to compile if
190 <command>umask</command> is set to something exotic. The build can also
191 fail if the <envar>LANG</envar> or <envar>LC_ALL</envar> environment
192 variables are set. Use the following commands to change your
193 environment accordingly:</para>
194
195<screen><userinput>umask 0022 &amp;&amp;
196unset LANG LC_ALL</userinput></screen>
197
198 <para>Install <application>OpenOffice</application> by running the
199 following commands:</para>
200
201<!-- uudecode didn't fuss...but left in for reference
202sed -i 's@..$/dist$/configure@uudecode="no" &amp;@' \
203 berkeleydb/makefile.mk &amp;&amp;
204-->
205
206<screen><userinput>patch -Np1 -i ../OOo_&openoffice-version;-with-system-db5-1.patch &amp;&amp;
207autoreconf &amp;&amp;
208PKG_CONFIG=/usr/bin/pkg-config ./configure \
209 --disable-binfilter \
210 --disable-fontooo \
211 --disable-gnome-vfs \
212 --disable-odk \
213 --disable-qadevooo \
214 --enable-cairo \
215 --without-afms \
216 --without-fonts \
217 --without-ppds \
218 --without-pam \
219 --with-system-stdlibs \
220 --with-system-cairo \
221 --with-system-expat \
222 --with-system-zlib \
223 --with-package-format=native \
224 --with-vendor="BLFS" \
225 --with-use-shell=bash &amp;&amp;
226source LinuxX86Env.Set.sh &amp;&amp;
227./bootstrap &amp;&amp;
228make</userinput></screen>
229
230 <para>This package does not come with a test suite.</para>
231
232 <para>Now, as the <systemitem class="username">root</systemitem>
233 user:</para>
234
235<screen role="root"><userinput>pushd instsetoo_native/unxlng?6.pro/OpenOffice/\
236native/install/en-US/linux-2.6-*/buildroot/opt &amp;&amp;
237cp -r -v openoffice.org3 /opt/openoffice-&openoffice-version; &amp;&amp;
238cp -r -v openoffice.org/* /opt/openoffice-&openoffice-version; &amp;&amp;
239ln -sf basis3.2 /opt/openoffice-&openoffice-version;/basis-link &amp;&amp;
240popd &amp;&amp;
241
242for appl in sbase scalc sdraw simpress smath soffice spadmin swriter
243do
244 ln -v -sf /opt/openoffice-&openoffice-version;/program/$appl /usr/bin
245done &amp;&amp;
246
247pushd sysui/desktop/icons &amp;&amp;
248install -v -m755 -d /usr/share/icons/{hicolor,locolor} &amp;&amp;
249cp -r -v hicolor/* /usr/share/icons/hicolor &amp;&amp;
250cp -r -v locolor/* /usr/share/icons/locolor &amp;&amp;
251popd</userinput></screen>
252
253 <para>If you have installed <xref linkend="desktop-file-utils"/>, you
254 should copy the <filename class='extension'>*.desktop</filename> files to
255 <filename class='directory'>/usr/share/applications</filename> using the
256 following commands as the <systemitem class="username">root</systemitem>
257 user:</para>
258
259<screen role="root"><userinput>install -v -d -m755 /usr/share/applications &amp;&amp;
260pushd /opt/openoffice-&openoffice-version;/share/xdg/ &amp;&amp;
261for appl in *.desktop
262do
263 sed -i '/Exec/d' $appl &amp;&amp;
264 echo "Exec=/usr/bin/s`echo $appl | sed 's/.desktop//'`" >> $appl &amp;&amp;
265 sed -i '/Icon/d' $appl &amp;&amp;
266 echo "Icon=`echo "ooo-${appl}3.2" | sed 's/\.desktop//'`" >> $appl
267done &amp;&amp;
268sed -i 's@bin/sprinteradmin@bin/spadmin@' printeradmin.desktop &amp;&amp;
269cp -v *.desktop /usr/share/applications &amp;&amp;
270update-desktop-database &amp;&amp;
271popd</userinput></screen>
272
273 <para>If you've chosen to build any additional dictionaries or any of the
274 extensions, you'll need to copy them to the installation directory. Run
275 the following commands as the
276 <systemitem class="username">root</systemitem> user:</para>
277
278 <note><para>The following two command blocks will not exit with a zero
279 value, and the second will require you to press 'y' before installation.
280 Keep this in mind if scripting the build.</para></note>
281
282<screen role="root"><userinput>cp -v dictionaries/unxlngi6.pro/bin/dict-*.oxt \
283 sdext/unxlngi6.pro/bin/*.oxt \
284 reportbuilder/unxlngi6.pro/bin/report-builder.oxt \
285 swext/unxlngi6.pro/bin/wiki-publisher.oxt \
286 /opt/openoffice-3.2.1/share/extension/install</userinput></screen>
287
288 <para>Now, while still the <systemitem class="username">root</systemitem>
289 user, add everything into the shared installation:</para>
290
291<screen role="root"><userinput>for ext in /opt/openoffice-3.2.1/share/extension/install/*.oxt
292do
293 /opt/openoffice-3.2.1/program/unopkg add --shared --verbose $ext
294done</userinput></screen>
295
296 <note><para><application>OpenOffice</application> default language tools
297 will not work out of the box. You will have to explicitly select the
298 proper language settings from within one of the installed programs by
299 going into the Tools menu and selecting Options. Under Language Settings,
300 Languages, select the desired language for all settings. Do not leave
301 "Default" in any drop down menu here.</para></note>
302
303 <para>Finally, if you'd like to edit <application>OpenOffice</application>
304 documents directly from <xref linkend="seamonkey"/> or
305 <xref linkend="firefox"/>, create a symbolic link in your
306 plugins directory to <filename
307 class='libraryfile'>/opt/openoffice-&openoffice-version;/program/libnpsoplugin.so</filename>.
308 Additionally, you must enable the plugin from the
309 <parameter>Internet Options</parameter> within any
310 <application>OpenOffice</application> application.</para>
311
312 </sect2>
313
314 <sect2 role="commands">
315 <title>Command Explanations</title>
316
317 <para><envar>PKG_CONFIG=/usr/bin/pkg-config</envar>:
318 This variable must be set as the version check in
319 <filename>configure</filename> is broken.</para>
320
321 <para><parameter>--disable-binfilter</parameter>: This switch disables
322 the build of legacy <application>StarOffice-5</application> import
323 filters. Omit this switch if you've downloaded the
324 <application>binfilter</application> package
325 above. Warning: Installation of the legacy import filters increases the
326 build time considerably. Only install them if you have these old
327 file types, and need to edit them in
328 <application>OpenOffice</application>.</para>
329
330 <para><parameter>--disable-fontooo</parameter>: Use
331 <application>Fontconfig</application> instead of the FontOOo.</para>
332
333 <para><parameter>--disable-gnome-vfs</parameter>: Disable the use of
334 <application>Gnome Virtual File System</application> libraries. Omit
335 this switch only if gio is not available.</para>
336
337 <para><parameter>--disable-odk</parameter>: This switch disables the build
338 of the <application>OpenOffice</application> SDK. Omit this switch if
339 you've downloaded the SDK package (and additional requirements)
340 above.</para>
341
342 <para><parameter>--disable-qadevooo</parameter>: This switch skips
343 the building of the quality assurance tools used by the
344 <application>OpenOffice</application> development teams.</para>
345
346 <para><parameter>--enable-cairo</parameter>: This switch listed in the
347 example <command>configure</command> command above forces the use of the
348 system installed cairo.</para>
349
350 <para><parameter>--without-afms</parameter>: Do not install afm font types
351 as system installed TrueType fonts are already available.</para>
352
353 <para><parameter>--without-fonts</parameter>: Do not install Bitstream
354 Vera fonts since they are already included in the
355 <application>X</application> Window System Environment.</para>
356
357 <para><parameter>--without-ppds</parameter>: Do not install printer
358 description files as these should be handled by your print system.</para>
359
360 <para><parameter>--without-pam</parameter>: Disable the use of
361 <application>Linux-PAM</application> functions. Omit this switch if
362 <application>Linux-PAM</application> is installed.</para>
363
364 <para><parameter>--with{,out}-system-*</parameter>: Determines
365 whether to use the system libraries and programs or to build
366 the source packages included in the build tree.</para>
367
368 <para><parameter>--with-build-version="3.2.1-1"</parameter>: Changes the
369 build version to append "-1" to the default version string.</para>
370
371 <para><parameter>--with-vendor="BLFS"</parameter>: Changed the vendor
372 string to "BLFS" in the help->about dialog.</para>
373
374 <para><parameter>--with-use-shell=bash</parameter>: Tells the
375 <application>OpenOffice</application> build system to use
376 <command>bash</command> instead of <command>tcsh</command>.</para>
377
378 <para><command>./bootstrap</command>: Build the
379 <command>dmake</command> utility required to complete the
380 build.</para>
381
382 <para>
383 <parameter>--with-lang=<replaceable>&lt;LANG&gt;</replaceable></parameter>:
384 Allows the use of additional languages in
385 <application>OpenOffice</application>. US English (ENUS) is the
386 default.</para>
387
388 <para>
389 <parameter>--with-dict=<replaceable>&lt;LANG&gt;</replaceable></parameter>:
390 Allows the use of alternate dictionaries in
391 <application>OpenOffice</application>. US English (ENUS) is the
392 default.</para>
393
394 <para><parameter>--with-use-shell=bash</parameter>: Tells the
395 <application>OpenOffice</application> build system to use
396 <command>bash</command> instead of <command>tcsh</command>.</para>
397
398 <para><command>./bootstrap</command>: Build the
399 <command>dmake</command> utility required to complete the
400 build.</para>
401
402 <para><command>for appl in sbase scalc...</command>: Creates symlinks
403 for the applications in
404 <filename class="directory">/usr/bin</filename>.</para>
405
406 <para><command>for appl in *.desktop...</command>: Edit the
407 <filename>*.desktop</filename> files for use with a standard BLFS
408 system.</para>
409
410 </sect2>
411
412 <sect2 role="content">
413 <title>Contents</title>
414
415 <segmentedlist>
416 <segtitle>Installed Programs</segtitle>
417 <segtitle>Installed Libraries</segtitle>
418 <segtitle>Installed Directory</segtitle>
419
420 <seglistitem>
421 <seg>sbase, scalc, sdraw, simpress, smath, soffice, spadmin,
422 and swriter</seg>
423 <seg><application>OpenOffice</application> libraries</seg>
424 <seg>/opt/openoffice-&openoffice-version;</seg>
425 </seglistitem>
426 </segmentedlist>
427
428 <variablelist>
429 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
430 <?dbfo list-presentation="list"?>
431 <?dbhtml list-presentation="table"?>
432
433 <varlistentry id="sbase">
434 <term><command>sbase</command></term>
435 <listitem>
436 <para>is a database application.</para>
437 <indexterm zone="openoffice sbase">
438 <primary sortas="b-sbase">sbase</primary>
439 </indexterm>
440 </listitem>
441 </varlistentry>
442
443 <varlistentry id="scalc">
444 <term><command>scalc</command></term>
445 <listitem>
446 <para>is a spreadsheet application.</para>
447 <indexterm zone="openoffice scalc">
448 <primary sortas="b-scalc">scalc</primary>
449 </indexterm>
450 </listitem>
451 </varlistentry>
452
453 <varlistentry id="sdraw">
454 <term><command>sdraw</command></term>
455 <listitem>
456 <para>is a drawing application.</para>
457 <indexterm zone="openoffice sdraw">
458 <primary sortas="b-sdraw">sdraw</primary>
459 </indexterm>
460 </listitem>
461 </varlistentry>
462
463 <varlistentry id="simpress">
464 <term><command>simpress</command></term>
465 <listitem>
466 <para>is a presentation application.</para>
467 <indexterm zone="openoffice simpress">
468 <primary sortas="b-simpress">simpress</primary>
469 </indexterm>
470 </listitem>
471 </varlistentry>
472
473 <varlistentry id="smath">
474 <term><command>smath</command></term>
475 <listitem>
476 <para>is a mathematical formula editor.</para>
477 <indexterm zone="openoffice smath">
478 <primary sortas="b-smath">smath</primary>
479 </indexterm>
480 </listitem>
481 </varlistentry>
482
483 <varlistentry id="soffice">
484 <term><command>soffice</command></term>
485 <listitem>
486 <para>opens a base window with access to all
487 <application>OpenOffice</application> applications.</para>
488 <indexterm zone="openoffice soffice">
489 <primary sortas="b-soffice">soffice</primary>
490 </indexterm>
491 </listitem>
492 </varlistentry>
493
494 <varlistentry id="spadmin">
495 <term><command>spadmin</command></term>
496 <listitem>
497 <para>is the <application>OpenOffice</application> printer
498 configuration utility.</para>
499 <indexterm zone="openoffice spadmin">
500 <primary sortas="b-spadmin">spadmin</primary>
501 </indexterm>
502 </listitem>
503 </varlistentry>
504
505 <varlistentry id="swriter">
506 <term><command>swriter</command></term>
507 <listitem>
508 <para>is a word processing application.</para>
509 <indexterm zone="openoffice swriter">
510 <primary sortas="b-swriter">swriter</primary>
511 </indexterm>
512 </listitem>
513 </varlistentry>
514
515 </variablelist>
516
517 </sect2>
518
519</sect1>
Note: See TracBrowser for help on using the repository browser.