glfs/xsoft/office/libreoffice.xml
Pierre Labastie 8097885f44 libreoffice: don't hardcode the symlink
Presently, we do "ln -s libreoffice-<version> /opt/libreoffice"
but we use $LO_PREFIX everywhere else. So if $LO_PREFIX is not
equal to libreoffice-<version>, the symlink is broken. Use
"ln -s $LO_PREFIX /opt/libreoffice instead".
2023-12-30 20:14:39 +01:00

955 lines
36 KiB
XML

<?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 "https://download.documentfoundation.org/libreoffice/src/&libreoffice-version;">
<!ENTITY libreoffice-core-download-http "&libreoffice-dl;/libreoffice-&libreoffice-dlversion;.tar.xz">
<!ENTITY libreoffice-core-md5sum "51cb8339342bf6d95b07c72b6106cb00">
<!ENTITY libreoffice-core-size "269 MB">
<!ENTITY libreoffice-dict-download-http "&libreoffice-dl;/libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz">
<!ENTITY libreoffice-dict-md5sum "d0cd4106c2563797ba1e1dfde16ca9ed">
<!ENTITY libreoffice-dict-size "51 MB">
<!ENTITY libreoffice-help-download-http "&libreoffice-dl;/libreoffice-help-&libreoffice-dlversion;.tar.xz">
<!ENTITY libreoffice-help-md5sum "894da18320e5cdfc262e3bef4da2c0ce">
<!ENTITY libreoffice-help-size "160 MB">
<!ENTITY libreoffice-translations-download-http "&libreoffice-dl;/libreoffice-translations-&libreoffice-dlversion;.tar.xz">
<!ENTITY libreoffice-translations-md5sum "74613c314685d6a8ec85d55ed8e69179">
<!ENTITY libreoffice-translations-size "207 MB">
<!-- full size remeasured for 7.0.0.3 -->
<!ENTITY libreoffice-buildsize "10 GB including the additional files if downloaded during the build (725 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
Not a problem with 7.1.7.2 and poppler-21.05.0. - bdubbs
A problem with 7.3.1.3 and poppler-21.05.0, Arch had a patch. - bdubbs
-->
<!-- 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
For 7.2.5.2, It was 58 SBU including DL time.
For 7.5.4.2, I increased the parallelism to 8. -bdubbs
-->
<!ENTITY libreoffice-time "25 SBU with parallelism=8 (will vary due to download time)">
]>
<sect1 id="libreoffice" xreflabel="LibreOffice-&libreoffice-dlversion;">
<?dbhtml filename="libreoffice.html"?>
<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>
&lfs120_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. The download time will vary with the local internet speed and
server load. The download time is about 3 minutes on a fiber connection
and probably not much more than 10 minutes on an ADSL connection.
If you have not installed one or more of the following dependencies,
they 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 <xref linkend="poppler"/>:
<ulink url="&patch-root;/libreoffice-&libreoffice-dlversion;-poppler_22_09_fixes-1.patch"/>
</para>
</listitem>
-->
<listitem>
<para>
Required patch to fix building with libxml2-2.12.x:
<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>
&build-use-internet;
<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="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="harfbuzz"/>,
<xref linkend="icu"/>,
<xref linkend="libatomic_ops"/>,
<xref linkend="lcms2"/>,
<xref linkend="librsvg"/>,
<xref linkend="libtiff"/>,
<xref linkend="libwebp"/>,
<xref linkend="libxml2"/> and
<xref linkend="libxslt"/>,
<xref linkend="lxml"/>,
<xref linkend="mesa"/>,
<xref linkend="nss"/>,
<xref linkend="openldap"/> (if connecting to an LDAP server),
<xref linkend="poppler"/>,
<xref linkend="postgresql"/>,
<xref linkend="redland"/>, 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"/>,
<xref linkend="kf5-frameworks"/>,
<xref linkend="libpaper"/>,
<xref linkend="mariadb"/> or <ulink url="https://www.mysql.com/">MySQL</ulink>,
<xref linkend="mitkrb"/>,
<xref linkend="nasm"/>,
&qt5-deps;,
<xref linkend="qt6"/>,
<xref linkend="sane"/>,
<xref linkend="telepathy-glib"/>,
<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/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='https://freedesktop.org/wiki/Software/cppunit/'>Cppunit</ulink>
<ulink url="https://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="https://sourceforge.net/projects/hunspell/files/Hyphen/">Hyphen</ulink>,
<ulink url="https://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="https://sourceforge.net/projects/libcmis/">libcmis</ulink>,
<ulink url="https://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="https://tagoh.github.io/liblangtag/">liblangtag</ulink>,
<ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libmspub">libmspub</ulink>,
<ulink url="https://sourceforge.net/projects/libmwaw/">libmwaw</ulink>,
<ulink url="https://github.com/Numbertext/libnumbertext">libnumbertext</ulink>,
<ulink url="https://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="https://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="https://libwpd.sourceforge.net/">libwpd</ulink>,
<ulink url="https://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="https://lpsolve.sourceforge.net/">lp_solve</ulink>,
<ulink url="https://gitlab.com/mdds/mdds">mdds</ulink>,
<ulink url="https://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 the <filename>download.lst</filename> file in the sources
directory.
</para>
<para condition="html" role="usernotes">
Editor Notes: <ulink url="&blfs-wiki;/libreoffice"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of LibreOffice</title>
<!-- since there is no "." in the "tar -t" listing, I cannot see
how no-overwrite-dir would be needed...
<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>
First, fix build failures introduced by the latest poppler version:
</para>
<screen><userinput>patch -Np1 -i ../libreoffice-&libreoffice-dlversion;-poppler_22_09_fixes-1.patch</userinput></screen>
-->
<para>
First, fix build failures caused by libxml2-2.12.x:
</para>
<screen><userinput remap="pre">patch -Np1 -i ../libreoffice-&libreoffice-dlversion;-consolidated_fixes-1.patch</userinput></screen>
<para>
Next, fix a build failure with ICU-74+:
</para>
<screen><userinput>sed -e /LBCM/d -i i18npool/source/breakiterator/data/line.txt</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>
<para>
The instructions in the package unpack some tarballs into a location
it cannot find later. Create some symlinks to help the build system out:
</para>
<screen><userinput>ln -sv src/libreoffice-help-&libreoffice-dlversion;/helpcontent2/ &amp;&amp;
ln -sv src/libreoffice-dictionaries-&libreoffice-dlversion;/dictionaries/ &amp;&amp;
ln -sv src/libreoffice-translations-&libreoffice-dlversion;/translations/</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>
If you are building on a 32 bit machine, <envar>CFLAGS</envar> is set to
<command>-Os</command>, which breaks the build. Prevent this
by issuing:
</para>
<screen><userinput>case $(uname -m) in
i?86) sed /-Os/d -i solenv/gbuild/platform/LINUX_INTEL_GCC.mk ;;
esac</userinput></screen>
<para>
Prepare <application>LibreOffice</application> for compilation by running
the following commands:
</para>
<!--Editors: if it happens you need to remove some "with-system-xxx"
instruction because libreoffice temporarily cannot use the current
system version, please keep it around commented out, so that it can be
remembered to test it with higher versions of libreoffice. -->
<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-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-nss \
--with-system-odbc \
--with-system-openldap \
--with-system-openssl \
--with-system-poppler \
--with-system-postgresql \
--with-system-redland \
--with-system-libtiff \
--with-system-libwebp \
--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</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 $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 the <command>libreoffice</command> command
and the modules with the <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.
</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
<option>--with-lang=ALL</option>. 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>
<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>
<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>. It is also needed for some optional
user interface components.
</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
&qt5-deps; 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>
<option>--enable-qt5</option>: This switch enables support for integration
with Qt5 and the Qt5 theming engine. If &qt5-deps; is not installed in
<filename class="directory">/usr</filename>, the include and library
directories must be specified in the <envar>QT5INC</envar> and
<envar>QT5LIB</envar> environment variables.
</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>