source: xsoft/office/libreoffice.xml@ afb71d0a

12.0 12.1 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since afb71d0a was afb71d0a, checked in by Xi Ruoyao <xry111@…>, 13 months ago

Add notes about Internet connection requirement for building or testing

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