source: xsoft/office/libreoffice.xml@ bbd73d4

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 bbd73d4 was bbd73d4, checked in by Ken Moffat <ken@…>, 21 months ago

Update details for libreoffice. Thanks to Uwe Dűffert for the seds.

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

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