source: xsoft/office/libreoffice.xml@ 5b9b502

<?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 libreoffice-dl "http://download.documentfoundation.org/libreoffice/src/&libreoffice-version;">

  <!ENTITY libreoffice-core-download-http "&libreoffice-dl;/libreoffice-&libreoffice-dlversion;.tar.xz">
  <!ENTITY libreoffice-core-md5sum        "b8d746b56e39b1926e61a4ede7c71891">
  <!ENTITY libreoffice-core-size          "198 MB">

  <!ENTITY libreoffice-dict-download-http "&libreoffice-dl;/libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz">
  <!ENTITY libreoffice-dict-md5sum        "d0b075239e5c628cc53eff999ea78868">
  <!ENTITY libreoffice-dict-size          "41 MB">

  <!ENTITY libreoffice-help-download-http "&libreoffice-dl;/libreoffice-help-&libreoffice-dlversion;.tar.xz">
  <!ENTITY libreoffice-help-md5sum        "383c63275294891f33da9b7d326671ee">
  <!ENTITY libreoffice-help-size          "16 MB">

  <!ENTITY libreoffice-translations-download-http "&libreoffice-dl;/libreoffice-translations-&libreoffice-dlversion;.tar.xz">
  <!ENTITY libreoffice-translations-md5sum        "2937eac11d5ac8f1a5d4c3f5920904ab">
  <!ENTITY libreoffice-translations-size          "135 MB">


  <!-- full size still accurate for 6.0.2, reconfiguring and rebuilding
   the built source after initial DESTDIR install doesn't take a vast time -->

  <!ENTITY libreoffice-buildsize          "6.2 GB (746 MB installed). Installing the whole set of languages was previously reported to require up to 26 GB (2.9 GB installed)">

  <!-- for 6.1.2.1 I allowed 2 SBU for downloads, my total was 
       64.76 SBU with fast downloads 
  -->
  <!ENTITY libreoffice-time               "64 SBU with parallelism=4 + download time">

]>

<sect1 id="libreoffice" xreflabel="LibreOffice-&libreoffice-dlversion;">
  <?dbhtml filename="libreoffice.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>LibreOffice-&libreoffice-version;</title>

  <indexterm zone="libreoffice">
    <primary sortas="a-LibreOffice">LibreOffice</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to LibreOffice</title>

    <para>
      <application>LibreOffice</application> is a full-featured office suite.
      It is largely compatible with <application>Microsoft Office</application>
      and is descended from <application>OpenOffice.org</application>.
    </para>

    &lfs83_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Core Download: <ulink url="&libreoffice-core-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Core Download MD5 sum: &libreoffice-core-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Core Download size: &libreoffice-core-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &libreoffice-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &libreoffice-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Dictionaries: <ulink url="&libreoffice-dict-download-http;"/>
        </para>
      </listitem>

      <listitem>
        <para>
          Dictionaries MD5 sum: &libreoffice-dict-md5sum;
        </para>
      </listitem>

      <listitem>
        <para>
          Dictionaries size: &libreoffice-dict-size;
        </para>
      </listitem>

      <listitem>
        <para>
          Help Files: <ulink url="&libreoffice-help-download-http;"/>
        </para>
      </listitem>

      <listitem>
        <para>
          Help Files MD5 sum: &libreoffice-help-md5sum;
        </para>
      </listitem>

      <listitem>
        <para>
          Help Files size: &libreoffice-help-size;
        </para>
      </listitem>

      <listitem>
        <para>
          Translations: <ulink url="&libreoffice-translations-download-http;"/>
        </para>
      </listitem>

      <listitem>
        <para>
          Translations MD5 sum: &libreoffice-translations-md5sum;
        </para>
      </listitem>

      <listitem>
        <para>
          Translations size: &libreoffice-translations-size;
        </para>
      </listitem>


