source: xsoft/office/libreoffice.xml@ 9b5f4a7

12.2 lazarus trunk xry111/for-12.3 xry111/spidermonkey128
Last change on this file since 9b5f4a7 was 9b5f4a7, checked in by Xi Ruoyao <xry111@…>, 2 months ago

libreoffice: Drop dbus-glib dependency

The upstream has dropped it since 6.2.0 (in 2018).

Link: https://bugs.documentfoundation.org/show_bug.cgi?id=112343

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