Branch libreoffice-5-0-4
[LibreOffice.git] / distro-configs / README
blob66a6e324d48aab35a87a0c53ec6e6d2c1b082250
1 Pre-canned distribution configurations
3 These files are supposed to correspond to the options used when
4 creating the Document Foundation (or other "canonical") builds of
5 LibreOffice for various platforms. They are *not* supposed to
6 represent the "most useful" options for developers in general. On the
7 contrary, the intent is that just running ./autogen.sh without any
8 options at all should produce a buildable configuration for developers
9 with interest in working on the most commonly used parts of the code.
11 See [[https://wiki.documentfoundation.org/Development/ReleaseBuilds]] for how
12 TDF builds make use of these switches.  (Especially, since --with-package-format
13 now triggers whether or not installation sets are built, all the relevant *.conf
14 files specify it, except for LibreOfficeLinux.conf, where the TDF build
15 instructions pass an explicit --with-package-format="rpm deb" in addition to
16 --with-distro=LibreOfficeLinux.)
18 (Possibly the above is a misunderstanding, or maybe there never even
19 has been any clear consensus what situations these files actually are
20 intended for.)
22 The files contain sets of configuration parameters, and can be passed
23 on the autogen.sh command line thus:
25 ./autogen.sh --with-distro=LibreOfficeFoo
27 Contrary to the above, in the Android case the amount of parameters
28 you just must use is so large, that for convenience it is always
29 easiest to use the corresponding distro-configs file. This is a bug
30 and needs to be fixed; also configuring for Android should ideally use
31 sane (or the only possible) defaults and work fine without any
32 parameters at all.