source: xsoft/office/libreoffice.xml@ 4347e96

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 4347e96 was 4347e96, checked in by Ken Moffat <ken@…>, 11 months ago

libreoffice - document the seds allowing it to build with ICU68.

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

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