source: archive/suites/openoffice.xml@ acb648f

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/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-core-download-http   "http://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_core.tar.bz2">
  <!ENTITY openoffice-core-download-ftp    "ftp://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_core.tar.bz2">
  <!ENTITY openoffice-core-md5sum          "4fa713fb796bc57e5eb9dfb0758adda0">
  <!ENTITY openoffice-core-size            "205 MB">
  <!ENTITY openoffice-system-download-http "http://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_system.tar.bz2">
  <!ENTITY openoffice-system-download-ftp  "ftp://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_system.tar.bz2">
  <!ENTITY openoffice-system-md5sum        "e6405c8108bdcf4cc2bf066d88aa5ae1">
  <!ENTITY openoffice-system-size          "59 MB">
  <!ENTITY openoffice-buildsize            "4.9-7.3 GB (depending on configured options)">
  <!ENTITY openoffice-time                 "96-109 SBU (depending on configured options)">
]>

<sect1 id="openoffice" xreflabel="OpenOffice-&openoffice-version;">
  <?dbhtml filename="openoffice.html" ?>

  <sect1info>
    <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>OpenOffice Core Download (HTTP): <ulink url="&openoffice-core-download-http;"/></para>
      </listitem>
      <listitem>
        <para>OpenOffice Core Download (FTP): <ulink url="&openoffice-core-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>OpenOffice Core Download MD5 sum: &openoffice-core-md5sum;</para>
      </listitem>
      <listitem>
        <para>OpenOffice Core Download size: &openoffice-core-size;</para>
      </listitem>
      <listitem>
        <para>OpenOffice System Download (HTTP): <ulink url="&openoffice-system-download-http;"/></para>
      </listitem>
      <listitem>
        <para>OpenOffice System Download (FTP): <ulink url="&openoffice-system-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>OpenOffice System Download MD5 sum: &openoffice-system-md5sum;</para>
      </listitem>
      <listitem>
        <para>OpenOffice System Download size: &openoffice-system-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:
        <ulink url="&patch-root;/OOo_&openoffice-version;-build_with_db5-1.patch"/>
        </para>
      </listitem>
      <listitem>
        <para>Required download:
        <ulink url="ftp://ftp.mozilla.org/pub/mozilla.org/seamonkey/releases/1.1.14/seamonkey-1.1.14.source.tar.bz2"/></para>
      </listitem>
      <listitem>
        <para>Optional download if you would like to localize the
        installation:
        <ulink url="ftp://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_l10n.tar.bz2"/></para>
      </listitem>
      <listitem>
        <para>Optional download if you need to support the old
        <application>StarOffice-5.2</application> file formats:
        <ulink url="ftp://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_binfilter.tar.bz2"/></para>
      </listitem>
      <listitem>
        <para>Optional download if you want to build additional extensions
        for <application>OpenOffice</application>:
        <ulink url="ftp://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_extensions.tar.bz2"/></para>
      </listitem>
      <listitem>
        <para>Optional download if you want to build the office development kit
        (cross platform requirement is not optional):
        <ulink url="http://tools.openoffice.org/unowinreg_prebuild/680/unowinreg.dll"/></para>
      </listitem>
    </itemizedlist>
    <bridgehead renderas="sect3">OpenOffice Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="apache-ant"/>,
    <xref linkend="gtk2"/>,
    <xref linkend="libidl"/>,
    <application>Perl Modules</application>
    <xref linkend="perl-xml-parser"/> and
    <xref linkend="perl-archive-zip"/>,
    <xref linkend="unzip"/>,
    <xref linkend="which"/>, and
    <xref linkend="zip"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><ulink
    url="http://packages.debian.org/testing/libdevel/libaltlinuxhyph-dev">ALTLinuxhyph</ulink>,
    <xref linkend="boost"/>,
    <xref linkend="cups"/>,
    <xref linkend="curl"/>,
    <xref linkend="db"/> (built with Java support),
    <xref linkend="desktop-file-utils"/>,
    <ulink url="http://www.easysw.com/epm/">EPM</ulink>,
    <xref linkend="evolution"/>,
    <!--<xref linkend="gnome-vfs"/> (should use \-\-enable-gio instead),-->
    <!-- <xref linkend="kde"/>, -->
    <xref linkend="libjpeg"/>,
    <ulink url="http://www.mega-nerd.com/libsndfile/">libsndfile</ulink>,
    <xref linkend="libtiff"/>,
    <ulink url="http://freshmeat.net/projects/libwpd/">libwpd</ulink>,
    <xref linkend="libxslt"/>,
    <xref linkend="libxml2"/>,
    <xref linkend="linux-pam"/>,
    <ulink url="http://lingucomponent.openoffice.org/MySpell-3.zip">MySpell</ulink>,
    <ulink url="http://lingucomponent.openoffice.org/thesaurus.html">MyThes</ulink>,
    <xref linkend="neon"/>,
    <xref linkend="openldap"/>,
    <xref linkend="python2"/>,
    <xref linkend="sane"/>,
    <xref linkend="startup-notification"/>, and
    <xref linkend="unixodbc"/></para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/openoffice"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of OpenOffice</title>

    <para>The <application>OpenOffice</application> source code is
    distributed in several tarballs.  You should extract each from the
    same top-level directory before entering the build directory.  At
    a minimum, you will need to extract the <quote>core</quote> and
    <quote>system</quote> tarballs. Note that the source directory name
    is not consistent with the tarball name and will be named
    <filename class='directory'>OOO320_m19</filename>.</para>

    <para>It is possible to build with a system-installed
    <application>Mozilla</application>, however, it requires a very intrusive
    patch, and is version specific.  Additionally, you'll need to build against
    <xref linkend="seamonkey"/> or <xref linkend="thunderbird"/> for full
    LDAP and address book functionality.  Instead, use the in-tree
    <application>Seamonkey</application> build.  Copy the tarball into
    the source tree with the following command:</para>

