source: xsoft/office/libreoffice.xml@ e5d767b

12.2 lazarus trunk
Last change on this file since e5d767b was e9f7b881, checked in by Douglas R. Reno <renodr@…>, 4 weeks ago

libreoffice: minor text fix

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