office/LibreOffice: Wrap README at 72 columns.

Signed-off-by: B. Watson <yalhcru@gmail.com>
This commit is contained in:
B. Watson 2022-03-14 03:44:42 -04:00
parent 8df6d234ad
commit a77400829f
1 changed files with 71 additions and 66 deletions

View File

@ -1,89 +1,94 @@
LibreOffice is a powerful office suite; its clean interface and powerful tools LibreOffice is a powerful office suite; its clean interface
let you unleash your creativity and grow your productivity. LibreOffice embeds and powerful tools let you unleash your creativity and grow your
several applications that make it the most powerful Free & Open Source Office productivity. LibreOffice embeds several applications that make it the
suite on the market: Writer, the word processor, Calc, the spreadsheet most powerful Free & Open Source Office suite on the market: Writer,
application, Impress, the presentation engine, Draw, our drawing and the word processor, Calc, the spreadsheet application, Impress, the
flowcharting application, Base, our database and database frontend, presentation engine, Draw, our drawing and flowcharting application,
and Math for editing mathematics. Base, our database and database frontend, and Math for editing
mathematics.
This SlackBuild builds the entire project from its source code. In seeking a This SlackBuild builds the entire project from its source code. In
fully functional LibreOffice, most optional features are included by default, seeking a fully functional LibreOffice, most optional features are
using internal versions of any external software components that may be needed. included by default, using internal versions of any external software
This results in a very small number of directly required additional software components that may be needed. This results in a very small number of
packages. directly required additional software packages.
However most of this additional software is also available as SBo SlackBuilds. However most of this additional software is also available as SBo
During configuration, the LibreOffice SlackBuild will detect any such packages SlackBuilds. During configuration, the LibreOffice SlackBuild will
that are already installed and use them in preference to building its own detect any such packages that are already installed and use them in
internal versions. Packages from SBo that will be use in this way are: preference to building its own internal versions. Packages from SBo
CoinMP cppunit glm libabw libcdr libcmis libe-book libeot libepubgen that will be use in this way are:
libexttextcat libfreehand libmspub libmwaw libnumbertext liborcus CoinMP cppunit glm libabw libcdr libcmis libe-book libeot
libpagemaker libqxp libnumbertext libstaroffice libtommath libwps libzmf libepubgen libexttextcat libfreehand libmspub libmwaw
lpsolve mythes postgresql qt5 valgrind ucpp unixODBC avahi libnumbertext liborcus libpagemaker libqxp libnumbertext
libetonyek xmlsec libstaroffice libtommath libwps libzmf lpsolve mythes postgresql
qt5 valgrind ucpp unixODBC avahi libetonyek xmlsec
Remember, these packages are not essential but entirely optional. If not found, Remember, these packages are not essential but entirely optional. If
LibreOffice will simply build its own internal versions. not found, LibreOffice will simply build its own internal versions.
Also keep in mind that any package from the above list which is detected and Also keep in mind that any package from the above list which is
used when building LibreOffice will most likely become a runtime dependency too detected and used when building LibreOffice will most likely become
e.g. if avahi is detected and used at build time, it will also need to be a runtime dependency too e.g. if avahi is detected and used at build
installed at run time. time, it will also need to be installed at run time.
Build time environment variables that may be set to vary features are as follows: Build time environment variables that may be set to vary features are
1. support additional languages by overriding the LOLANGS variable, whose as follows:
default setting is LOLANGS="de es fr id it ja nl vi zh-CN". Note that en-US 1. support additional languages by overriding the LOLANGS variable,
is always added to whatever LOLANGS is set. Thus building with, for example, whose default setting is LOLANGS="de es fr id it ja nl vi zh-CN".
Note that en-US is always added to whatever LOLANGS is set. Thus
building with, for example,
LOLANGS="de" sh LibreOffice.SlackBuild LOLANGS="de" sh LibreOffice.SlackBuild
would build LibreOffice with support for german and US english languages. would build LibreOffice with support for german and US english
Additionally, setting LOLANGS="ALL" will build in support for all available languages. Additionally, setting LOLANGS="ALL" will build in
languages. support for all available languages.
2. A number of Java Development Kits are suitable for building LibreOffice. 2. A number of Java Development Kits are suitable for building
Since Slackware-15.0 and LiberOffice-7.3.1.3 the default JDK is zulu-openjdk11. LibreOffice. Since Slackware-15.0 and LiberOffice-7.3.1.3, the
Other JDKs will probably work if the JAVA_HOME environment variable is set default JDK is zulu-openjdk11. Other JDKs will probably work if
appropriately in a file in /etc/profile.d/, where this SlackBuild will search. the JAVA_HOME environment variable is set appropriately in a file
in /etc/profile.d/, where this SlackBuild will search.
It is also possible to build LibreOffice without any JAVA support (with It is also possible to build LibreOffice without any Java support,
somewhat reduced capability in LO Base) by running: with somewhat reduced capability in LO Base) by running:
JAVA=no sh LibreOffice.SlackBuild JAVA=no sh LibreOffice.SlackBuild
3. The number of parallel make jobs used by the LibreOffice build system defaults 3. The number of parallel make jobs used by the LibreOffice build
to the number of available cpu cores. If the MAKEFLAGS environment variable system defaults to the number of available cpu cores. If the
contains the -j option e.g. MAKEFLAGS environment variable contains the -j option e.g.
MAKEFLAGS=-j6 MAKEFLAGS=-j6
then the SlackBuild will pass this to the LibreOffice build system then the SlackBuild will pass this to the LibreOffice build system
(via its --with-parallelism configure option). The number of parallel make jobs (via its --with-parallelism configure option). The number of parallel
is further controlled with the PARALLEL environment varaiable e.g. jobs is further controlled by the PARALLEL environment variable e.g:
PARALLEL=1 sh LibreOffice.SlackBuild PARALLEL=1 sh LibreOffice.SlackBuild
which would limit building to a single make process, overriding any value set which would limit building to a single make process, overriding any
with the -j option in MAKEFLAGS. value set with the -j option in MAKEFLAGS.
4. Use of ccache during building is turned off by default to save disk space (and 4. Use of ccache during building is turned off by default to save disk
possible build failure due to lack of disk space). It may be reinstated by space (and possible build failure due to lack of disk space). It may
setting the USE_CCACHE environment to "yes" e.g. be reinstated by setting the USE_CCACHE environment to "yes" e.g.
USE_CCACHE=yes sh LibreOffice.SlackBuild USE_CCACHE=yes sh LibreOffice.SlackBuild
For performance reasons, this Slackbuild sets GTK2 to be used at runtime. For performance reasons, this Slackbuild sets GTK2 to be used at
Alternatives (gen, gtk3, kde4) may still be used by setting SAL_USE_VCLPLUGIN runtime. Alternatives (gen, gtk3, kde4) may still be used by setting
in the user's runtime environment. SAL_USE_VCLPLUGIN in the user's runtime environment.
Spell checking of documents at runtime requires installation of a suitable Spell checking of documents at runtime requires installation of a
wordlist for the language concerned. This can be achieved in either of two suitable wordlist for the language concerned. This can be achieved in
ways: either of two ways:
1. Build & install hunspell-en (or hunspell-es, hunspell-pl) from SBo 1. Build & install hunspell-en (or hunspell-es, hunspell-pl) from SBo
2. Search for the desired language dictionary at: 2. Search for the desired language dictionary at:
http://extensions.libreoffice.org/extension-center?getCategories=Dictionary http://extensions.libreoffice.org/extension-center?getCategories=Dictionary
and download the relevant file e.g. dict-en.oxt. Now open LO's extension and download the relevant file e.g. dict-en.oxt. Now open LO's
manager and press the "Add..." button which will open a file browser with which extension manager and press the "Add..." button which will open a file
to locate and open the downloaded .oxt file. The new dictionary will now appear browser with which to locate and open the downloaded .oxt file. The
in the Extension Manager. new dictionary will now appear in the Extension Manager.
Some people have experienced difficulties building LibreOffice while a previoius Some people have experienced difficulties building LibreOffice while a
version is still installed. It is therefore recommended that any previous previoius version is still installed. It is therefore recommended that
version should be removed before building LibreOffice. As well as removing any any previous version should be removed before building LibreOffice. As
LibreOffice installation, it is important to also clear environment variables well as removing any LibreOffice installation, it is important to also
that were set by the installation i.e. clear environment variables that were set by the installation i.e.
/sbin/removepkg LibreOffice /sbin/removepkg LibreOffice
unset UNO_PATH unset UNO_PATH
unset URE_BOOTSTRAP unset URE_BOOTSTRAP