source: xsoft/office/libreoffice.xml@ 7a9a7b26

11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/soup3 xry111/xf86-video-removal
Last change on this file since 7a9a7b26 was 7a9a7b26, checked in by Pierre Labastie <pierre.labastie@…>, 2 years ago

Remove spaces at the end of lines

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