<screen><userinput>cp ../seamonkey-1.1.14-source.tar.bz2 moz/download/</userinput></screen>

    <para>If you want to optimize the build, edit the appropriate makefile in
    <filename>solenv/inc/</filename> and add the desired optimization
    flags to the <envar>CFLAGSOPT</envar> variable. The makefiles are arch
    specific, for instance edit <filename>unxlngi6.mk</filename> for i686, or
    <filename>unxlngx6.mk</filename> for x86_64.  Some users have reported
    problems with <option>-fomit-frame-pointer</option>. The best option is to
    not use any custom optimizations.</para>

    <note>
      <para>Because of the complexity of the
      <application>OpenOffice</application> build system, it is not possible to
      provide generic build instructions for all systems.  You should review
      the output of <command>configure --help</command> and take advantage of
      any system installed programs and libraries available using the
      <parameter>--enable-*</parameter>, <parameter>--disable-*</parameter>,
      and <parameter>--with-system-*</parameter> parameters, and provide any
      additional environment variables needed.</para>
    </note>

    <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>Install <application>OpenOffice</application> by running the
    following commands:</para>

<!-- uudecode didn't fuss...but left in for reference
sed -i 's@..$/dist$/configure@uudecode="no" &amp;@' \
    berkeleydb/makefile.mk &amp;&amp;
-->

<screen><userinput>patch -Np1 -i ../OOo_&openoffice-version;-with-system-db5-1.patch &amp;&amp;
autoreconf &amp;&amp;
PKG_CONFIG=/usr/bin/pkg-config ./configure \
            --disable-binfilter            \
            --disable-fontooo              \
            --disable-gnome-vfs            \
            --disable-odk                  \
            --disable-qadevooo             \
            --enable-cairo                 \
            --without-afms                 \
            --without-fonts                \
            --without-ppds                 \
            --without-pam                  \
            --with-system-stdlibs          \
            --with-system-cairo            \
            --with-system-expat            \
            --with-system-zlib             \
            --with-package-format=native   \
            --with-vendor="BLFS"           \
            --with-use-shell=bash &amp;&amp;
source LinuxX86Env.Set.sh &amp;&amp;
./bootstrap &amp;&amp;
make</userinput></screen>

    <para>This package does not come with a test suite.</para>

    <para>Now, as the <systemitem class="username">root</systemitem>
     user:</para>

