source: xsoft/office/libreoffice.xml@ ae686767

11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since ae686767 was ae686767, checked in by Douglas R. Reno <renodr@…>, 10 months ago

Package Update

Update to Libreoffice-7.2.2.2

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