source: archive/suites/openoffice.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 5 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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