source: xsoft/suites/openoffice.xml@ d118bb3

<?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        "9555a2d5fae9a25c788cc732921ef57a">
  <!ENTITY openoffice-core-size          "138 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 "1e20befe2fdb65c00be11f1f5d9ebdca">
  <!ENTITY openoffice-system-size "36 MB">
  <!ENTITY openoffice-buildsize     "4.3 GB">
  <!ENTITY openoffice-time          "75 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>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;-use_bin_hsqldb-1.patch"/>
        </para>
      </listitem>

      <listitem>
        <para>Required download if you wish to build the in-tree
        <application>Mozilla</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>

      <listitem>
        <para>Optional download if you wish to build the 
        <application>OpenOffice</application> SDK:
        <ulink url="ftp://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_sdk.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.x</application> file formats:
        <ulink url="ftp://ftp.osuosl.org/pub/openoffice/stable/&openoffice-version;/OOo_&openoffice-version;_src_binfilter.tar.bz2"/></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"/>,
    <xref linkend="libxml2"/>,
    <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">Recommended</bridgehead>
    <para role="recommended"><xref linkend="libart_lgpl"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><ulink
    url="http://packages.debian.org/testing/libdevel/libaltlinuxhyph-dev">ALTLinuxhyph</ulink>,
    <ulink url="http://boost.sourceforge.net/">boost</ulink>,
    <xref linkend="cups"/>,
    <xref linkend="curl"/>,
    <xref linkend="db"/> (with Java support), 
    <xref linkend="desktop-file-utils"/>,
    <ulink url="http://www.easysw.com/epm/">EPM</ulink>,
    <xref linkend="evolution"/>,
    <xref linkend="gnome-vfs"/>,
    <ulink url="http://www.cs.man.ac.uk/~toby/alan/software/">GPC</ulink>,
    <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="linux-pam"/>,
    <xref linkend="firefox"/> (with ldap support),
    <ulink url="http://lingucomponent.openoffice.org/MySpell-3.zip">MySpell</ulink>,
    <ulink url="http://lingucomponent.openoffice.org/thesaurus.html">MyThes</ulink>,
    <xref linkend="nas"/>,
    <ulink url="http://www.webdav.org/neon/">neon</ulink>,
    <xref linkend="openldap"/>,
    <ulink url="http://www.portaudio.com/">PortAudio</ulink>,
    <xref linkend="python"/>,
    <ulink url="http://www.gingerall.com/charlie/ga/xml/p_sab.xml">Sablotron</ulink>,
    <xref linkend="sane"/>,
    <xref linkend="startup-notification"/>,
    <ulink url="http://sourceforge.net/projects/stlport/">STLPort</ulink>, 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 now
    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 src and core tarballs.
    Additionally, the source directory name is not consistent with
    the tarball name amd will be named OOG680_m9.</para>

    <para>If you wish to build an in-tree <application>Mozilla</application>,
    as opposed to using a system wide installation, copy the
    <application>Mozilla</application> source tarball into the source
    tree:</para>

<screen><userinput>cp ../mozilla-source-1.7.5.tar.gz 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>solenv/inc/unxlngi6.mk</filename>
    for i686.  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>config_office/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.  Additionally, if
    you have installed <application>KDE</application> in the
    <filename>/opt</filename> prefix, and would like to use the
    <parameter>--enable-kde</parameter> switch, you must set
    <command>KDEDIR=$KDE_PREFIX</command> before running
    configure.</para></note>

    <para>Configure <application>OpenOffice</application> using the following
    commands:</para>

<screen><userinput>cd config_office/ &amp;&amp;
./configure --prefix=/opt/openoffice-&openoffice-version; \
    --enable-libart --disable-fontooo --disable-gnome-vfs \
    --without-fonts --with-system-stdlibs --without-system-jars \
    --with-system-freetype --with-system-expat --with-system-libxml \
    --with-system-zlib --enable-cairo --enable-build-mozilla \
    --with-build-version=BLFS --with-package-format=native \
    --disable-binfilter --disable-odk --disable-qadevooo \
    --with-use-shell=bash &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>patch -Np1 -i ../OOo_&openoffice-version;-use_bin_hsqldb-1.patch &amp;&amp;
./bootstrap &amp;&amp;
. LinuxX86Env.Set.sh &amp;&amp;
dmake</userinput></screen>

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

    <para>Install <application>OpenOffice</application> as the
    <systemitem class="username">root</systemitem> user with the
    following commands:</para>

<screen role="root"><userinput>pushd instsetoo_native/unxlngi6.pro/OpenOffice/\
native/install/en-US/linux-2.6-intel/buildroot/opt &amp;&amp;
cp -r -v openoffice.org2.3 /opt/openoffice-&openoffice-version; &amp;&amp;
popd</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-&openoffice-version;/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 -r -v HighContrast/*x* /usr/share/icons/HighContrast &amp;&amp;
cp -r -v hicolor/*x* /usr/share/icons/hicolor &amp;&amp;
cp -r -v locolor/*x* /usr/share/icons/locolor</userinput></screen>

    <para>If you have installed <xref linkend="desktop-file-utils"/>, 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-&openoffice-version;/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 -v *.desktop /usr/share/applications &amp;&amp;
update-desktop-database</userinput></screen>

    <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>/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><parameter>--enable-*</parameter>: The switches listed in the
    example configure command above force the use of system installed
    libraries that are known to be available on a BLFS system that meets
    the required and recommended dependencies.</para>

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

    <para><parameter>--disable-gnome-vfs</parameter>: Disable the use of
    <application>Gnome Virtual File System</application> libraries.  Omit
    this switch if you have Gnome installed.</para>

    <para><parameter>--without-fonts</parameter>: Do not install Bitstream
    Vera fonts since they are already included in X Window System
    Environment.</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>--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>: This switch
    disables the build of <application>RPM</application> packages.</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 binfilter package
    above.</para>

    <para><parameter>--disable-odk</parameter>: This switch disables the build
    of the <application>OpenOffice</application> SDK.  Ommit this switch if
    you've downloaded the sdk package above.</para>

    <para><parameter>--disable-qadevooo</parameter>: This switch skips
    the building of the quality assurance components used by the OOo
    dev team.</para>

    <para><parameter>--with-system-mozilla=<replaceable>[mozilla-type]</replaceable>
    </parameter>: Enables the use of system installed 
    <application>gecko</application> or <application>XULRunner</application>
    engine 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.  If you omit the type of installation,
    the build system defaults to <parameter>xulrunner</parameter>.</para>

    <para><parameter>--disable-cups</parameter>: Disable the use of
    <application>CUPS</application> for printing.</para>

    <para><parameter>--with-lang=<replaceable>&lt;LANG&gt;</replaceable></parameter>:
    Allows the use of additional languages in 
    <application>OpenOffice</application>. 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>. ENUS is the default.</para>

    <para><parameter>--with-use-shell=bash</parameter>: Tells the OOo build
    system to use bash as opposed to tcsh.</para>

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

    <para><command>dmake</command>: Compiles the package.</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>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>