source: xsoft/office/libreoffice.xml@ b2651a58

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since b2651a58 was b2651a58, checked in by Bruce Dubbs <bdubbs@…>, 18 months ago

Update to boost_1_81_0.

This package builds without issue, but 20 out of 167 tests fail when
python-3.11 is used. If python-3.10 is used, all tests pass. If
python is a symlink to python2 and the tests are run with that, all
tests pass.

  • Property mode set to 100644
File size: 36.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY libreoffice-dl "https://download.documentfoundation.org/libreoffice/src/&libreoffice-version;">
8
9 <!ENTITY libreoffice-core-download-http "&libreoffice-dl;/libreoffice-&libreoffice-dlversion;.tar.xz">
10 <!ENTITY libreoffice-core-md5sum "85dd5f6035e69074176bcd1ff3b53360">
11 <!ENTITY libreoffice-core-size "252 MB">
12
13 <!ENTITY libreoffice-dict-download-http "&libreoffice-dl;/libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz">
14 <!ENTITY libreoffice-dict-md5sum "185e65812a77b726d0b2ee0d8fb5bd90">
15 <!ENTITY libreoffice-dict-size "49 MB">
16
17 <!ENTITY libreoffice-help-download-http "&libreoffice-dl;/libreoffice-help-&libreoffice-dlversion;.tar.xz">
18 <!ENTITY libreoffice-help-md5sum "05bb0ea0f472fa7d67e44c6b7bdb6146">
19 <!ENTITY libreoffice-help-size "107 MB">
20
21 <!ENTITY libreoffice-translations-download-http "&libreoffice-dl;/libreoffice-translations-&libreoffice-dlversion;.tar.xz">
22 <!ENTITY libreoffice-translations-md5sum "66c3d9078b5c3163b1a780cb4b28517f">
23 <!ENTITY libreoffice-translations-size "190 MB">
24
25 <!-- full size remeasured for 7.0.0.3 -->
26
27 <!ENTITY libreoffice-buildsize "9.5 GB including the additional files if downloaded during the build (748 MB installed). Installing the whole set of languages requires more than 25 GB (around 3 GB installed)">
28
29 <!-- Editors: many updates to poppler will break LO using system poppler until
30 somebody is able to provide a patch or sed. In these cases, please mark
31 the dependency as currently broken and move the \-\-with-system-poppler
32 line to a comment. Also please switch poppler between recommended and
33 optional according to whether or not we use the system version. The
34 installed size will be increased by 2 MB if using the shipped poppler, but
35 the variation in build times will be lost in the noise. - ken
36
37 Not a problem with 7.1.7.2 and poppler-21.05.0. - bdubbs
38 A problem with 7.3.1.3 and poppler-21.05.0, Arch had a patch. - bdubbs
39
40 -->
41
42 <!-- for 6.1.2.1 I allowed 2 SBU for downloads, my total was
43 64.76 SBU with fast downloads
44 for 6.1.4.2 I and 7.0.0.3 just used the total time - bdubbs
45
46 For 6.4.0.3 downloading everything including dictionaries,
47 help, translations took less than 2 minutes (1.1 SBU) with
48 a good domestic internet connection. Total time was 60 SBU - ken
49
50 60 SBU not including download of translations, help and dictionary
51 for 6.4.6.2 - pierre
52
53 56 SBU for 7.0.3.1 not including download of translations, help, and
54 dictionaries. -renodr
55
56 For 7.2.5.2, It was 58 SBU including DL time.
57
58 -->
59 <!ENTITY libreoffice-time "45 SBU with parallelism=4 (will vary due to download time)">
60
61]>
62
63<sect1 id="libreoffice" xreflabel="LibreOffice-&libreoffice-dlversion;">
64 <?dbhtml filename="libreoffice.html"?>
65
66
67 <title>LibreOffice-&libreoffice-version;</title>
68
69 <indexterm zone="libreoffice">
70 <primary sortas="a-LibreOffice">LibreOffice</primary>
71 </indexterm>
72
73 <sect2 role="package">
74 <title>Introduction to LibreOffice</title>
75
76 <para>
77 <application>LibreOffice</application> is a full-featured office suite.
78 It is largely compatible with <application>Microsoft Office</application>
79 and is descended from <application>OpenOffice.org</application>.
80 </para>
81
82 &lfs112_checked;
83
84 <bridgehead renderas="sect3">Package Information</bridgehead>
85 <itemizedlist spacing="compact">
86 <listitem>
87 <para>
88 Core Download: <ulink url="&libreoffice-core-download-http;"/>
89 </para>
90 </listitem>
91 <listitem>
92 <para>
93 Core Download MD5 sum: &libreoffice-core-md5sum;
94 </para>
95 </listitem>
96 <listitem>
97 <para>
98 Core Download size: &libreoffice-core-size;
99 </para>
100 </listitem>
101 <listitem>
102 <para>
103 Estimated disk space required: &libreoffice-buildsize;
104 </para>
105 </listitem>
106 <listitem>
107 <para>
108 Estimated build time: &libreoffice-time;
109 </para>
110 </listitem>
111 </itemizedlist>
112
113 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
114
115 <note>
116 <para>
117 Around 80 smallish tarballs and zip files will be downloaded during the
118 build. The download time will vary with the local internet speed and
119 server load. The download time is about 3 mn on a fiber connection,
120 probably not much more than 10 mn on an ADSL connection.
121 If you have not downloaded one or more of the following, they too
122 will also be downloaded during the build.
123 </para>
124 </note>
125
126 <itemizedlist spacing="compact">
127 <listitem>
128 <para>
129 Dictionaries: <ulink url="&libreoffice-dict-download-http;"/>
130 </para>
131 </listitem>
132
133 <listitem>
134 <para>
135 Dictionaries MD5 sum: &libreoffice-dict-md5sum;
136 </para>
137 </listitem>
138
139 <listitem>
140 <para>
141 Dictionaries size: &libreoffice-dict-size;
142 </para>
143 </listitem>
144
145 <listitem>
146 <para>
147 Help Files: <ulink url="&libreoffice-help-download-http;"/>
148 </para>
149 </listitem>
150
151 <listitem>
152 <para>
153 Help Files MD5 sum: &libreoffice-help-md5sum;
154 </para>
155 </listitem>
156
157 <listitem>
158 <para>
159 Help Files size: &libreoffice-help-size;
160 </para>
161 </listitem>
162
163 <listitem>
164 <para>
165 Translations: <ulink url="&libreoffice-translations-download-http;"/>
166 </para>
167 </listitem>
168
169 <listitem>
170 <para>
171 Translations MD5 sum: &libreoffice-translations-md5sum;
172 </para>
173 </listitem>
174
175 <listitem>
176 <para>
177 Translations size: &libreoffice-translations-size;
178 </para>
179 </listitem>
180
181<!-- keep one commented patch, it's sure to again need one or more in a few months:-->
182
183<!--
184 <listitem>
185 <para>
186 Required patch to fix building with <xref linkend="poppler"/>:
187 <ulink url="&patch-root;/libreoffice-&libreoffice-dlversion;-poppler_22_09_fixes-1.patch"/>
188 </para>
189 </listitem>
190-->
191 </itemizedlist>
192 <bridgehead renderas="sect3">LibreOffice Dependencies</bridgehead>
193
194 <bridgehead renderas="sect4">Required</bridgehead>
195 <para role="required">
196 <xref linkend="perl-archive-zip"/>,
197 <xref linkend="unzip"/>,
198 <xref linkend="wget"/>,
199 <xref linkend="which"/>, and
200 <xref linkend="zip"/>
201 </para>
202
203 <bridgehead renderas="sect4">Recommended</bridgehead>
204 <note>
205 <para>
206 Most of these packages are recommended because if they're not installed,
207 the build process will compile and install its own (often older)
208 version, with the side effect of increasing build and installed disk
209 space and build time.
210 </para>
211 </note>
212
213 <para role="recommended">
214 <xref linkend="apache-ant"/>,
215<!-- <xref linkend="apr"/>, -->
216 <xref linkend="boost"/> (broken with boost-1.81.0),
217 <xref linkend="clucene"/>,
218 <xref linkend="cups"/>,
219 <xref linkend="curl"/>,
220 <xref linkend="dbus-glib"/>,
221 <xref linkend="libepoxy"/>,
222 <xref linkend="libjpeg"/>,
223 <xref linkend="llvm"/> (clang is preferred for rendering with skia),
224 <xref linkend="glm"/>,
225 <xref linkend="glu"/>,
226 <xref linkend="gpgme"/>,
227 <xref linkend="graphite2"/>,
228 <xref linkend="gst10-plugins-base"/>,
229 <xref linkend="gtk3"/>,
230 <!-- <xref linkend="gtk2"/> -->
231 <xref linkend="harfbuzz"/>,
232 <xref linkend="icu"/>,
233 <xref linkend="libatomic_ops"/>,
234 <xref linkend="lcms2"/>,
235 <xref linkend="librsvg"/>,
236 <xref linkend="libtiff"/>,
237 <xref linkend="libwebp"/>,
238 <xref linkend="libxml2"/> and
239 <xref linkend="libxslt"/>,
240 <xref linkend="lxml"/>,
241 <xref linkend="mesa"/>,
242<!-- <xref linkend="neon"/>, -->
243 <xref linkend="nss"/>,
244 <xref linkend="openldap"/> (if connecting to an LDAP server),
245 <xref linkend="poppler"/>,
246 <xref linkend="postgresql"/>,
247 <xref linkend="redland"/>,
248<!-- <xref linkend="serf"/>, --> and
249 <xref linkend="unixodbc"/>
250 </para>
251
252 <bridgehead renderas="sect4">Optional</bridgehead>
253 <para role="optional">
254 <xref linkend="avahi"/>,
255 <xref linkend="bluez"/>,
256 <xref linkend="dconf"/>,
257 <xref linkend="desktop-file-utils"/>,
258 <xref linkend="doxygen"/> (not relevant if using --disable-odk),
259 <xref linkend="evolution-data-server"/>,
260 <xref linkend="gdb"/>,
261 <xref linkend="gnutls"/>,
262 <xref linkend="kf5-frameworks"/>,
263 <xref linkend="libpaper"/>,
264 <xref linkend="mariadb"/> or <ulink url="http://www.mysql.com/">MySQL</ulink>,
265 <xref linkend="mitkrb"/>,
266 <xref linkend="nasm"/>,
267 <xref linkend="sane"/>,
268 <xref linkend="telepathy-glib"/>,
269 <xref linkend="valgrind"/>,
270 <xref linkend="vlc"/>,
271 <xref linkend="zenity"/>,
272 <ulink url="https://commons.apache.org/proper/commons-codec/">Apache Commons Codec</ulink>,
273 <ulink url="https://hc.apache.org/httpcomponents-client-ga/index.html">Apache Commons HttpClient</ulink>,
274 <ulink url="https://commons.apache.org/proper/commons-lang/">Apache Commons Lang</ulink>,
275 <ulink url="https://commons.apache.org/proper/commons-logging/">Apache Commons Logging</ulink>,
276 <ulink url="https://beanshell.github.io/">BeanShell</ulink>,
277 <ulink url="https://box2d.org/documentation/">box2d</ulink>,
278 <ulink url="https://projects.coin-or.org/CoinMP/">CoinMP</ulink>,
279 <ulink url="https://sourceforge.net/projects/cppunit/">Cppunit</ulink>,
280 <ulink url="http://www.firebirdsql.org/">Firebird</ulink>,
281 <ulink url="https://github.com/behdad/glyphy">glyphy</ulink>,
282 <ulink url="&gnome-download-http;/gnome-vfs/">Gnome VFS</ulink>,
283 <ulink url="https://github.com/hamcrest/JavaHamcrest/releases">hamcrest</ulink>,
284 <ulink url="https://hunspell.github.io/">Hunspell</ulink>,
285 <ulink url="https://sourceforge.net/projects/hunspell/files/Hyphen/">Hyphen</ulink>,
286 <ulink url="http://include-what-you-use.org/">iwyu</ulink>,
287 <ulink url="https://github.com/junit-team/junit4/releases">junit4</ulink>,
288 <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libabw">libabw</ulink>,
289 <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libcdr">libcdr</ulink>,
290 <ulink url="https://sourceforge.net/projects/libcmis/">libcmis</ulink>,
291 <ulink url="http://www.sourceforge.net/projects/libebook/">libebook</ulink>,
292 <ulink url="https://sourceforge.net/projects/libepubgen/">libepubgen</ulink>,
293 <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libetonyek">libetonyek</ulink>,
294 <ulink url="https://wiki.documentfoundation.org/Libexttextcat">libexttextcat</ulink>,
295 <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libfreehand">libfreehand</ulink>,
296 <ulink url="http://tagoh.github.io/liblangtag/">liblangtag</ulink>,
297 <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libmspub">libmspub</ulink>,
298 <ulink url="https://sourceforge.net/projects/libmwaw/">libmwaw</ulink>,
299 <ulink url="https://github.com/Numbertext/libnumbertext">libnumbertext</ulink>,
300 <ulink url="https://sourceforge.net/projects/libwpd/files/libodfgen/">libodfgen</ulink>,
301 <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libpagemaker">libpagemaker</ulink>,
302 <ulink url="https://github.com/nayuki/QR-Code-generator">libqrcodegen</ulink>,
303 <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libqxp">libqxp</ulink>,
304 <ulink url="https://sourceforge.net/projects/libwpd/files/librevenge/">librevenge (WordPerfect Document importer)</ulink>,
305 <ulink url="https://github.com/fosnola/libstaroffice/wiki">libstaroffice</ulink>,
306 <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libvisio">libvisio</ulink>,
307 <ulink url="http://libwpd.sourceforge.net/">libwpd</ulink>,
308 <ulink url="http://libwpg.sourceforge.net/">libwpg</ulink>,
309 <ulink url="https://sourceforge.net/p/libwps/wiki/Home/">libwps</ulink>,
310 <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libzmf">libzmf</ulink>,
311 <ulink url="http://lpsolve.sourceforge.net/">lp_solve</ulink>,
312 <ulink url="https://gitlab.com/mdds/mdds">mdds</ulink>,
313 <ulink url="https://sourceforge.net/projects/hunspell/files/MyThes/">MyThes</ulink>,
314 <ulink url="https://odftoolkit.org/conformance/ODFValidator.html">odfvalidator</ulink>,
315 <ulink url="https://code.google.com/archive/p/officeotron/">officeotron</ulink>,
316 <ulink url="https://github.com/KhronosGroup/OpenCOLLADA/">OpenCOLLADA</ulink>,
317 <ulink url="https://gitlab.com/orcus/orcus">Orcus</ulink>,
318 <ulink url="https://sourceware.org/systemtap/">SystemTap</ulink>, and
319 <ulink url="https://ukoethe.github.io/vigra/">VIGRA</ulink>
320 </para>
321
322 <para>
323 There are many optional dependencies not listed here. They can be
324 found in <quote>download.lst</quote> (source directory).
325 </para>
326
327 <para condition="html" role="usernotes">
328 User Notes: <ulink url="&blfs-wiki;/libreoffice"/>
329 </para>
330 </sect2>
331
332 <sect2 role="installation">
333 <title>Installation of LibreOffice</title>
334
335 <important>
336 <para>
337 Unlike the other packages, we assume that you have not yet unpacked the
338 package. This is because the <option>--no-overwrite-dir</option>
339 switch is needed in case you unpack as the <systemitem
340 class="username">root</systemitem> user.
341 </para>
342 </important>
343
344<screen role="nodump"><userinput>tar -xf libreoffice-&libreoffice-dlversion;.tar.xz --no-overwrite-dir &amp;&amp;
345cd libreoffice-&libreoffice-dlversion;</userinput></screen>
346
347<!-- keep a commented instruction if no patches are currently required -->
348<!--
349 <para>
350 First, fix build failures introduced by the latest poppler version:
351 </para>
352
353<screen><userinput>patch -Np1 -i ../libreoffice-&libreoffice-dlversion;-poppler_22_09_fixes-1.patch</userinput></screen>
354-->
355 <para>
356 If you have downloaded the dictionaries, help and translations tarballs,
357 create symlinks to them from the source directory so they won't get
358 downloaded again:
359 </para>
360
361<screen><userinput>install -dm755 external/tarballs &amp;&amp;
362ln -sv ../../../libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz external/tarballs/ &amp;&amp;
363ln -sv ../../../libreoffice-help-&libreoffice-dlversion;.tar.xz external/tarballs/ &amp;&amp;
364ln -sv ../../../libreoffice-translations-&libreoffice-dlversion;.tar.xz external/tarballs/</userinput></screen>
365
366 <para>
367 The instructions in the package unpack some tarballs into a location
368 it cannot find later. Create some symlinks to help out:
369 </para>
370
371<screen><userinput>ln -sv src/libreoffice-help-&libreoffice-dlversion;/helpcontent2/ &amp;&amp;
372ln -sv src/libreoffice-dictionaries-&libreoffice-dlversion;/dictionaries/ &amp;&amp;
373ln -sv src/libreoffice-translations-&libreoffice-dlversion;/translations/</userinput></screen>
374
375 <note>
376 <para>
377 During the build process, some packages will be downloaded (including
378 the ones listed as recommended and optional dependencies) if they are
379 not present on the system. Because of this, build time may vary from the
380 published time more than usual.
381 </para>
382 </note>
383
384 <para>
385 Due to the large size of the package, you may prefer to install it in
386 <filename class="directory">/opt</filename>, instead of
387 <filename class="directory">/usr</filename>. Depending on your choice,
388 replace <replaceable>&lt;PREFIX&gt;</replaceable> by
389 <filename class="directory">/usr</filename> or by
390 <filename class="directory">/opt/libreoffice-&libreoffice-dlversion;</filename>:
391 </para>
392
393<screen><userinput>export LO_PREFIX=<replaceable>&lt;PREFIX&gt;</replaceable></userinput></screen>
394
395 <para>
396 Locales "fr" and "en-GB", you will find below, are just examples; you
397 should change them to suit your needs - you might want to read the
398 "Command Explanations", further below, before proceeding.
399 </para>
400
401 <note>
402 <para>
403 If you set the ACLOCAL environment variable to support installing
404 Xorg in /opt, you will need to unset it for this package.
405 </para>
406 </note>
407
408 <para>
409 If building on a 32 bit machine, <envar>CFLAGS</envar> is set to
410 <command>-Os</command>, which breaks the build. Prevent this
411 by issuing:
412 </para>
413
414<screen><userinput>case $(uname -m) in
415 i?86) sed /-Os/d -i solenv/gbuild/platform/LINUX_INTEL_GCC.mk ;;
416esac</userinput></screen>
417
418 <para>
419 <xref linkend="openjdk"/> breaks the build if the following variable is
420 not set:
421 </para>
422
423<screen><userinput>export ANT_OPTS="-Djava.security.manager=allow"</userinput></screen>
424
425 <para>
426 The latest version of GPGME breaks configure due to a library change.
427 Fix it by setting the following variable:
428 </para>
429
430<screen><userinput remap="pre">export ac_cv_lib_gpgmepp_progress_callback=yes</userinput></screen>
431
432 <para>
433 Prepare <application>LibreOffice</application> for compilation by running
434 the following commands:
435 </para>
436
437<screen><userinput>sed -e "/gzip -f/d" \
438 -e "s|.1.gz|.1|g" \
439 -i bin/distro-install-desktop-integration &amp;&amp;
440
441sed -e "/distro-install-file-lists/d" -i Makefile.in &amp;&amp;
442
443./autogen.sh --prefix=$LO_PREFIX \
444 --sysconfdir=/etc \
445 --with-vendor=BLFS \
446 --with-lang='fr en-GB' \
447 --with-help \
448 --with-myspell-dicts \
449 --without-junit \
450 --without-system-dicts \
451 --disable-dconf \
452 --disable-odk \
453 --enable-release-build=yes \
454 --enable-python=system \
455 --with-jdk-home=/opt/jdk \
456 --without-system-boost \
457 --with-system-clucene \
458 --with-system-curl \
459 --with-system-epoxy \
460 --with-system-expat \
461 --with-system-glm \
462 --with-system-gpgmepp \
463 --with-system-graphite \
464 --with-system-harfbuzz \
465 --with-system-icu \
466 --with-system-jpeg \
467 --with-system-lcms2 \
468 --with-system-libatomic_ops \
469 --with-system-libpng \
470 --with-system-libxml \
471 --with-system-nss \
472 --with-system-odbc \
473 --with-system-openldap \
474 --with-system-openssl \
475 --with-system-poppler \
476 --with-system-postgresql \
477 --with-system-redland \
478 --with-system-libtiff \
479 --with-system-libwebp \
480 --with-system-zlib</userinput></screen>
481<!--
482 <para>
483 The instructions below will only build the package without running
484 any unit tests. If you prefer to run the unit tests, replace
485 <command>make build-nocheck</command> with <command>make build</command>
486 or (as a regular user only) just <command>make</command>, but do not be
487 surprised if a unit test fails right at the end of the build and
488 breaks it.
489 </para>
490-->
491 <para>
492 Build the package:
493 </para>
494
495<screen><userinput>make build</userinput></screen>
496
497 <para>
498 Now, as the <systemitem class="username">root</systemitem> user:
499 </para>
500
501<screen role="root"><userinput>make distro-pack-install</userinput></screen>
502
503 <para>
504 If installed in <filename
505 class="directory">/opt/libreoffice-&libreoffice-dlversion;</filename>
506 some additional steps are necessary. Issue the following commands as the
507 <systemitem class="username">root</systemitem> user:
508 </para>
509
510<screen role="root"><userinput>if [ "$LO_PREFIX" != "/usr" ]; then
511
512 # This symlink is necessary for the desktop menu entries
513 ln -svf $LO_PREFIX/lib/libreoffice/program/soffice /usr/bin/libreoffice &amp;&amp;
514
515 # Set up a generic location independent of version number
516 ln -sfv libreoffice-&libreoffice-dlversion; /opt/libreoffice
517
518 # Icons
519 mkdir -vp /usr/share/pixmaps
520 for i in $LO_PREFIX/share/icons/hicolor/32x32/apps/*; do
521 ln -svf $i /usr/share/pixmaps
522 done &amp;&amp;
523
524 # Desktop menu entries
525 for i in $LO_PREFIX/lib/libreoffice/share/xdg/*; do
526 ln -svf $i /usr/share/applications/libreoffice-$(basename $i)
527 done &amp;&amp;
528
529 # Man pages
530 for i in $LO_PREFIX/share/man/man1/*; do
531 ln -svf $i /usr/share/man/man1/
532 done
533
534 unset i
535fi</userinput></screen>
536
537 <para>
538 If you have installed <xref linkend="desktop-file-utils"/>, and you wish
539 to update the MIME database, issue, as the <systemitem class="username">
540 root</systemitem> user:
541 </para>
542
543<screen role="root"><userinput>update-desktop-database</userinput></screen>
544
545 <para>
546 The suite and main modules can be started from the menu. From a terminal,
547 the suite can be started with the <command>libreoffice</command> command
548 and the modules with the <command>libreoffice
549 --<replaceable>&lt;module&gt;</replaceable></command> command,
550 respectively, where <replaceable>&lt;module&gt;</replaceable> is one of
551 base, calc, draw, impress, math, web, or writer. Modules cannot be started
552 using their shell starting script names (see "Installed Programs", below),
553 if LO_PREFIX is other than <filename class='directory'>/usr</filename>,
554 unless the <filename class='directory'>$LO_PREFIX/bin</filename> directory
555 is appended to the PATH.
556 </para>
557
558 </sect2>
559
560 <sect2 role="commands">
561 <title>Command Explanations</title>
562
563 <para>
564 <command>sed -e ...</command>: The first sed prevents compression of the
565 manual pages and the second one prevents the install from failing.
566 <!--and the third one allows the build to use poppler-0.86.1 and later.-->
567 <!-- FIXME update hardcoded poppler version in text when necessary -->
568 <!-- FIXME as far as I can tell, that sed is no longer present, so I
569 commented the description out here. -renodr -->
570 </para>
571
572<!--
573 <para>
574 <command>sed -i "s/TRUE/true/" ...</command>: These three sed commands
575 fix breakage caused by <application>ICU-68.1</application> removing a
576 macro. The third sed is for a file within libreoffice, the first two
577 are for packages downloaded during the build and amend '.mk' files for
578 the external projects (the source tarballs are unpacked during the build).
579 </para>
580-->
581 <para>
582 <parameter>--with-vendor=BLFS</parameter>: This switch sets BLFS as
583 the vendor which is mentioned when you click "About" from the Help menu
584 on the toolbar.
585 </para>
586
587 <para>
588 <parameter>--with-lang='fr en-GB'</parameter>: This switch sets
589 what languages to support. To list several languages, separate them with
590 a space. For all languages, use
591 <parameter>--with-lang=ALL</parameter>. Note that the translations file
592 is not needed and won't be downloaded if using only en-US as a language.
593 </para>
594
595 <note>
596 <para>
597 For a list of the available languages, look in
598 <filename>solenv/inc/langlist.mk</filename>.
599 </para>
600 </note>
601
602 <para>
603 <parameter>--with-help</parameter>: Without this switch, the help files
604 are not built.
605 </para>
606
607 <para>
608 <parameter>--with-jdk-home=/opt/jdk</parameter>: This parameter will silence
609 a warning that the configure script attempted to find JAVA_HOME
610 automatically (even though that is passed in the environment). Omit this if
611 you disabled java.
612 </para>
613
614 <para>
615 <parameter>--with-myspell-dicts</parameter>: This switch adds myspell
616 dictionaries to the <application>LibreOffice</application> installation
617 set.
618 </para>
619 <!-- Unrecognized as of 6.2.0.3
620 <para>
621 <parameter>- -with-alloc=system</parameter>: This switch tells
622 <application>LibreOffice</application> to use the system allocator
623 instead of its internal one.
624 </para>
625 -->
626 <para>
627 <parameter>--with-system-boost</parameter>: This switch enables using
628 system boost. From time to time, recent versions of boost break
629 the build of libreoffice. In this case, it is possible to use the
630 bundled copy of boost by removing this flag.
631 </para>
632
633 <para>
634 <parameter>--disable-dconf</parameter>: This switch disables compiling
635 <application>LibreOffice</application> with the
636 <application>GNOME DConf</application> configuration system support.
637 </para>
638
639 <para>
640 <parameter>--without-junit</parameter>: This switch disables the tests
641 for the deprecated HSQLDB driver which is written in Java.
642 <!-- If you wish
643 to build this driver replace this switch with the set of switches
644 described below after '- -without-java'.-->
645 </para>
646
647 <para>
648 <parameter>--without-system-dicts</parameter>: This switch disables the
649 use of dictionaries from system paths so that the ones installed by this
650 package are used.
651 </para>
652
653 <para>
654 <parameter>--disable-odk</parameter>: This switch disables installing the
655 office development kit. Remove if you want to develop a
656 <application>LibreOffice</application> based application.
657 </para>
658
659 <para>
660 <parameter>--enable-release-build=yes</parameter>: This switch enables a
661 Release Build. <application>LibreOffice</application> can be built as a
662 Release Build or as a Developer Build, because their default installation
663 paths and user profile paths are different. Developer Build displays the
664 words "Dev" and "Beta" in several places (e.g, menu and splash screen).
665 </para>
666
667 <para>
668 <parameter>--enable-python=system</parameter>: This switch tells
669 <application>LibreOffice</application> to use the system installed
670 <application>Python 3</application> instead of
671 the bundled one.
672 </para>
673
674 <para>
675 <parameter>--with-system-*</parameter>: These switches prevent
676 <application>LibreOffice</application> from trying to compile its own
677 versions of these dependencies. If you've not installed some of the
678 dependencies, remove the corresponding switches.
679 </para>
680
681<!--
682 <para>
683 <command>CPPFLAGS='-DU_USING_ICU_NAMESPACE=1' make ...</command>: <xref
684 linkend="icu"/> has removed an implicit namespace <quote>using</quote>
685 from its headers files. Setting <envar>U_USING_ICU_NAMESPACE</envar> to
686 1 allows to restore the former behavior, which is required for building
687 <application>libreoffice</application>.
688 </para>
689-->
690 <para>
691 <command>make distro-pack-install</command>: This does a normal
692 install, but if you add a DESTDIR environment variable it will also
693 install a lot of (text) gid_Module_* files in the DESTDIR, to help
694 distributions which want to break the package into parts.
695 </para>
696
697 <para>
698 <option>--with-parallelism=&lt;count&gt;</option>: This switch
699 tells <application>LibreOffice</application> to use &lt;count&gt; CPU
700 cores to compile in parallel. (Do not include literal angle brackets.)
701 The default is to use all available cores on the system.
702 </para>
703
704 <para>
705 <option>--disable-cups</option>: Use this switch if you don't need
706 printing support.
707 </para>
708
709 <para>
710 <option>--disable-dbus</option>: Use this switch if you've not installed
711 D-Bus-1.8.0 or later. It also disables Bluetooth support and font install
712 via PackageKit.
713 </para>
714
715 <para>
716 <option>--disable-firebird-sdbc</option>: By default, the ability to
717 connect to a <application>firebird</application> database is enabled.
718 Add this switch if you do not need that feature.
719 </para>
720
721 <para>
722 <option>--disable-gstreamer-1-0</option>: Use this switch if you have not
723 installed <xref linkend="gst10-plugins-base"/>.
724 </para>
725
726<!-- only gtk3 is referenced in the configure script for 6.4.0.3
727 <para>
728 <option>\-\-disable-gtk3</option>: Use this switch if you have not installed
729 <application>GTK+-3</application>, or if you have installed it but wish
730 to use <application>GTK+-2</application> (the menu icons differ).
731 <!\-\- Note that a <application>GTK+-3</application> build still
732 requires <application>GTK+-2</application> to build the gtk-plugin.\-\->
733 </para>-->
734
735 <para>
736 <option>--disable-postgresql-sdbc</option>: This switch disables compiling
737 <application>LibreOffice</application> with the ability to connect to a
738 <application>PostgreSQL</application> database. Use it if you have not
739 installed <application>PostgreSQL</application> and you do not want
740 <application>LibreOffice</application> to compile its bundled copy.
741 </para>
742
743 <para>
744 <option>--disable-skia</option>: Use <xref linkend="cairo"/> for rendering
745 instead of skia.
746 </para>
747
748 <para>
749 <option>--enable-gtk3-kde5</option>: This switch allows the Visual Class
750 Library, which is responsible for widgets, to be built with KF5 file
751 dialogs if GTK+-3, Qt5 and Plasma are all available.
752 </para>
753
754 <para>
755 <option>--enable-lto</option>: This switch will enable Link Time
756 Optimization, which results in slightly smaller libraries (about 40 MB).
757 This is said to make <application>LibreOffice</application> programs
758 load faster (and possibly run faster, e.g. when recalculating a
759 spreadsheet). On an 8-core machine with 16GB of memory, the difference
760 in compile times was minimal, but an extra 2GB was used for the work
761 files. On machines with fewer processors or a lack of memory, the compile
762 might be much slower.
763 </para>
764
765 <para>
766 <option>--without-java</option>: This switch disables
767 <application>Java</application> support in
768 <application>LibreOffice</application>. Java is needed for the
769 deprecated HSQLDB driver, which allows reading databases created by
770 other programs or in earlier versions of libreoffice
771 <application>base</application>.
772 </para>
773
774 <para>
775 <option>--without-fonts</option>: <application>LibreOffice</application>
776 includes a number of third-party TrueType fonts. If you have already
777 installed some or all of the same fonts, you may prefer to use the system
778 versions.
779 </para>
780
781 <para>
782 <!-- Brings in - -enable-qt5 as well. -->
783 <option>--enable-kf5</option>: Builds with KDE/Plasma integration. If
784 <xref linkend="qt5"/> and/or <xref linkend="kf5-frameworks"/> are not
785 installed in <filename class="directory">/usr</filename>, the include
786 and library directories must be specified in <envar>QT5INC</envar>,
787 <envar>QT5LIB</envar>, <envar>KF5INC</envar>, and <envar>KF5LIB</envar>,
788 respectively.
789 </para>
790
791 <para>
792 <option>--enable-evolution2</option>: Enables support for Evolution
793 address books through Evolution Data Server. Note that Evolution Data
794 Server must be installed for this feature to function.
795 </para>
796
797 <!--
798 <para>
799 Currently broken by ICU68 (TRUE and FALSE need to be true and false) on
800 libe-book and perhaps elsewhere - commented explanation retained. ken
801 <option>- -with-system-icu</option>: This command would use the system
802 version of <xref linkend="icu"/> which is normally considered to be a good
803 thing to do. However, one of the very minor packages pulled in by
804 <application>LibreOffice</application>, libfreehand-0.1.2, does not compile
805 with ICU-65.1 because of a missing semi-colon at the end of one line in one
806 of its files. Do not use this option unless you have separately installed a
807 patched or newer version of
808 <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libfreehand">libfreehand</ulink>.
809 </para>
810 -->
811
812 </sect2>
813
814 <sect2 role="content">
815 <title>Contents</title>
816
817 <segmentedlist>
818 <segtitle>Installed Programs</segtitle>
819 <segtitle>Installed Libraries</segtitle>
820 <segtitle>Installed Directory</segtitle>
821
822 <seglistitem>
823 <seg>
824 libreoffice, lobase, localc, lodraw, loffice, lofromtemplate,
825 loimpress, lomath, loweb, lowriter, soffice and unopkg;
826 several programs under
827 $LO_PREFIX/lib/libreoffice/program
828 </seg>
829 <seg>
830 several libraries under
831 $LO_PREFIX/lib/libreoffice/program
832 </seg>
833 <seg>
834 $LO_PREFIX/lib/libreoffice
835 </seg>
836 </seglistitem>
837 </segmentedlist>
838
839 <variablelist>
840 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
841 <?dbfo list-presentation="list"?>
842 <?dbhtml list-presentation="table"?>
843
844 <varlistentry id="libreoffice-suite">
845 <term><command>libreoffice (or soffice)</command></term>
846 <listitem>
847 <para>
848 is the main libreofice suite (symlink to
849 $LO_PREFIX/lib/libreoffice/program/soffice)
850 </para>
851 <indexterm zone="libreoffice libreoffice-suite">
852 <primary sortas="b-libreoffice-suite">libreoffice-suite</primary>
853 </indexterm>
854 </listitem>
855 </varlistentry>
856
857 <varlistentry id="lobase">
858 <term><command>lobase</command></term>
859 <listitem>
860 <para>
861 is the database manager module shell starting script
862 </para>
863 <indexterm zone="libreoffice lobase">
864 <primary sortas="b-lobase">lobase</primary>
865 </indexterm>
866 </listitem>
867 </varlistentry>
868
869 <varlistentry id="localc">
870 <term><command>localc</command></term>
871 <listitem>
872 <para>
873 is the spreadsheet module shell starting script
874 </para>
875 <indexterm zone="libreoffice localc">
876 <primary sortas="b-localc">localc</primary>
877 </indexterm>
878 </listitem>
879 </varlistentry>
880
881 <varlistentry id="lodraw">
882 <term><command>lodraw</command></term>
883 <listitem>
884 <para>
885 is the vector graphics editor and diagramming tool module shell
886 starting script
887 </para>
888 <indexterm zone="libreoffice lodraw">
889 <primary sortas="b-lodraw">lodraw</primary>
890 </indexterm>
891 </listitem>
892 </varlistentry>
893
894 <varlistentry id="loimpress">
895 <term><command>loimpress</command></term>
896 <listitem>
897 <para>
898 is the (PowerPoint) presentations editor and displayer
899 module shell starting script
900 </para>
901 <indexterm zone="libreoffice loimpress">
902 <primary sortas="b-loimpress">loimpress</primary>
903 </indexterm>
904 </listitem>
905 </varlistentry>
906
907 <varlistentry id="lomath">
908 <term><command>lomath</command></term>
909 <listitem>
910 <para>
911 is the mathematical formula editor module shell starting script
912 </para>
913 <indexterm zone="libreoffice lomath">
914 <primary sortas="b-lomath">lomath</primary>
915 </indexterm>
916 </listitem>
917 </varlistentry>
918
919 <varlistentry id="loweb">
920 <term><command>loweb</command></term>
921 <listitem>
922 <para>
923 is the HTML editor module shell starting script
924 </para>
925 <indexterm zone="libreoffice loweb">
926 <primary sortas="b-loweb">loweb</primary>
927 </indexterm>
928 </listitem>
929 </varlistentry>
930
931 <varlistentry id="lowriter">
932 <term><command>lowriter</command></term>
933 <listitem>
934 <para>
935 is the word processor module shell starting script
936 </para>
937 <indexterm zone="libreoffice lowriter">
938 <primary sortas="b-lowriter">lowriter</primary>
939 </indexterm>
940 </listitem>
941 </varlistentry>
942
943 <varlistentry id="unopkg">
944 <term><command>unopkg</command></term>
945 <listitem>
946 <para>
947 is a tool to manage <application>LibreOffice</application>
948 extensions from the command line
949 </para>
950 <indexterm zone="libreoffice unopkg">
951 <primary sortas="b-unopkg">unopkg</primary>
952 </indexterm>
953 </listitem>
954 </varlistentry>
955
956 </variablelist>
957
958 </sect2>
959
960</sect1>
Note: See TracBrowser for help on using the repository browser.