source: xsoft/office/libreoffice.xml@ 00b933f

12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since 00b933f was 00b933f, checked in by Pierre Labastie <pierre.labastie@…>, 8 months ago

Fix libreoffice for ICU 74

  • Property mode set to 100644
File size: 35.6 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 "13fca0b5df68b445340d7c5f8373e99c">
11 <!ENTITY libreoffice-core-size "268 MB">
12
13 <!ENTITY libreoffice-dict-download-http "&libreoffice-dl;/libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz">
14 <!ENTITY libreoffice-dict-md5sum "f44ce208c556bc06c9e09a9d742cf580">
15 <!ENTITY libreoffice-dict-size "51 MB">
16
17 <!ENTITY libreoffice-help-download-http "&libreoffice-dl;/libreoffice-help-&libreoffice-dlversion;.tar.xz">
18 <!ENTITY libreoffice-help-md5sum "5dd9257d057c547ba37bbb2d1a77e5af">
19 <!ENTITY libreoffice-help-size "159 MB">
20
21 <!ENTITY libreoffice-translations-download-http "&libreoffice-dl;/libreoffice-translations-&libreoffice-dlversion;.tar.xz">
22 <!ENTITY libreoffice-translations-md5sum "6ec3d46a10a4b62c86b9890779775198">
23 <!ENTITY libreoffice-translations-size "207 MB">
24
25 <!-- full size remeasured for 7.0.0.3 -->
26
27 <!ENTITY libreoffice-buildsize "10 GB including the additional files if downloaded during the build (758 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 "22 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 &lfs120_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 build and installed disk
212 space and 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"/>,
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="avahi"/>,
254 <xref linkend="bluez"/>,
255 <xref linkend="dconf"/>,
256 <xref linkend="desktop-file-utils"/>,
257 <xref linkend="doxygen"/> (not relevant if using --disable-odk),
258 <xref linkend="evolution-data-server"/>,
259 <xref linkend="gdb"/>,
260 <xref linkend="gnutls"/>,
261 <xref linkend="kf5-frameworks"/>,
262 <xref linkend="libpaper"/>,
263 <xref linkend="mariadb"/> or <ulink url="https://www.mysql.com/">MySQL</ulink>,
264 <xref linkend="mitkrb"/>,
265 <xref linkend="nasm"/>,
266 &qt5-deps;,
267 <xref linkend="sane"/>,
268 <xref linkend="telepathy-glib"/>,
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 If you have downloaded the dictionaries, help and translations tarballs,
360 create symlinks to them from the source directory so they won't get
361 downloaded again:
362 </para>
363
364<screen><userinput>install -dm755 external/tarballs &amp;&amp;
365ln -sv ../../../libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz external/tarballs/ &amp;&amp;
366ln -sv ../../../libreoffice-help-&libreoffice-dlversion;.tar.xz external/tarballs/ &amp;&amp;
367ln -sv ../../../libreoffice-translations-&libreoffice-dlversion;.tar.xz external/tarballs/</userinput></screen>
368
369 <para>
370 The instructions in the package unpack some tarballs into a location
371 it cannot find later. Create some symlinks to help the build system out:
372 </para>
373
374<screen><userinput>ln -sv src/libreoffice-help-&libreoffice-dlversion;/helpcontent2/ &amp;&amp;
375ln -sv src/libreoffice-dictionaries-&libreoffice-dlversion;/dictionaries/ &amp;&amp;
376ln -sv src/libreoffice-translations-&libreoffice-dlversion;/translations/</userinput></screen>
377
378 <note>
379 <para>
380 During the build process, some packages will be downloaded (including
381 the ones listed as recommended and optional dependencies) if they are
382 not present on the system. Because of this, build time may vary from the
383 published time more than usual.
384 </para>
385 </note>
386
387 <para>
388 Due to the large size of the package, you may prefer to install it in
389 <filename class="directory">/opt</filename>, instead of
390 <filename class="directory">/usr</filename>. Depending on your choice,
391 replace <replaceable>&lt;PREFIX&gt;</replaceable> by
392 <filename class="directory">/usr</filename> or by
393 <filename class="directory">/opt/libreoffice-&libreoffice-dlversion;</filename>:
394 </para>
395
396<screen><userinput>export LO_PREFIX=<replaceable>&lt;PREFIX&gt;</replaceable></userinput></screen>
397
398 <para>
399 Locales "fr" and "en-GB", you will find below, are just examples; you
400 should change them to suit your needs - you might want to read the
401 "Command Explanations", further below, before proceeding.
402 </para>
403
404 <note>
405 <para>
406 If you set the ACLOCAL environment variable to support installing
407 Xorg in /opt, you will need to unset it for this package.
408 </para>
409 </note>
410
411 <para>
412 If you are building on a 32 bit machine, <envar>CFLAGS</envar> is set to
413 <command>-Os</command>, which breaks the build. Prevent this
414 by issuing:
415 </para>
416
417<screen><userinput>case $(uname -m) in
418 i?86) sed /-Os/d -i solenv/gbuild/platform/LINUX_INTEL_GCC.mk ;;
419esac</userinput></screen>
420
421 <para>
422 Fix an error occurring with ICU 74+:
423 </para>
424
425<screen><userinput>sed -e /LBCM/d -i i18npool/source/breakiterator/data/line.txt</userinput></screen>
426
427 <para>
428 Prepare <application>LibreOffice</application> for compilation by running
429 the following commands:
430 </para>
431
432 <!--Editors: if it happens you need to remove some "with-system-xxx"
433 instruction because libreoffice temporarily cannot use the current
434 system version, please keep it around commented out, so that it can be
435 remembered to test it with higher versions of libreoffice. -->
436
437<screen><userinput>sed -e "/gzip -f/d" \
438 -e "s|.1.gz|.1|g" \
439 -i bin/distro-install-desktop-integration &amp;&amp;
440
441sed -e "/distro-install-file-lists/d" -i Makefile.in &amp;&amp;
442
443./autogen.sh --prefix=$LO_PREFIX \
444 --sysconfdir=/etc \
445 --with-vendor=BLFS \
446 --with-lang='fr en-GB' \
447 --with-help \
448 --with-myspell-dicts \
449 --without-junit \
450 --without-system-dicts \
451 --disable-dconf \
452 --disable-odk \
453 --enable-release-build=yes \
454 --enable-python=system \
455 --with-jdk-home=/opt/jdk \
456 --with-system-boost \
457 --with-system-clucene \
458 --with-system-curl \
459 --with-system-epoxy \
460 --with-system-expat \
461 --with-system-glm \
462 --with-system-gpgmepp \
463 --with-system-graphite \
464 --with-system-harfbuzz \
465 --with-system-icu \
466 --with-system-jpeg \
467 --with-system-lcms2 \
468 --with-system-libatomic_ops \
469 --with-system-libpng \
470 --with-system-libxml \
471 --with-system-nss \
472 --with-system-odbc \
473 --with-system-openldap \
474 --with-system-openssl \
475 --with-system-poppler \
476 --with-system-postgresql \
477 --with-system-redland \
478 --with-system-libtiff \
479 --with-system-libwebp \
480 --with-system-zlib</userinput></screen>
481<!--
482 <para>
483 The instructions below will only build the package without running
484 any unit tests. If you prefer to run the unit tests, replace
485 <command>make build-nocheck</command> with <command>make build</command>
486 or (as a regular user only) just <command>make</command>, but do not be
487 surprised if a unit test fails right at the end of the build and
488 breaks it.
489 </para>
490-->
491 <para>
492 Build the package:
493 </para>
494
495<screen><userinput>make build</userinput></screen>
496
497 <para>
498 Now, as the <systemitem class="username">root</systemitem> user:
499 </para>
500
501<screen role="root"><userinput>make distro-pack-install</userinput></screen>
502
503 <para>
504 If installed in <filename
505 class="directory">/opt/libreoffice-&libreoffice-dlversion;</filename>
506 some additional steps are necessary. Issue the following commands as the
507 <systemitem class="username">root</systemitem> user:
508 </para>
509
510<screen role="root"><userinput>if [ "$LO_PREFIX" != "/usr" ]; then
511
512 # This symlink is necessary for the desktop menu entries
513 ln -svf $LO_PREFIX/lib/libreoffice/program/soffice /usr/bin/libreoffice &amp;&amp;
514
515 # Set up a generic location independent of version number
516 ln -sfv libreoffice-&libreoffice-dlversion; /opt/libreoffice
517
518 # Icons
519 mkdir -vp /usr/share/pixmaps
520 for i in $LO_PREFIX/share/icons/hicolor/32x32/apps/*; do
521 ln -svf $i /usr/share/pixmaps
522 done &amp;&amp;
523
524 # Desktop menu entries
525 for i in $LO_PREFIX/lib/libreoffice/share/xdg/*; do
526 ln -svf $i /usr/share/applications/libreoffice-$(basename $i)
527 done &amp;&amp;
528
529 # Man pages
530 for i in $LO_PREFIX/share/man/man1/*; do
531 ln -svf $i /usr/share/man/man1/
532 done
533
534 unset i
535fi</userinput></screen>
536
537 <para>
538 If you have installed <xref linkend="desktop-file-utils"/>, and you wish
539 to update the MIME database, issue, as the <systemitem class="username">
540 root</systemitem> user:
541 </para>
542
543<screen role="root"><userinput>update-desktop-database</userinput></screen>
544
545 <para>
546 The suite and main modules can be started from the menu. From a terminal,
547 the suite can be started with the <command>libreoffice</command> command
548 and the modules with the <command>libreoffice
549 --<replaceable>&lt;module&gt;</replaceable></command> command,
550 respectively, where <replaceable>&lt;module&gt;</replaceable> is one of
551 base, calc, draw, impress, math, web, or writer. Modules cannot be started
552 using their shell starting script names (see "Installed Programs", below),
553 if LO_PREFIX is other than <filename class='directory'>/usr</filename>,
554 unless the <filename class='directory'>$LO_PREFIX/bin</filename> directory
555 is appended to the PATH.
556 </para>
557
558 </sect2>
559
560 <sect2 role="commands">
561 <title>Command Explanations</title>
562
563 <para>
564 <command>sed -e ...</command>: The first sed prevents compression of the
565 manual pages and the second one prevents the install from failing.
566 </para>
567
568 <para>
569 <parameter>--with-vendor=BLFS</parameter>: This switch sets BLFS as
570 the vendor which is mentioned when you click "About" from the Help menu
571 on the toolbar.
572 </para>
573
574 <para>
575 <parameter>--with-lang='fr en-GB'</parameter>: This switch sets
576 what languages to support. To list several languages, separate them with
577 a space. For all languages, use
578 <option>--with-lang=ALL</option>. Note that the translations file
579 is not needed and won't be downloaded if using only en-US as a language.
580 </para>
581
582 <note>
583 <para>
584 For a list of the available languages, look in
585 <filename>solenv/inc/langlist.mk</filename>.
586 </para>
587 </note>
588
589 <para>
590 <parameter>--with-help</parameter>: Without this switch, the help files
591 are not built.
592 </para>
593
594 <para>
595 <parameter>--with-jdk-home=/opt/jdk</parameter>: This parameter will silence
596 a warning that the configure script attempted to find JAVA_HOME
597 automatically (even though that is passed in the environment). Omit this if
598 you disabled java.
599 </para>
600
601 <para>
602 <parameter>--with-myspell-dicts</parameter>: This switch adds myspell
603 dictionaries to the <application>LibreOffice</application> installation
604 set.
605 </para>
606
607 <para>
608 <parameter>--with-system-boost</parameter>: This switch enables using
609 system boost. From time to time, recent versions of boost break
610 the build of libreoffice. In this case, it is possible to use the
611 bundled copy of boost by removing this flag.
612 </para>
613
614 <para>
615 <parameter>--disable-dconf</parameter>: This switch disables compiling
616 <application>LibreOffice</application> with the
617 <application>GNOME DConf</application> configuration system support.
618 </para>
619
620 <para>
621 <parameter>--without-junit</parameter>: This switch disables the tests
622 for the deprecated HSQLDB driver which is written in Java.
623 <!-- If you wish
624 to build this driver replace this switch with the set of switches
625 described below after '- -without-java'.-->
626 </para>
627
628 <para>
629 <parameter>--without-system-dicts</parameter>: This switch disables the
630 use of dictionaries from system paths so that the ones installed by this
631 package are used.
632 </para>
633
634 <para>
635 <parameter>--disable-odk</parameter>: This switch disables installing the
636 office development kit. Remove if you want to develop a
637 <application>LibreOffice</application> based application.
638 </para>
639
640 <para>
641 <parameter>--enable-release-build=yes</parameter>: This switch enables a
642 Release Build. <application>LibreOffice</application> can be built as a
643 Release Build or as a Developer Build, because their default installation
644 paths and user profile paths are different. Developer Build displays the
645 words "Dev" and "Beta" in several places (e.g, menu and splash screen).
646 </para>
647
648 <para>
649 <parameter>--enable-python=system</parameter>: This switch tells
650 <application>LibreOffice</application> to use the system installed
651 <application>Python 3</application> instead of
652 the bundled one.
653 </para>
654
655 <para>
656 <parameter>--with-system-*</parameter>: These switches prevent
657 <application>LibreOffice</application> from trying to compile its own
658 versions of these dependencies. If you've not installed some of the
659 dependencies, remove the corresponding switches.
660 </para>
661
662<!--
663 <para>
664 <command>CPPFLAGS='-DU_USING_ICU_NAMESPACE=1' make ...</command>: <xref
665 linkend="icu"/> has removed an implicit namespace <quote>using</quote>
666 from its headers files. Setting <envar>U_USING_ICU_NAMESPACE</envar> to
667 1 allows to restore the former behavior, which is required for building
668 <application>libreoffice</application>.
669 </para>
670-->
671 <para>
672 <command>make distro-pack-install</command>: This does a normal
673 install, but if you add a DESTDIR environment variable it will also
674 install a lot of (text) gid_Module_* files in the DESTDIR, to help
675 distributions which want to break the package into parts.
676 </para>
677
678 <para>
679 <option>--with-parallelism=&lt;count&gt;</option>: This switch
680 tells <application>LibreOffice</application> to use &lt;count&gt; CPU
681 cores to compile in parallel. (Do not include literal angle brackets.)
682 The default is to use all available cores on the system.
683 </para>
684
685 <para>
686 <option>--disable-cups</option>: Use this switch if you don't need
687 printing support.
688 </para>
689
690 <para>
691 <option>--disable-dbus</option>: Use this switch if you've not installed
692 D-Bus-1.8.0 or later. It also disables Bluetooth support and font install
693 via PackageKit.
694 </para>
695
696 <para>
697 <option>--disable-firebird-sdbc</option>: By default, the ability to
698 connect to a <application>firebird</application> database is enabled.
699 Add this switch if you do not need that feature.
700 </para>
701
702 <para>
703 <option>--disable-gstreamer-1-0</option>: Use this switch if you have not
704 installed <xref linkend="gst10-plugins-base"/>.
705 </para>
706
707 <para>
708 <option>--disable-postgresql-sdbc</option>: This switch disables compiling
709 <application>LibreOffice</application> with the ability to connect to a
710 <application>PostgreSQL</application> database. Use it if you have not
711 installed <application>PostgreSQL</application> and you do not want
712 <application>LibreOffice</application> to compile its bundled copy.
713 </para>
714
715 <para>
716 <option>--disable-skia</option>: Use <xref linkend="cairo"/> for rendering
717 instead of skia.
718 </para>
719
720 <para>
721 <option>--enable-gtk3-kde5</option>: This switch allows the Visual Class
722 Library, which is responsible for widgets, to be built with KF5 file
723 dialogs if GTK+-3, Qt5 and Plasma are all available.
724 </para>
725
726 <para>
727 <option>--enable-lto</option>: This switch will enable Link Time
728 Optimization, which results in slightly smaller libraries (about 40 MB).
729 This is said to make <application>LibreOffice</application> programs
730 load faster (and possibly run faster, e.g. when recalculating a
731 spreadsheet). On an 8-core machine with 16GB of memory, the difference
732 in compile times was minimal, but an extra 2GB was used for the work
733 files. On machines with fewer processors or a lack of memory, the compile
734 might be much slower.
735 </para>
736
737 <para>
738 <option>--without-java</option>: This switch disables
739 <application>Java</application> support in
740 <application>LibreOffice</application>. Java is needed for the
741 deprecated HSQLDB driver, which allows reading databases created by
742 other programs or in earlier versions of libreoffice
743 <application>base</application>. It is also needed for some optional
744 user interface components.
745 </para>
746
747 <para>
748 <option>--without-fonts</option>: <application>LibreOffice</application>
749 includes a number of third-party TrueType fonts. If you have already
750 installed some or all of the same fonts, you may prefer to use the system
751 versions.
752 </para>
753
754 <para>
755 <!-- Brings in - -enable-qt5 as well. -->
756 <option>--enable-kf5</option>: Builds with KDE/Plasma integration. If
757 &qt5-deps; and/or <xref linkend="kf5-frameworks"/> are not
758 installed in <filename class="directory">/usr</filename>, the include
759 and library directories must be specified in <envar>QT5INC</envar>,
760 <envar>QT5LIB</envar>, <envar>KF5INC</envar>, and <envar>KF5LIB</envar>,
761 respectively.
762 </para>
763
764 <para>
765 <option>--enable-evolution2</option>: Enables support for Evolution
766 address books through Evolution Data Server. Note that Evolution Data
767 Server must be installed for this feature to function.
768 </para>
769
770 <para>
771 <option>--enable-qt5</option>: This switch enables support for integration
772 with Qt5 and the Qt5 theming engine. If &qt5-deps; is not installed in
773 <filename class="directory">/usr</filename>, the include and library
774 directories must be specified in the <envar>QT5INC</envar> and
775 <envar>QT5LIB</envar> environment variables.
776 </para>
777
778 <!--
779 <para>
780 Currently broken by ICU68 (TRUE and FALSE need to be true and false) on
781 libe-book and perhaps elsewhere - commented explanation retained. ken
782 <option>- -with-system-icu</option>: This command would use the system
783 version of <xref linkend="icu"/> which is normally considered to be a good
784 thing to do. However, one of the very minor packages pulled in by
785 <application>LibreOffice</application>, libfreehand-0.1.2, does not compile
786 with ICU-65.1 because of a missing semi-colon at the end of one line in one
787 of its files. Do not use this option unless you have separately installed a
788 patched or newer version of
789 <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libfreehand">libfreehand</ulink>.
790 </para>
791 -->
792
793 </sect2>
794
795 <sect2 role="content">
796 <title>Contents</title>
797
798 <segmentedlist>
799 <segtitle>Installed Programs</segtitle>
800 <segtitle>Installed Libraries</segtitle>
801 <segtitle>Installed Directory</segtitle>
802
803 <seglistitem>
804 <seg>
805 libreoffice, lobase, localc, lodraw, loffice, lofromtemplate,
806 loimpress, lomath, loweb, lowriter, soffice and unopkg;
807 several programs under
808 $LO_PREFIX/lib/libreoffice/program
809 </seg>
810 <seg>
811 several libraries under
812 $LO_PREFIX/lib/libreoffice/program
813 </seg>
814 <seg>
815 $LO_PREFIX/lib/libreoffice
816 </seg>
817 </seglistitem>
818 </segmentedlist>
819
820 <variablelist>
821 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
822 <?dbfo list-presentation="list"?>
823 <?dbhtml list-presentation="table"?>
824
825 <varlistentry id="libreoffice-suite">
826 <term><command>libreoffice (or soffice)</command></term>
827 <listitem>
828 <para>
829 is the main libreofice suite (symlink to
830 $LO_PREFIX/lib/libreoffice/program/soffice)
831 </para>
832 <indexterm zone="libreoffice libreoffice-suite">
833 <primary sortas="b-libreoffice-suite">libreoffice-suite</primary>
834 </indexterm>
835 </listitem>
836 </varlistentry>
837
838 <varlistentry id="lobase">
839 <term><command>lobase</command></term>
840 <listitem>
841 <para>
842 is the database manager module shell starting script
843 </para>
844 <indexterm zone="libreoffice lobase">
845 <primary sortas="b-lobase">lobase</primary>
846 </indexterm>
847 </listitem>
848 </varlistentry>
849
850 <varlistentry id="localc">
851 <term><command>localc</command></term>
852 <listitem>
853 <para>
854 is the spreadsheet module shell starting script
855 </para>
856 <indexterm zone="libreoffice localc">
857 <primary sortas="b-localc">localc</primary>
858 </indexterm>
859 </listitem>
860 </varlistentry>
861
862 <varlistentry id="lodraw">
863 <term><command>lodraw</command></term>
864 <listitem>
865 <para>
866 is the vector graphics editor and diagramming tool module shell
867 starting script
868 </para>
869 <indexterm zone="libreoffice lodraw">
870 <primary sortas="b-lodraw">lodraw</primary>
871 </indexterm>
872 </listitem>
873 </varlistentry>
874
875 <varlistentry id="loimpress">
876 <term><command>loimpress</command></term>
877 <listitem>
878 <para>
879 is the (PowerPoint) presentations editor and displayer
880 module shell starting script
881 </para>
882 <indexterm zone="libreoffice loimpress">
883 <primary sortas="b-loimpress">loimpress</primary>
884 </indexterm>
885 </listitem>
886 </varlistentry>
887
888 <varlistentry id="lomath">
889 <term><command>lomath</command></term>
890 <listitem>
891 <para>
892 is the mathematical formula editor module shell starting script
893 </para>
894 <indexterm zone="libreoffice lomath">
895 <primary sortas="b-lomath">lomath</primary>
896 </indexterm>
897 </listitem>
898 </varlistentry>
899
900 <varlistentry id="loweb">
901 <term><command>loweb</command></term>
902 <listitem>
903 <para>
904 is the HTML editor module shell starting script
905 </para>
906 <indexterm zone="libreoffice loweb">
907 <primary sortas="b-loweb">loweb</primary>
908 </indexterm>
909 </listitem>
910 </varlistentry>
911
912 <varlistentry id="lowriter">
913 <term><command>lowriter</command></term>
914 <listitem>
915 <para>
916 is the word processor module shell starting script
917 </para>
918 <indexterm zone="libreoffice lowriter">
919 <primary sortas="b-lowriter">lowriter</primary>
920 </indexterm>
921 </listitem>
922 </varlistentry>
923
924 <varlistentry id="unopkg">
925 <term><command>unopkg</command></term>
926 <listitem>
927 <para>
928 is a tool to manage <application>LibreOffice</application>
929 extensions from the command line
930 </para>
931 <indexterm zone="libreoffice unopkg">
932 <primary sortas="b-unopkg">unopkg</primary>
933 </indexterm>
934 </listitem>
935 </varlistentry>
936
937 </variablelist>
938
939 </sect2>
940
941</sect1>
Note: See TracBrowser for help on using the repository browser.