source: xsoft/office/libreoffice.xml@ d14db83

11.2 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/soup3 xry111/xf86-video-removal
Last change on this file since d14db83 was d14db83, checked in by Bruce Dubbs <bdubbs@…>, 20 months ago

Update to libreoffice-7.4.0.3.

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