summaryrefslogtreecommitdiff
path: root/distro-configs/README
blob: 38812fbcc9da6a60ffe5f0f7da1f210f4bbc9c33 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
Pre-canned distribution configurations

These files are supposed to correspond to the options used when
creating the Document Foundation (or other "canonical") builds of
LibreOffice for various platforms. They are *not* supposed to
represent the "most useful" options for developers in general. On the
contrary, the intent is that just running ./autogen.sh without any
options at all should produce a buildable configuration for developers
with interest in working on the most commonly used parts of the code.

(Possibly the above is a misunderstanding, or maybe there never even
has been any clear consensus what situations these files actually are
intended for.)

The files contain sets of configuration parameters, and can be passed
on the autogen.sh command line thus:

./autogen.sh --with-distro=LibreOfficeFoo

Contrary to the above, in the Android and iOS cases the amount of
parameters you just must use is so large, that for convenience it is
always easiest to use the corresponding distro-configs file. This is a
bug and needs to be fixed; also configuring for those platforms needs
to use sane (or only possible) defaults and work fine wihout any
parameters at all.