source: xsoft/office/libreoffice.xml

trunk
Last change on this file was 59928210, checked in by Bruce Dubbs <bdubbs@…>, 2 weeks ago

Update to libreoffice-24.2.3.2.

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