source: xsoft/office/libreoffice.xml@ d613641

<?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        "93ffa098e65dde29516ffe7212092f29">
  <!ENTITY libreoffice-core-size          "222 MB">

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

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

  <!ENTITY libreoffice-translations-download-http "&libreoffice-dl;/libreoffice-translations-&libreoffice-dlversion;.tar.xz">
  <!ENTITY libreoffice-translations-md5sum        "9aaecb32945a04ebc8a89835536105f9">
  <!ENTITY libreoffice-translations-size          "164 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.5 GB (782 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 
       for 6.1.4.2 I just used the total time - bdubbs
  -->
  <!ENTITY libreoffice-time "59 SBU with parallelism=4 including typical 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>

    &lfs90_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:
For libreoffice 6.2.0.4, almost blfs 8.4: no patch needed, only a sed below
      <listitem>
        <para>
          Required patch to fix building with system <xref linkend="poppler"/> (all
          recent versions) and <xref linkend="boost"/>:
          <ulink url="&patch-root;/libreoffice-&libreoffice-dlversion;-consolidated_fixes-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="glm"/>,
      <xref linkend="glu"/>,
      <xref linkend="gpgme"/>,
      <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="lxml"/>,
      <xref linkend="mesa"/>,
      <xref linkend="neon"/>,
      <xref linkend="nss"/>,
      <xref linkend="openldap"/> (if connecting to an LDAP server),
      <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="evolution-data-server"/>,
      <xref linkend="gdb"/>,
      <xref linkend="gnutls"/>,
<!-- not anymore in the book, but included in apache-ant
     <xref linkend="junit"/>, -->
      <xref linkend="kf5-frameworks"/>,
      <xref linkend="libpaper"/>,
      <xref linkend="mariadb"/> or <ulink url="http://www.mysql.com/">MySQL</ulink>,
      <xref linkend="mitkrb"/>,
      <xref linkend="nasm"/>,
      <xref linkend="poppler"/> (currently broken), 
      <xref linkend="sane"/>,
      <xref linkend="telepathy-glib"/>,
      <xref linkend="valgrind"/>,
      <xref linkend="vlc"/>,
      <xref linkend="zenity"/>,
      <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="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="https://github.com/KhronosGroup/OpenCOLLADA/">OpenCOLLADA</ulink>,
      <ulink url="https://gitlab.com/orcus/orcus">Orcus</ulink>, and
      <ulink url="https://ukoethe.github.io/vigra/">VIGRA</ulink>
    </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 role="nodump"><userinput>tar -xf libreoffice-&libreoffice-dlversion;.tar.xz --no-overwrite-dir &amp;&amp;
cd libreoffice-&libreoffice-dlversion;</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"/>
     and <xref linkend="boost"/>:
    </para>

<screen><userinput>patch -Np1 -i ../libreoffice-&libreoffice-dlversion;-consolidated_fixes-1.patch</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>

    <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;

sed -e '/JAVA_SOURCE_VER/s/6/7/' \
    -e '/JAVA_TARGET_VER/s/6/7/' \
    -i configure.ac

<!-- Removed in 6.2             - -with-alloc=system
     In 6.3  -disable-gtk -enable-gtk3 added (sic, I accidentally built like
     that) which allows removal of  - -with-system-cairo but did NOT cause
     system epoxy to be automatically used, as configure claimed -->
<!--
     libfreehand-0.1.2 is downloaded (from freedesktop.org) but moving to
     ICU-65.1 has highlighted a missing semicolon in one of the files,
     causing libreoffice to fail to build : command moved to an option with
     explanation until a newer version of libfreehand is pulled in.
             \-\-with-system-icu           \
-->
./autogen.sh --prefix=$LO_PREFIX         \
             --sysconfdir=/etc           \
             --with-vendor=BLFS          \
             --with-lang='fr en-GB'      \
             --with-help                 \
             --with-myspell-dicts        \
             --without-junit             \
             --without-system-dicts      \
             --disable-dconf             \
             -disable-gtk -enable-gtk3   \
             --disable-odk               \
             --enable-release-build=yes  \
             --enable-python=system      \
             --with-jdk-home=/opt/jdk    \
             --with-system-apr           \
             --with-system-boost         \
             --with-system-clucene       \
             --with-system-curl          \
             --with-system-epoxy         \
             --with-system-expat         \
             --with-system-glm           \
             --with-system-gpgmepp       \
             --with-system-graphite      \
             --with-system-harfbuzz      \
             --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-postgresql    \
             --with-system-redland       \
             --with-system-serf          \
             --with-system-zlib</userinput></screen>

<!--             - -with-system-poppler       \ -->
    <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>make build-nocheck</userinput></screen>
<!--<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 libreoffice-&libreoffice-dlversion; /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, the second one prevents the install from failing, and the
      the third allows to build with OpenJDK-12.
    </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-jdk-home=/opt/jdk</parameter>: This parameter will silence
      a warning that the configure script attempted to find JAVA_HOME
      automatically (even though that is passed in the environment). Omit this if
      you disabled java.
    </para>

    <para>
      <parameter>--with-myspell-dicts</parameter>: This switch adds myspell
      dictionaries to the <application>LibreOffice</application> installation
      set.
    </para>
    <!-- Unrecognized as of 6.2.0.3
    <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>-disable-gtk -enable-gtk3</parameter>: This pair of switches
      tell the configure script to use <application>GTK+-3</application> instead
      of <application>GTK+-2</application>.
    </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 after '--without-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>
      <command>make distro-pack-install</command>: 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>

    <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>--enable-lto</option>: This switch will enable Link Time
      Optimization, which results in slightly smaller libraries (about 40 MB).
      This is said to make <application>LibreOffice</application> programs
      load faster (and possibly run faster, e.g. when recalculating a
      spreadsheet). On an 8-core machine with 16GB of memory, the difference
      in compile times was minimal, but an extra 2GB was used for the work
      files. On machines with fewer processors or a lack of memory, the compile
      might be much slower.
    </para>

    <para>
      <option>--without-java</option>: This switch disables
      <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>.
    </para>

    <para>
      <option>--with-junit=/opt/ant/lib/junit-4.12.jar</option> and
      <option>--with-hamcrest=/opt/ant/lib/hamcrest-core-1.3.jar</option>:
      Those options are needed if you want to run the tests.
    </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>
      <!-- Brings in - -enable-qt5 as well. -->
      <option>--enable-kde5</option>: Builds with KDE/Plasma integration. If
      <xref linkend="qt5"/> and/or <xref linkend="kf5-frameworks"/> are not
      installed in <filename class="directory">/usr</filename>, the include
      and library directories must be specified in <envar>QT5INC</envar>,
      <envar>QT5LIB</envar>, <envar>KF5INC</envar>, and <envar>KF5LIB</envar>,
      respectively.
    </para>
    
    <para revision="systemd">
      <option>--enable-evolution2</option>: Enables support for Evolution
      address books through Evolution Data Server. Note that Evolution Data
      Server must be installed for this feature to function.
    </para>

    <para>
      <option>--with-system-icu</option>: This command would use the system
      version of <xref linkend="icu"/> which is normally considered to be a good
      thing to do. However, one of the very minor packages pulled in by
      <application>LibreOffice</application>, libfreehand-0.1.2, does not compile
      with ICU-65.1 because of a missing semi-colon at the end of one line in one
      of its files. Do not use this option unless you have separately installed a
      patched or newer version of
      <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libfreehand">libfreehand</ulink>.
    </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>