source: xsoft/office/libreoffice.xml@ 4f124a8

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

Update to libreoffice-7.4.5.1.

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