<!-- keep one commented patch, it's sure to again need one or more in a few months -->
      <listitem>
        <para>
          Required patch to fix building with system <xref linkend="poppler"/> (all
          recent versions):
          <ulink url="&patch-root;/libreoffice-&libreoffice-dlversion;-poppler70-1.patch"/>
        </para>
      </listitem>

      <listitem>
        <para>
          Required patch to fix building with system <xref linkend="poppler"/>
          (only if using that version or a later version):
          <ulink url="&patch-root;/libreoffice-&libreoffice-dlversion;-poppler71-1.patch"/>
        </para>
      </listitem>

    </itemizedlist>
    <bridgehead renderas="sect3">LibreOffice Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="perl-archive-zip"/>,
      <xref linkend="unzip"/>,
      <xref linkend="wget"/>,
      <xref linkend="which"/>, and
      <xref linkend="zip"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <note>
      <para>
        Most of these packages are recommended because if they're not installed,
        the build process will compile and install its own (often older)
        version, with the side effect of increasing build and installed disk
        space and build time.
      </para>
    </note>

    <para role="recommended">
      <xref linkend="apache-ant"/>,
      <xref linkend="apr"/>,
      <xref linkend="boost"/>,
      <xref linkend="clucene"/>,
      <xref linkend="cups"/>,
      <xref linkend="curl"/>,
      <xref linkend="dbus-glib"/>,
      <xref linkend="libjpeg"/>,
      <xref linkend="glu"/>,
      <xref linkend="graphite2"/>,
      <xref linkend="gst10-plugins-base"/>,
      <xref linkend="gtk3"/> and
      <xref linkend="gtk2"/> (see <quote>Command Explanations</quote>),
      <xref linkend="harfbuzz"/>,
      <xref linkend="icu"/>,
      <xref linkend="libatomic_ops"/>,
      <xref linkend="lcms2"/>,
      <xref linkend="librsvg"/>,
      <xref linkend="libxml2"/> and
      <xref linkend="libxslt"/>,
      <xref linkend="mesa"/>,
      <xref linkend="neon"/>,
      <xref linkend="nss"/>,
      <xref linkend="openldap"/> (if connecting to an LDAP server),
      <xref linkend="poppler"/>,
      <xref linkend="postgresql"/>,
      <xref linkend="redland"/>,
      <xref linkend="serf"/>, and
      <xref linkend="unixodbc"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="avahi"/>,
      <xref linkend="bluez"/>,
      <xref linkend="dconf"/>,
      <xref linkend="desktop-file-utils"/>,
      <xref linkend="doxygen"/> (not relevant if using --disable-odk),
      <xref linkend="gdb"/>,
      <xref linkend="gnutls"/>,
      <xref linkend="junit"/>,
