source: xsoft/office/libreoffice.xml@ 9039d65

<?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        "db37d6e5f09d47df297e145ca2e04386">
  <!ENTITY libreoffice-core-size          "233 MB">

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

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

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

  <!-- full size remeasured for 7.0.0.3 -->

  <!ENTITY libreoffice-buildsize  "9.3 GB including the additional files if downloaded during the build (841 MB installed). Installing the whole set of languages requires more than 25 GB (around 3 GB installed)">

 <!-- Editors: many updates to poppler will break LO using system poppler until
      somebody is able to provide a patch or sed.  In these cases, please mark
      the dependency as currently broken and move the \-\-with-system-poppler
      line to a comment. Also please switch poppler between recommended and
      optional according to whether or not we use the system version.  The
      installed size will be increased by 2 MB if using the shipped poppler, but
      the variation in build times will be lost in the noise. - ken -->

  <!-- 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 and 7.0.0.3 just used the total time - bdubbs

       For 6.4.0.3 downloading everything including dictionaries,
       help, translations took less than 2 minutes (1.1 SBU) with
       a good domestic internet connection.  Total time was 60 SBU - ken

       60 SBU not including download of translations, help and dictionary
       for 6.4.6.2 - pierre

       56 SBU for 7.0.3.1 not including download of translations, help, and
       dictionaries. -renodr
  -->
  <!ENTITY libreoffice-time "54 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>

    &lfs101_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>

    <note>
      <para>
        Around 80 smallish tarballs and zip files will be downloaded during the
        build. If you have not downloaded one or more of the following, they too
        will also be downloaded during the build.
      </para>
    </note>

    <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 GCC 10 and later:
          <ulink url="&patch-root;/libreoffice-&libreoffice-dlversion;-format_overflow-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="libepoxy"/>,
      <xref linkend="libjpeg"/>,
      <xref linkend="llvm"/> (clang is preferred for rendering with skia),
      <xref linkend="glm"/>,
      <xref linkend="glu"/>,
      <xref linkend="gpgme"/>,
      <xref linkend="graphite2"/>,
      <xref linkend="gst10-plugins-base"/>,
      <xref linkend="gtk3"/>,
 <!-- <xref linkend="gtk2"/>  -->
      <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="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="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="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/httpcomponents-client-ga/index.html">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="https://beanshell.github.io/">BeanShell</ulink>,
      <ulink url="https://box2d.org/documentation/">box2d</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="&gnome-download-http;/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://github.com/junit-team/junit4/releases">junit4</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://sourceforge.net/projects/libepubgen/">libepubgen</ulink>,
      <ulink url="https://wiki.documentfoundation.org/DLP/libraries/libetonyek">libetonyek</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.github.io/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="https://github.com/Numbertext/libnumbertext">libnumbertext</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="https://github.com/nayuki/QR-Code-generator">libqrcodegen</ulink>,
      <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libqxp">libqxp</ulink>,
      <ulink url="http://sourceforge.net/projects/libwpd/files/librevenge/">librevenge (WordPerfect Document importer)</ulink>,
      <ulink url="https://github.com/fosnola/libstaroffice/wiki">libstaroffice</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="https://sourceforge.net/p/libwps/wiki/Home/">libwps</ulink>,
      <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libzmf">libzmf</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://odftoolkit.org/conformance/ODFValidator.html">odfvalidator</ulink>,
      <ulink url="https://code.google.com/archive/p/officeotron/">officeotron</ulink>,
      <ulink url="https://github.com/KhronosGroup/OpenCOLLADA/">OpenCOLLADA</ulink>,
      <ulink url="https://gitlab.com/orcus/orcus">Orcus</ulink>,
      <ulink url="https://sourceware.org/systemtap/">SystemTap</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>
     Fix build failures introduced by GCC 10 and later:
    </para>

<screen><userinput>patch -Np1 -i ../libreoffice-&libreoffice-dlversion;-format_overflow-1.patch</userinput></screen>
-->
    <para>
      If you have downloaded the dictionaries, help and translations tarballs,
      create symlinks to them 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/ &amp;&amp;
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>

    <note>
      <para>
        If you set the ACLOCAL environment variable to support installing 
        Xorg in /opt, you will need to unset it for this package.
      </para>
    </note>

    <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        \
             --without-junit             \
             --without-system-dicts      \
             --disable-dconf             \
             --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-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>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 the
       <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, web, 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 the <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.
      <!--and the third one allows the build to use poppler-0.86.1 and later.-->
      <!-- FIXME update hardcoded poppler version in text when necessary -->
      <!-- FIXME as far as I can tell, that sed is no longer present, so I
           commented the description out here. -renodr -->
    </para>

<!--
    <para>
      <command>sed -i "s/TRUE/true/" ...</command>: These three sed commands
      fix breakage caused by <application>ICU-68.1</application> removing a
      macro. The third sed is for a file within libreoffice, the first two
      are for packages downloaded during the build and amend '.mk' files for
      the external projects (the source tarballs are unpacked during the build).
    </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>. Note that the translations file
      is not needed and won't be downloaded if using only en_US as a language.
    </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>--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 the 
      use of dictionaries from system paths so that 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 the system installed
      <application>Python 3</application> 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>

<!-- only gtk3 is referenced in the configure script for 6.4.0.3
    <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>--disable-skia</option>: Use <xref linkend="cairo"/> for rendering
      instead of skia.
    </para>

    <para>
      <option>--enable-gtk3-kde5</option>: This switch allows the Visual Class
      Library, which is responsible for widgets, to be built with KF5 file
      dialogs if GTK+-3, Qt5 and Plasma are all available.
    </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>
    <!-- junit is not included anymore in ant, and neither hamcrest. Since
    the hsqldb backend is deprecated anyway, forget this:
    <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-kf5</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>
      <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>
      Currently broken by ICU68 (TRUE and FALSE need to be true and false) on
      libe-book and perhaps elsewhere - commented explanation retained.  ken
      <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>