distro-configs/README.md

   1 # Pre-canned Distribution Configurations
   2
   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.
  10
  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`.)
  17
  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.)
  21
  22 The files contain sets of configuration parameters, and can be passed
  23 on the `autogen.sh` command line thus:
  24
  25     ./autogen.sh --with-distro=LibreOfficeFoo
  26
  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.