source: xsoft/office/libreoffice.xml@ 06c23e6

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 06c23e6 was 06c23e6, checked in by Ken Moffat <ken@…>, 16 months ago

Fix building libreoffice with system boost.

Apply a sed to boost (or if already built, the installed
header can be edited).

Apply a patch to libreoffice for a different change.

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