<!--      <xref linkend="kdelibs"/>, -->
      <xref linkend="mariadb"/> or <ulink url="http://www.mysql.com/">MySQL</ulink>,
      <xref linkend="mitkrb"/>,
      <xref linkend="nasm"/>,
      <xref linkend="sane"/>,
      <xref linkend="valgrind"/>,
      <xref linkend="vlc"/>,
      <ulink url="https://commons.apache.org/proper/commons-codec/">Apache Commons Codec</ulink>,
      <ulink url="https://hc.apache.org/httpclient-3.x/">Apache Commons HttpClient</ulink>,
      <ulink url="https://commons.apache.org/proper/commons-lang/">Apache Commons Lang</ulink>,
      <ulink url="https://commons.apache.org/proper/commons-logging/">Apache Commons Logging</ulink>,
      <ulink url="http://www.beanshell.org/">BeanShell</ulink>,
      <ulink url="https://projects.coin-or.org/CoinMP/">CoinMP</ulink>,
      <ulink url="http://sourceforge.net/projects/cppunit/">Cppunit</ulink>,
      <ulink url="http://www.firebirdsql.org/">Firebird</ulink>,
      <ulink url="http://downloads.sourceforge.net/glew/">glew (OpenGL Extension Wrangler Library)</ulink>,
      <ulink url="https://github.com/behdad/glyphy">glyphy</ulink>,
      <ulink url="http://ftp.gnome.org/pub/gnome/sources/gnome-vfs/">Gnome VFS</ulink>,

      <ulink url="https://github.com/hamcrest/JavaHamcrest/releases">hamcrest</ulink>,
      <ulink url="https://hunspell.github.io/">Hunspell</ulink>,
      <ulink url="http://sourceforge.net/projects/hunspell/files/Hyphen/">Hyphen</ulink>,
      <ulink url="http://include-what-you-use.org/">iwyu</ulink>,
      <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libabw">libabw</ulink>,
      <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libcdr">libcdr</ulink>,
      <ulink url="http://sourceforge.net/projects/libcmis/">libcmis</ulink>,
      <ulink url="http://www.sourceforge.net/projects/libebook/">libebook</ulink>,
      <ulink url="https://wiki.documentfoundation.org/Libexttextcat">libexttextcat</ulink>,
      <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libfreehand">libfreehand</ulink>,
      <ulink url="http://tagoh.bitbucket.org/liblangtag/">liblangtag</ulink>,
      <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libmspub">libmspub</ulink>,
      <ulink url="http://sourceforge.net/projects/libmwaw/">libmwaw</ulink>,
      <ulink url="http://sourceforge.net/projects/libwpd/files/libodfgen/">libodfgen</ulink>,
      <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libpagemaker">libpagemaker</ulink>,
      <ulink url="http://sourceforge.net/projects/libwpd/files/librevenge/">librevenge (WordPerfect Document importer)</ulink>,
      <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libvisio">libvisio</ulink>,
      <ulink url="http://libwpd.sourceforge.net/">libwpd</ulink>,
      <ulink url="http://libwpg.sourceforge.net/">libwpg</ulink>,
      <ulink url="http://libwps.sourceforge.net/">libwps</ulink>,
      <ulink url="http://lpsolve.sourceforge.net/">lp_solve</ulink>,
      <ulink url="https://gitlab.com/mdds/mdds">mdds</ulink>,
      <ulink url="http://sourceforge.net/projects/hunspell/files/MyThes/">MyThes</ulink>,
      <ulink url="http://sourceforge.net/projects/ogl-math/">ogl-math - OpenGL Mathematics (GLM)</ulink>,
      <ulink url="https://github.com/KhronosGroup/OpenCOLLADA/">OpenCOLLADA</ulink>,
      <ulink url="https://gitlab.com/orcus/orcus">Orcus</ulink>,
      <phrase revision="sysv"><ulink url="http://telepathy.freedesktop.org/releases/telepathy-glib/">telepathy-glib</ulink></phrase>
      <phrase revision="systemd"><xref linkend="telepathy-glib"/></phrase>,
      <ulink url="https://ukoethe.github.io/vigra/">VIGRA</ulink>, and
      <phrase revision="sysv"><ulink url="&gnome-download-http;/zenity/">Zenity</ulink></phrase>
      <phrase revision="systemd"><xref linkend="zenity"/></phrase>
    </para>

    <para>There are many optional dependencies not listed here. They can be
    found in <quote>download.lst</quote> (source directory).
    </para>

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

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

    <important>
      <para>
        Unlike the other packages, we assume that you have not yet unpacked the
        package. This is because the <option>--no-overwrite-dir</option>
        switch is needed in case you unpack as the <systemitem
        class="username">root</systemitem> user.
      </para>
    </important>

<screen><userinput>tar -xf libreoffice-&libreoffice-dlversion;.tar.xz --no-overwrite-dir &amp;&amp;
cd libreoffice-&libreoffice-dlversion;</userinput></screen>

    <para>
      Create symlinks to tarballs from the source directory so they won't
      get downloaded again:
    </para>

<screen><userinput>install -dm755 external/tarballs &amp;&amp;
ln -sv ../../../libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz external/tarballs/ &amp;&amp;
ln -sv ../../../libreoffice-help-&libreoffice-dlversion;.tar.xz         external/tarballs/</userinput></screen>

    <para>
      If you have downloaded the translations tarball, create a symlink:
    </para>

<screen><userinput>ln -sv ../../../libreoffice-translations-&libreoffice-dlversion;.tar.xz external/tarballs/</userinput></screen>

    <note>
      <para>
        During the build process, some packages will be downloaded (including
        the ones listed as recommended and optional dependencies) if they are
        not present on the system. Because of this, build time may vary from the
        published time more than usual.
      </para>
    </note>

    <para>
      Due to the large size of the package, you may prefer to install it in
      <filename class="directory">/opt</filename>, instead of
      <filename class="directory">/usr</filename>. Depending on your choice,
      replace <replaceable>&lt;PREFIX&gt;</replaceable> by
      <filename class="directory">/usr</filename> or by
      <filename class="directory">/opt/libreoffice-&libreoffice-dlversion;</filename>:
    </para>

<screen><userinput>export LO_PREFIX=<replaceable>&lt;PREFIX&gt;</replaceable></userinput></screen>
<!-- keep a commented instruction if no patches are currently required -->
    <para> <!-- for all recent versions -->
     Fix build failures introduced by recent versions of <xref linkend="poppler"/>:
    </para>

<screen><userinput>patch -Np1 -i ../libreoffice-&libreoffice-dlversion;-poppler70-1.patch</userinput></screen>

    <para> <!-- for 0.71.0, not tested on earlier versions -->
     Similarly, fix build failures introduced with <xref linkend="poppler"/>:
    </para>

