source: xsoft/office/libreoffice.xml@ 1022c00c

12.1 ken/TL2024 lazarus trunk xry111/llvm18
Last change on this file since 1022c00c was 1022c00c, checked in by Bruce Dubbs <bdubbs@…>, 4 months ago

Tags and a small wording change in libreoffice

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