source: xsoft/office/libreoffice.xml@ efba2c1

12.0 12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since efba2c1 was efba2c1, checked in by Douglas R. Reno <renodr@…>, 9 months ago

Update to libreoffice-7.6.0.3

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