source: xsoft/office/libreoffice.xml@ b54fdc84

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since b54fdc84 was b54fdc84, checked in by Pierre Labastie <pierre.labastie@…>, 16 months ago

Update to libreoffice-7.4.4.2

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