<screen><userinput>patch -Np1 -i ../libreoffice-&libreoffice-dlversion;-poppler71-1.patch</userinput></screen>

    <para>
      Locales "fr" and "en-GB", you will find below, are just examples; you
      should change them to suit your needs - you might want to read the
      "Command Explanations", further below, before proceeding.
    </para>

    <para>
      Prepare <application>LibreOffice</application> for compilation by running
      the following commands:
    </para>

<screen><userinput>sed -e "/gzip -f/d"   \
    -e "s|.1.gz|.1|g" \
    -i bin/distro-install-desktop-integration &amp;&amp;

sed -e "/distro-install-file-lists/d" -i Makefile.in &amp;&amp;

./autogen.sh --prefix=$LO_PREFIX         \
             --sysconfdir=/etc           \
             --with-vendor=BLFS          \
             --with-lang='fr en-GB'      \
             --with-help                 \
             --with-myspell-dicts        \
             --with-alloc=system         \
             --without-junit             \
             --without-system-dicts      \
             --disable-dconf             \
             --disable-odk               \
             --enable-release-build=yes  \
             --enable-python=system      \
             --with-system-apr           \
             --with-system-boost         \
             --with-system-cairo         \
             --with-system-clucene       \
             --with-system-curl          \
             --with-system-expat         \
             --with-system-graphite      \
             --with-system-harfbuzz      \
             --with-system-icu           \
             --with-system-jpeg          \
             --with-system-lcms2         \
             --with-system-libatomic_ops \
             --with-system-libpng        \
             --with-system-libxml        \
             --with-system-neon          \
             --with-system-nss           \
             --with-system-odbc          \
             --with-system-openldap      \
             --with-system-openssl       \
             --with-system-poppler       \
             --with-system-postgresql    \
             --with-system-redland       \
             --with-system-serf          \
             --with-system-zlib</userinput></screen>

    <para>
      The instructions below will only build the package without running
      any unit tests. If you prefer to run the unit tests, replace
      <command>make build-nocheck</command> with <command>make build</command>
      or (as a regular user only) just <command>make</command>, but do not be
      surprised if a unit test fails right at the end of the build and
      breaks it.
    </para>

    <para>
      Build the package:
    </para>

<screen><userinput>CPPFLAGS='-DU_USING_ICU_NAMESPACE=1' make build-nocheck</userinput></screen>

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

