source: xsoft/office/libreoffice.xml@ 446155fb

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 446155fb was 446155fb, checked in by Pierre Labastie <pierre.labastie@…>, 17 months ago

Update to libreoffice-7.4.3.2

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