source: xsoft/office/libreoffice.xml@ a9b1fa8

lazarus trunk
Last change on this file since a9b1fa8 was 6bcef0a0, checked in by Bruce Dubbs <bdubbs@…>, 3 months ago

Update to libreoffice-24.2.2.2.

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