<screen role="root"><userinput>make distro-pack-install</userinput></screen>

    <para>
       If installed in <filename
       class="directory">/opt/libreoffice-&libreoffice-dlversion;</filename>
       some additional steps are necessary. Issue the following commands, as
       <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>if [ "$LO_PREFIX" != "/usr" ]; then

  # This symlink is necessary for the desktop menu entries
  ln -svf $LO_PREFIX/lib/libreoffice/program/soffice /usr/bin/libreoffice &amp;&amp;

  # Set up a generic location independent of version number
  ln -sfv $LO_PREFIX /opt/libreoffice 

  # Icons
  mkdir -vp /usr/share/pixmaps
  for i in $LO_PREFIX/share/icons/hicolor/32x32/apps/*; do
    ln -svf $i /usr/share/pixmaps
  done &amp;&amp;

  # Desktop menu entries
  for i in $LO_PREFIX/lib/libreoffice/share/xdg/*; do
    ln -svf $i /usr/share/applications/libreoffice-$(basename $i)
  done &amp;&amp;

  # Man pages
  for i in $LO_PREFIX/share/man/man1/*; do
    ln -svf $i /usr/share/man/man1/
  done

  unset i
fi</userinput></screen>

    <para>
      If you have installed <xref linkend="desktop-file-utils"/>, and you wish
      to update the MIME database, issue, as the <systemitem class="username">
      root</systemitem> user:
    </para>

<screen role="root"><userinput>update-desktop-database</userinput></screen>

    <para>
      The suite and main modules can be started from the menu. From a terminal,
      the suite can be started with <command>libreoffice</command> command and
      the modules with <command>libreoffice
      --<replaceable>&lt;module&gt;</replaceable></command> command,
      respectively, where <replaceable>&lt;module&gt;</replaceable> is one of
      base, calc, draw, impress, math or writer. Modules cannot be started using
      their shell starting script names (see "Installed Programs", below), if
      LO_PREFIX is other than <filename class='directory'>/usr</filename>,
      unless <filename class='directory'>$LO_PREFIX/bin</filename> directory is
      appended to the PATH.
    </para>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <command>sed -e ...</command>: The first sed prevents compression of the
      manual pages and the second one prevents the install from failing.
    </para>

    <para>
      <parameter>--with-vendor=BLFS</parameter>: This switch sets BLFS as
      the vendor which is mentioned when you click "About" from the Help menu
      on the toolbar.
    </para>

    <para>
      <parameter>--with-lang='fr en-GB'</parameter>: This switch sets
      what languages to support. To list several languages, separate them with
      a space. For all languages, use
      <parameter>--with-lang=ALL</parameter>.
    </para>

    <note>
      <para>
        For a list of the available languages, look in
        <filename>solenv/inc/langlist.mk</filename>.
      </para>
    </note>

    <para>
      <parameter>--with-help</parameter>: Without this switch, the help files
      are not built.
    </para>

    <para>
      <parameter>--with-myspell-dicts</parameter>: This switch adds myspell
      dictionaries to the <application>LibreOffice</application> installation
      set.
    </para>

    <para>
      <parameter>--with-alloc=system</parameter>: This switch tells
      <application>LibreOffice</application> to use the system allocator
      instead of its internal one.
    </para>

    <para>
      <parameter>--with-system-boost</parameter>: This switch enables using
      system boost. From time to time, recent versions of boost break
      the build of libreoffice. In this case, it is possible to use the
      bundled copy of boost, by removing this flag.
    </para>

    <para>
      <parameter>--disable-dconf</parameter>: This switch disables compiling
      <application>LibreOffice</application> with the
      <application>GNOME DConf</application> configuration system support.
    </para>

    <para>
      <parameter>--without-junit</parameter>: This switch disables the tests
      for the deprecated HSQLDB driver which is written in Java. If you wish
      to build this driver replace this switch with the set of switches
      described below under '--with-java'.
    </para>

    <para>
      <parameter>--without-system-dicts</parameter>: This switch disables use
      of  dictionaries from system paths, so the ones installed by this package
      are used.
    </para>

    <para>
      <parameter>--disable-odk</parameter>: This switch disables installing the
      office development kit. Remove if you want to develop a
      <application>LibreOffice</application> based application.
    </para>

    <para>
      <parameter>--enable-release-build=yes</parameter>: This switch enables a
      Release Build.  <application>LibreOffice</application> can be built as a
      Release Build or as a Developer Build, because their default installation
      paths and user profile paths are different. Developer Build displays the
      words "Dev" and "Beta" in several places (e.g, menu and splash screen).
    </para>

    <para>
      <parameter>--enable-python=system</parameter>: This switch tells
      <application>LibreOffice</application> to use installed
      <application>Python 3</application> to build the translations instead of
      the bundled one.
    </para>

    <para>
      <parameter>--with-system-*</parameter>: These switches prevent
      <application>LibreOffice</application> from trying to compile its own
      versions of these dependencies. If you've not installed some of the
      dependencies, remove the corresponding switches.
    </para>

    <para>
      <command>CPPFLAGS='-DU_USING_ICU_NAMESPACE=1' make ...</command>: <xref
      linkend="icu"/> has removed an implicit namespace <quote>using</quote>
      from its headers files. Setting <envar>U_USING_ICU_NAMESPACE</envar> to
      1 allows to restore the former behavior, which is required for building
      <application>libreoffice</application>.
    </para>

    <para>
      <option>--with-parallelism=&lt;count&gt;</option>: This switch
      tells <application>LibreOffice</application> to use &lt;count&gt; CPU
      cores to compile in parallel.  (Do not include literal angle brackets.)
      The default is to use all available cores on the system.
    </para>

    <para>
      <option>--disable-cups</option>: Use this switch if you don't need
      printing support.
    </para>

    <para>
      <option>--disable-dbus</option>: Use this switch if you've not installed
      D-Bus-1.8.0 or later. It also disables Bluetooth support and font install
      via PackageKit.
    </para>

    <para>
      <option>--disable-firebird-sdbc</option>: By default, the ability to
      connect to a <application>firebird</application> database is enabled.
      Add this switch if you do not need that feature.
    </para>

    <para>
      <option>--disable-gstreamer-1-0</option>: Use this switch if you have not
      installed <xref linkend="gst10-plugins-base"/>.
    </para>

    <para>
      <option>--disable-gtk3</option>: Use this switch if you have not installed
      <application>GTK+-3</application>, or if you have installed it but wish
      to use <application>GTK+-2</application> (the menu icons differ).
      Note that a <application>GTK+-3</application> build still
      requires <application>GTK+-2</application> to build the gtk-plugin.
    </para>

    <para>
      <option>--disable-postgresql-sdbc</option>: This switch disables compiling
      <application>LibreOffice</application> with the ability to connect to a
      <application>PostgreSQL</application> database. Use it if you have not
      installed <application>PostgreSQL</application> and you do not want
      <application>LibreOffice</application> to compile its bundled copy.
    </para>

    <para>
      <option>--with-java</option>: This switch enables
      <application>Java</application> support in
      <application>LibreOffice</application>. Java is needed for the
      deprecated HSQLDB driver, which allows reading databases created by
      other programs or in earlier versions of libreoffice
      <application>base</application>. You may also need to add:
      <option>--with-junit=/opt/ant/lib/junit-&junit-version;.jar</option>
      <option>--with-jdk-home=/opt/jdk</option>
      <option>--with-hamcrest=/opt/ant/lib/hamcrest-core-&hamcrest-version;.jar</option>
    </para>

    <para>
      <option>--without-fonts</option>: <application>LibreOffice</application>
      includes a number of third-party TrueType fonts. If you have already
      installed some or all of the same fonts, you may prefer to use the system
      versions.
    </para>

    <para>
      <parameter>make distro-pack-install</parameter>: this does a normal
      install, but if you add a DESTDIR environment variable it will also
      install a lot of (text) gid_Module_* files in the DESTDIR, to help
      distributions which want to break the package into parts.
    </para>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directory</segtitle>

      <seglistitem>
        <seg>
          libreoffice, lobase, localc, lodraw, loffice, lofromtemplate,
          loimpress, lomath, loweb, lowriter, soffice and unopkg;
          several programs under
          $LO_PREFIX/lib/libreoffice/program
        </seg>
        <seg>
          several libraries under
          $LO_PREFIX/lib/libreoffice/program
        </seg>
        <seg>
          $LO_PREFIX/lib/libreoffice
        </seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="libreoffice-suite">
        <term><command>libreoffice (or soffice)</command></term>
        <listitem>
          <para>
            is the main libreofice suite (symlink to
            $LO_PREFIX/lib/libreoffice/program/soffice).
          </para>
          <indexterm zone="libreoffice libreoffice-suite">
            <primary sortas="b-libreoffice-suite">libreoffice-suite</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lobase">
        <term><command>lobase</command></term>
        <listitem>
          <para>
            is the database manager module shell starting script.
          </para>
          <indexterm zone="libreoffice lobase">
            <primary sortas="b-lobase">lobase</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="localc">
        <term><command>localc</command></term>
        <listitem>
          <para>
            is the spreadsheet module shell starting script.
          </para>
          <indexterm zone="libreoffice localc">
            <primary sortas="b-localc">localc</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lodraw">
        <term><command>lodraw</command></term>
        <listitem>
          <para>
            is the vector graphics editor and diagramming tool module shell
            starting script.
          </para>
          <indexterm zone="libreoffice lodraw">
            <primary sortas="b-lodraw">lodraw</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="loimpress">
        <term><command>loimpress</command></term>
        <listitem>
          <para>
            is the (PowerPoint) presentations editor and displayer
            module shell starting script.
          </para>
          <indexterm zone="libreoffice loimpress">
            <primary sortas="b-loimpress">loimpress</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lomath">
        <term><command>lomath</command></term>
        <listitem>
          <para>
            is the mathematical formula editor module shell starting script.
          </para>
          <indexterm zone="libreoffice lomath">
            <primary sortas="b-lomath">lomath</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="loweb">
        <term><command>loweb</command></term>
        <listitem>
          <para>
            is the HTML editor module shell starting script.
          </para>
          <indexterm zone="libreoffice loweb">
            <primary sortas="b-loweb">loweb</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lowriter">
        <term><command>lowriter</command></term>
        <listitem>
          <para>
            is the word processor module shell starting script.
          </para>
          <indexterm zone="libreoffice lowriter">
            <primary sortas="b-lowriter">lowriter</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="unopkg">
        <term><command>unopkg</command></term>
        <listitem>
          <para>
            is a tool to manage <application>LibreOffice</application>
            extensions from the command line.
          </para>
          <indexterm zone="libreoffice unopkg">
            <primary sortas="b-unopkg">unopkg</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>