<screen role="root"><userinput>pushd instsetoo_native/unxlng?6.pro/OpenOffice/\
native/install/en-US/linux-2.6-*/buildroot/opt &amp;&amp;
cp -r -v openoffice.org3 /opt/openoffice-&openoffice-version; &amp;&amp;
cp -r -v openoffice.org/* /opt/openoffice-&openoffice-version; &amp;&amp;
ln -sf basis3.2 /opt/openoffice-&openoffice-version;/basis-link &amp;&amp;
popd &amp;&amp;

for appl in sbase scalc sdraw simpress smath soffice spadmin swriter
do
    ln -v -sf /opt/openoffice-&openoffice-version;/program/$appl /usr/bin
done &amp;&amp;

pushd sysui/desktop/icons &amp;&amp;
install -v -m755 -d /usr/share/icons/{hicolor,locolor} &amp;&amp;
cp -r -v hicolor/* /usr/share/icons/hicolor &amp;&amp;
cp -r -v locolor/* /usr/share/icons/locolor &amp;&amp;
popd</userinput></screen>

    <para>If you have installed <xref linkend="desktop-file-utils"/>, you
    should copy the <filename class='extension'>*.desktop</filename> files to
    <filename class='directory'>/usr/share/applications</filename> using the
    following commands as the <systemitem class="username">root</systemitem>
    user:</para>

<screen role="root"><userinput>install -v -d -m755 /usr/share/applications &amp;&amp;
pushd /opt/openoffice-&openoffice-version;/share/xdg/ &amp;&amp;
for appl in *.desktop
do
    sed -i '/Exec/d' $appl &amp;&amp;
    echo "Exec=/usr/bin/s`echo $appl | sed 's/.desktop//'`" >> $appl &amp;&amp;
    sed -i '/Icon/d' $appl &amp;&amp;
    echo "Icon=`echo "ooo-${appl}3.2" | sed 's/\.desktop//'`" >> $appl
done &amp;&amp;
sed -i 's@bin/sprinteradmin@bin/spadmin@' printeradmin.desktop &amp;&amp;
cp -v *.desktop /usr/share/applications &amp;&amp;
update-desktop-database &amp;&amp;
popd</userinput></screen>

    <para>If you've chosen to build any additional dictionaries or any of the
    extensions, you'll need to copy them to the installation directory.  Run
    the following commands as the
    <systemitem class="username">root</systemitem> user:</para>

    <note><para>The following two command blocks will not exit with a zero
    value, and the second will require you to press 'y' before installation.
    Keep this in mind if scripting the build.</para></note>

<screen role="root"><userinput>cp -v dictionaries/unxlngi6.pro/bin/dict-*.oxt \
    sdext/unxlngi6.pro/bin/*.oxt \
    reportbuilder/unxlngi6.pro/bin/report-builder.oxt \
    swext/unxlngi6.pro/bin/wiki-publisher.oxt \
    /opt/openoffice-3.2.1/share/extension/install</userinput></screen>

    <para>Now, while still the <systemitem class="username">root</systemitem>
    user, add everything into the shared installation:</para>

<screen role="root"><userinput>for ext in /opt/openoffice-3.2.1/share/extension/install/*.oxt
do
    /opt/openoffice-3.2.1/program/unopkg add --shared --verbose $ext
done</userinput></screen>

    <note><para><application>OpenOffice</application> default language tools
    will not work out of the box.  You will have to explicitly select the
    proper language settings from within one of the installed  programs by
    going into the Tools menu and selecting Options.  Under Language Settings,
    Languages, select the desired language for all settings.  Do not leave
    "Default" in any drop down menu here.</para></note>

    <para>Finally, if you'd like to edit <application>OpenOffice</application>
    documents directly from <xref linkend="seamonkey"/> or
    <xref linkend="firefox"/>, create a symbolic link in your
    plugins directory to <filename
    class='libraryfile'>/opt/openoffice-&openoffice-version;/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><envar>PKG_CONFIG=/usr/bin/pkg-config</envar>:
    This variable must be set as the version check in
    <filename>configure</filename> is broken.</para>

    <para><parameter>--disable-binfilter</parameter>: This switch disables
    the build of legacy <application>StarOffice-5</application> import
    filters.  Omit this switch if you've downloaded the
    <application>binfilter</application> package
    above.  Warning: Installation of the legacy import filters increases the
    build time considerably.  Only install them if you have these old
    file types, and need to edit them in
    <application>OpenOffice</application>.</para>

    <para><parameter>--disable-fontooo</parameter>: Use
    <application>Fontconfig</application> instead of the FontOOo.</para>

    <para><parameter>--disable-gnome-vfs</parameter>: Disable the use of
    <application>Gnome Virtual File System</application> libraries.  Omit
    this switch only if gio is not available.</para>

    <para><parameter>--disable-odk</parameter>: This switch disables the build
    of the <application>OpenOffice</application> SDK.  Omit this switch if
    you've downloaded the SDK package (and additional requirements)
    above.</para>

    <para><parameter>--disable-qadevooo</parameter>: This switch skips
    the building of the quality assurance tools used by the
    <application>OpenOffice</application> development teams.</para>

    <para><parameter>--enable-cairo</parameter>: This switch listed in the
    example <command>configure</command> command above forces the use of the
    system installed cairo.</para>

    <para><parameter>--without-afms</parameter>: Do not install afm font types
    as system installed TrueType fonts are already available.</para>

    <para><parameter>--without-fonts</parameter>: Do not install Bitstream
    Vera fonts since they are already included in the
    <application>X</application> Window System Environment.</para>

    <para><parameter>--without-ppds</parameter>: Do not install printer
    description files as these should be handled by your print system.</para>

    <para><parameter>--without-pam</parameter>: Disable the use of
    <application>Linux-PAM</application> functions.  Omit this switch if
    <application>Linux-PAM</application> is installed.</para>

    <para><parameter>--with{,out}-system-*</parameter>: Determines
    whether to use the system libraries and programs or to build
    the source packages included in the build tree.</para>

    <para><parameter>--with-build-version="3.2.1-1"</parameter>: Changes the
    build version to append "-1" to the default version string.</para>

    <para><parameter>--with-vendor="BLFS"</parameter>: Changed the vendor
    string to "BLFS" in the help->about dialog.</para>

    <para><parameter>--with-use-shell=bash</parameter>: Tells the
    <application>OpenOffice</application> build system to use
    <command>bash</command> instead of <command>tcsh</command>.</para>

    <para><command>./bootstrap</command>: Build the
    <command>dmake</command> utility required to complete the
    build.</para>

    <para>
    <parameter>--with-lang=<replaceable>&lt;LANG&gt;</replaceable></parameter>:
    Allows the use of additional languages in
    <application>OpenOffice</application>. US English (ENUS) is the
    default.</para>

    <para>
    <parameter>--with-dict=<replaceable>&lt;LANG&gt;</replaceable></parameter>:
    Allows the use of alternate dictionaries in
    <application>OpenOffice</application>. US English (ENUS) is the
    default.</para>

    <para><parameter>--with-use-shell=bash</parameter>: Tells the
    <application>OpenOffice</application> build system to use
    <command>bash</command> instead of <command>tcsh</command>.</para>

    <para><command>./bootstrap</command>: Build the
    <command>dmake</command> utility required to complete the
    build.</para>

    <para><command>for appl in sbase scalc...</command>: Creates symlinks
    for the applications in
    <filename class="directory">/usr/bin</filename>.</para>

    <para><command>for appl in *.desktop...</command>: Edit the
    <filename>*.desktop</filename> 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>sbase, scalc, sdraw, simpress, smath, soffice, spadmin,
        and swriter</seg>
        <seg><application>OpenOffice</application> libraries</seg>
        <seg>/opt/openoffice-&openoffice-version;</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>is a 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>is a 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>is a 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>is a 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>is a 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>is the <application>OpenOffice</application> printer
          configuration utility.</para>
          <indexterm zone="openoffice spadmin">
            <primary sortas="b-spadmin">spadmin</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="swriter">
        <term><command>swriter</command></term>
        <listitem>
          <para>is a word processing application.</para>
          <indexterm zone="openoffice swriter">
            <primary sortas="b-swriter">swriter</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>