source: xsoft/office/libreoffice.xml@ b3867c5

12.0 12.1 ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since b3867c5 was b3867c5, checked in by Bruce Dubbs <bdubbs@…>, 12 months ago

Add qt5-components page.

Also create an ENTITY for qt5 or qt5-alternate and use that
to specify the qt5 dependenies.

The complete KF5/plasma packages should use the full qt5 build, but
the lxqt kf5/plasma components only need qt5-alternate.

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