diff options
| author | Tor Lillqvist <tml@iki.fi> | 2013-04-30 11:13:35 +0300 |
|---|---|---|
| committer | Tor Lillqvist <tml@iki.fi> | 2013-04-30 11:18:27 +0300 |
| commit | 0e881978998e9b17495a63de3bb9e22aa1474066 (patch) | |
| tree | 17d25972959739707fda3201419538958f14b961 /distro-configs | |
| parent | 1c500ac128279d54f8c9ef841c15f43229c5ed11 (diff) | |
Clarify intended use of these files
Or, as it might happen, not... If there are differing opinions, please revert
and/or amend. Or start a discussion on the development list.
Change-Id: Ide5060802fda2d59a1c098d1ba8398fc095007c8
Diffstat (limited to 'distro-configs')
| -rw-r--r-- | distro-configs/README | 31 |
1 files changed, 21 insertions, 10 deletions
diff --git a/distro-configs/README b/distro-configs/README index f22328fe804a..38812fbcc9da 100644 --- a/distro-configs/README +++ b/distro-configs/README @@ -1,14 +1,25 @@ -Pre-canned distribution / platform configurations +Pre-canned distribution configurations -When the software is configured for a platform, since we run on so -many platforms, detecting the best sequence of configure options to -get it building is hard. +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. -Instead we have a text file containing the recommended (often the -distributed) version of these parameters, one per distribution or -significant platform. These are interpreted by autogen.sh and -eventually end up passed to configure. Thus: +(Possibly the above is a misunderstanding, or maybe there never even +has been any clear consensus what situations these files actually are +intended for.) -./autogen.sh --with-distro=LibreOfficeAndroid +The files contain sets of configuration parameters, and can be passed +on the autogen.sh command line thus: -might build a version tweaked for Android. +./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. |