glfs/xsoft/suites/openoffice.xml
DJ Lucas 2e7058a689 Corrected text in OpenOffice instructions.
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5276 af4574ff-66df-0310-9fd7-8a98e5e911e0
2005-11-16 04:08:26 +00:00

468 lines
17 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY openoffice-download-http "http://download.openoffice.org/&openoffice-version;/source.html">
<!ENTITY openoffice-download-ftp "ftp://ftp.ussg.iu.edu/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src.tar.gz">
<!ENTITY openoffice-md5sum "a68933afc2bf432d11b2043ac99ba0aa">
<!ENTITY openoffice-size "263 MB">
<!ENTITY openoffice-buildsize "5.7 GB">
<!ENTITY openoffice-time "117 SBU">
]>
<sect1 id="openoffice" xreflabel="OpenOffice-&openoffice-version;">
<?dbhtml filename="openoffice.html" ?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>OpenOffice-&openoffice-version;</title>
<indexterm zone="openoffice">
<primary sortas="a-OpenOffice">OpenOffice</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to OpenOffice</title>
<para><application>OpenOffice</application> is an office suite, the
open source sibling of <application>StarOffice</application>.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&openoffice-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&openoffice-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &openoffice-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &openoffice-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &openoffice-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &openoffice-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing='compact'>
<listitem>
<para>Required patch for use with gcc-&gcc-version;: <ulink
url="&patch-root;/OOo_&openoffice-version;-gcc4-1.patch"/>
</para>
</listitem>
<listitem>
<para>Required patch for use with NPTL: <ulink
url="&patch-root;/OOo_&openoffice-version;-nptl-1.patch"/></para>
</listitem>
<listitem>
<para>Required patch for use with
<application>JDK</application>-&jdk-src-version;: <ulink
url="&patch-root;/OOo_&openoffice-version;-jdk_1.5.0_fix-1.patch"/>
</para>
</listitem>
<listitem>
<para>Optional patch if you wish to use the system freetype:
<ulink
url="&patch-root;/OOo_&openoffice-version;-freetype-1.patch"/></para>
</listitem>
<!-- To be added after verification
<listitem>
<para>Optional patch if
<application>Linux-PAM</application>-&Linux_PAM-version; is not
installed: <ulink
url="&patch-root;/OOo_&openoffice-version;-no_pam-1.patch"/></para>
</listitem>
-->
<!-- Will be added after patch header is corrected.
<listitem>
<para>Optional patch if building against the system installed
<application>Firefox</application>: <ulink
url="&patch-root;/OOo_&openoffice-version;-xmlsec_no_mozilla-1.patch"/>
</para>
</listitem>
-->
<listitem>
<para>Required update for use with
<application>JDK-&jdk-src-version;</application>. <ulink
url="ftp://anduin.linuxfromscratch.org/BLFS/svn/b/bsh-2.0b4-src.tar.bz2"/>
</para>
</listitem>
<listitem>
<para>Optional download if not using the system
<application>Mozilla</application>
<!-- or <application>Firefox</application> -->
browser. <ulink
url="ftp://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7.5/source/mozilla-source-1.7.5.tar.gz"/></para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">OpenOffice Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para><xref linkend="zip"/>,
<xref linkend="unzip"/>,
<xref linkend="tcsh"/>,
<xref linkend="which"/>,
<xref linkend="jdk"/>,
<xref linkend="apache-ant"/>,
<xref linkend="pkgconfig"/>,
<xref linkend="perl-xml-parser"/>,
<xref linkend="perl-archive-zip"/>,
<xref linkend="libidl"/>, and
<xref linkend="libxml2"/>.</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para><xref linkend="freetype2"/>,
<xref linkend="startup-notification"/>,
<xref linkend="desktop-file-utils"/>,
<xref linkend="libart_lgpl"/>, and
<xref linkend="curl"/>,
<xref linkend="libjpeg"/>, and
<xref linkend="libtiff"/>.</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para><xref linkend="Linux_PAM"/>,
<xref linkend="nas"/>,
<xref linkend="python"/>,
<ulink url="http://www.webdav.org/neon/">neon-0.25.4</ulink>,
<xref linkend="unixodbc"/>,
<xref linkend="mozilla"/>, and
<!-- <xref linkend="mozilla"/> or <xref linkend="firefox"/>, and -->
<xref linkend="sane"/>.</para>
</sect2>
<sect2 role="installation">
<title>Installation of OpenOffice</title>
<para>Apply all of the downloaded patches:</para>
<screen><userinput>for PATCH in ../OOo_&openoffice-version;-*.patch
do patch -Np1 -i ${PATCH}
done</userinput></screen>
<para>Copy the <application>Beanshell</application> TAR ball into the
source tree and uncompress it:</para>
<screen><userinput>cp ../bsh-2.0b4.tar.bz2 beanshell/download/ &amp;&amp;
bzip2 -d beanshell/download/bsh-2.0b4.tar.bz2</userinput></screen>
<para>If not using the system-installed <application>Mozilla</application>
or <application>Firefox</application>, copy the
<application>Mozilla</application> source TAR ball into the source
tree:</para>
<screen><userinput>cp ../mozilla-1.7.5.tar.gz moz/download/</userinput></screen>
<para>If you want to optimize the build, edit
<filename>solenv/inc/unxlngi6.mk</filename> and add the desired optimization
flags to the <envar>CFLAGSOPT</envar> variable. Some users have reported
problems with <option>-fomit-frame-pointer</option>. The best option
is to not use any custom optimizations. The following command removes an
incorrect <option>-mcpu</option> option in the above file:</para>
<screen><userinput>sed -i "s:\-mcpu=pentiumpro::" \
solenv/inc/unxlngi6.mk</userinput></screen>
<!-- To be removed before final release -->
<note><para>If you have previously installed Mozilla
<!-- or Firefox, -->
a change
may be needed to the installed headers. As the root user, use these
commands to make the change if needed.</para></note>
<!-- <para>Mozilla:</para> -->
<screen role="root"><userinput>cd /usr/include/mozilla-&mozilla-version; &amp;&amp;
grep "xptinfo_enum_1" xpcom/xptinfo.h || \
sed -i 's@enum@enum xptinfo_enum_1@' xpcom/xptinfo.h</userinput></screen>
<!-- <para>Firefox:</para>
<screen role="root"><userinput>cd /usr/include/firefox-&firefox-version; &amp;&amp;
grep "xptinfo_enum_1" xpcom/xptinfo.h || \
sed -i 's@enum@enum xptinfo_enum_1@' xpcom/xptinfo.h</userinput></screen>
-->
<!-- End TBR -->
<para>Configure <application>OpenOffice</application> using the following
commands:</para>
<!-- To be added after xmlsec_no_mozilla patch header is corrected
<note><para>If you intend to use the system-installed
<application>Mozilla</application> or
<application>Firefox</application>, replace the
<parameter> - - enable-build-mozilla</parameter> switch with
<parameter>- -with-system-mozilla</parameter>. Additionally for
<application>Firefox</application>, add the
<parameter>- -with-firefox</parameter> switch. You will also be
unable to use a <application>Thunderbird</application> address
book as a data source if built against
<application>Firefox</application>.</para></note>
-->
<note><para>If you intend to use the system-installed
<application>Mozilla</application>, replace the
<parameter>--enable-build-mozilla</parameter> switch with
<parameter>--with-system-mozilla</parameter>.</para></note>
<screen><userinput>cd config_office/ &amp;&amp;
./configure --prefix=/opt/openoffice-2.0.0 \
--enable-libart --enable-libsn \
--disable-fontooo --without-fonts \
--with-system-stdlibs --with-system-freetype \
--with-system-zlib --with-system-jpeg \
--with-system-expat --with-system-libxml \
--with-system-curl --enable-build-mozilla \
--with-build-version=BLFS \
--with-package-format=native --disable-binfilter &amp;&amp;
cd ..</userinput></screen>
<para><application>OpenOffice</application> fails to compile if
<command>umask</command> is set to something exotic. The build can also
fail if the <envar>LANG</envar> or <envar>LC_ALL</envar> environment
variables are set. Use the following commands to change your
environment accordingly:</para>
<screen><userinput>umask 0022 &amp;&amp;
unset LANG LC_ALL</userinput></screen>
<para>Compile <application>OpenOffice</application> using the following
commands:</para>
<screen><userinput>./bootstrap &amp;&amp;
. LinuxIntelEnv.Set.sh &amp;&amp;
dmake</userinput></screen>
<para>Install <application>OpenOffice</application> as the
<systemitem class="username">root</systemitem> user with the
following commands:</para>
<screen role="root"><userinput>cd instsetoo_native/unxlngi6.pro/OpenOffice/\
install/en-US/linux-2.6-intel/buildroot/opt &amp;&amp;
cp -a openoffice.org2.0 /opt/openoffice-2.0.0</userinput></screen>
<para>Still as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>for appl in sbase scalc sdraw simpress smath soffice spadmin swriter
do
ln -v -sf /opt/openoffice-2.0.0/program/$appl /usr/bin/$appl
done</userinput></screen>
<para>The icons are not installed by default. While still the
<systemitem class="username">root</systemitem> user, install the icons
with the following commands:</para>
<screen role="root"><userinput>cd ../../../../../../../../sysui/desktop/icons &amp;&amp;
install -v -d /usr/share/icons/{HighContrast,hicolor,locolor} -m755 &amp;&amp;
cp -a HighContrast/*x* /usr/share/icons/HighContrast &amp;&amp;
cp -a hicolor/*x* /usr/share/icons/hicolor &amp;&amp;
cp -a locolor/*x* /usr/share/icons/locolor</userinput></screen>
<para>If you have installed <xref linkend="desktop-file-utils"/> and use
<application>KDE</application>, there is no furthur configuration
necessary. If you use <application>Gnome</application>, you should copy
the <filename>*.desktop</filename> files to
<filename>/usr/share/applications</filename> with the following
commands as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>install -v -d /usr/share/applications -m 755 &amp;&amp;
cd /opt/openoffice-2.0.0/share/xdg/ &amp;&amp;
for appl in *.desktop
do
sed -i '/Exec/d' $appl
echo "Exec=/usr/bin/s`echo $appl | sed 's/.desktop//'`" >> $appl
sed -i '/Icon/d' $appl
echo "Icon=`echo $appl | sed 's/.desktop//'`" >> $appl
done &amp;&amp;
sed -i 's@bin/sprinteradmin@bin/spadmin@' printeradmin.desktop &amp;&amp;
cp *.desktop /usr/share/applications</userinput></screen>
<para>Finally, if you'd like to edit <application>OpenOffice</application>
documents directly from <application>Mozilla</application> or
<application>Firefox</application>, create a symbolic link in your
plugins directory to
<filename>/opt/openoffice-2.0.0/program/libnpsoplugin.so</filename>.
Additionally, you must enable the plugin from the
<parameter>Internet Options</parameter> within any
<application>OpenOffice</application> application.</para>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><parameter>--enable-libart</parameter>: Use libart instead of gpc for
polygon clipping.</para>
<para><parameter>--enable-libsn</parameter>: Use
<application>startup-notification</application>.</para>
<para><parameter>--disable-fontooo</parameter>: Use
<application>Fontconfig</application> instead of FontOOo.</para>
<para><parameter>--without-fonts</parameter>: Do not install Bitstream Vera
fonts since they are already bundled with
<application>X</application>.</para>
<para><parameter>--with-system-*</parameter>: Use the system libraries
and programs instead of building the packagees included in the build
tree.</para>
<para><parameter>--enable-build-mozilla</parameter>: Build the in-tree
<application>Mozilla</application> suite.</para>
<para><parameter>--with-build-version=BLFS</parameter>:
appends "BLFS" to the end of the version string.</para>
<para><parameter>--with-package-format=native</parameter>: diables the
build of <application>RPM</application> packages.</para>
<para><parameter>--disable-binfilter</parameter>: disables the build of
legacy <application>StarOffice-5</application> import filters.</para>
<para><parameter>--with-firefox</parameter>: enables the use of
<application>Firefox</application> in place of the full
<application>Mozilla</application> suite. This will disable the use
of a <application>Thunderbird</application> address book as a data
source.</para>
<para><parameter>--with-lang=<replaceable>[LANG]</replaceable></parameter>:
Make install set for the desired language. ENUS is the default.</para>
<para><parameter>--with-dict=<replaceable>[LANG]</replaceable></parameter>:
Install dictionaries for the desired language. ENUS is the default.</para>
<para><command>./bootstrap</command>: Build the
<application>dmake</application> utility required to complete the
build.</para>
<para><command>dmake</command>: Compile the package.</para>
<para><command>for appl in *.desktop...</command>: Edit the *.desktop
files for use with a standard BLFS system.</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>scalc, sdraw, simpress, smath, soffice, spadmin, and swriter.</seg>
<seg><application>OpenOffice</application> libraries</seg>
<seg>/opt/openoffice-2.0.0</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="sbase">
<term><command>sbase</command></term>
<listitem>
<para>database application.</para>
<indexterm zone="openoffice sbase">
<primary sortas="b-sbase">sbase</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="scalc">
<term><command>scalc</command></term>
<listitem>
<para>spreadsheet application.</para>
<indexterm zone="openoffice scalc">
<primary sortas="b-scalc">scalc</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="sdraw">
<term><command>sdraw</command></term>
<listitem>
<para>drawing application.</para>
<indexterm zone="openoffice sdraw">
<primary sortas="b-sdraw">sdraw</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="simpress">
<term><command>simpress</command></term>
<listitem>
<para>presentation application.</para>
<indexterm zone="openoffice simpress">
<primary sortas="b-simpress">simpress</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="smath">
<term><command>smath</command></term>
<listitem>
<para>mathematical formula editor.</para>
<indexterm zone="openoffice smath">
<primary sortas="b-smath">smath</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="soffice">
<term><command>soffice</command></term>
<listitem>
<para>opens a base window with access to all
<application>OpenOffice</application> applications.</para>
<indexterm zone="openoffice soffice">
<primary sortas="b-soffice">soffice</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="spadmin">
<term><command>spadmin</command></term>
<listitem>
<para><application>OpenOffice</application> Printer Configuration.
You may need to run this if you are having any printing
problems.</para>
<indexterm zone="openoffice spadmin">
<primary sortas="b-spadmin">spadmin</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="swriter">
<term><command>swriter</command></term>
<listitem>
<para>word processing application.</para>
<indexterm zone="openoffice swriter">
<primary sortas="b-swriter">swriter</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>