source: xsoft/office/libreoffice.xml@ d613641

10.0 10.1 11.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since d613641 was d613641, checked in by Bruce Dubbs <bdubbs@…>, 21 months ago

Update to libreoffice-6.4.0.3.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22615 af4574ff-66df-0310-9fd7-8a98e5e911e0

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