source: xsoft/office/libreoffice.xml@ aa95e8ed

trunk
Last change on this file since aa95e8ed was 3a0e7d3, checked in by Douglas R. Reno <renodr@…>, 3 weeks ago

gnome-shell/libreoffice: remove dependencies on telepathy components.

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