summaryrefslogtreecommitdiffstats
path: root/docs/build-instructions.rst
diff options
context:
space:
mode:
authorStefan K. Berg <stefan.k.berg@ericsson.com>2015-12-02 16:27:41 +0100
committerStefan K. Berg <stefan.k.berg@ericsson.com>2015-12-03 11:28:16 +0100
commit5a6f83ed600757a2850ef3c83c2daf950decb5c8 (patch)
tree81a286d7e10dde842db2207a8a1b7af600247b1e /docs/build-instructions.rst
parent8b7b4f8bde98b05ee68dbed04fa2861bbaaebc22 (diff)
Support for selecting which plugins to build
In order to cut the build time for unofficial builds, this change supports setting the environment variable "BUILD_FUEL_PLUGINS" prior to building. Only the plugin targets from fuel/build/f_isoroot/Makefile that are specified will then be built. In order to completely disable the building of plugins, the environment variable is set to " ". When using this functionality, the resulting iso file will be prepended with the prefix "unofficial-" to clearly indiciate that this is not a full build. Change-Id: Ib0a914ed6577f54f31b056a752691316302081dc Signed-off-by: Stefan K. Berg <stefan.k.berg@ericsson.com>
Diffstat (limited to 'docs/build-instructions.rst')
-rw-r--r--docs/build-instructions.rst21
1 files changed, 21 insertions, 0 deletions
diff --git a/docs/build-instructions.rst b/docs/build-instructions.rst
index 08b560375..aa8077e6e 100644
--- a/docs/build-instructions.rst
+++ b/docs/build-instructions.rst
@@ -34,6 +34,10 @@ Version history
| 2015-10-23 | 1.1.1 | Stefan Berg | Added instructions |
| | | (Ericsson AB) | for proxy builds |
+--------------------+--------------------+--------------------+----------------------+
+| 2015-12-03 | 1.2.0 | Stefan Berg | Added instructions |
+| | | (Ericsson AB) | for plugin build |
+| | | | selection |
++--------------------+--------------------+--------------------+----------------------+
Introduction
============
@@ -210,6 +214,23 @@ Configure your build environment
Select the versions of the components you want to build by editing the fuel/build/config.mk file.
+Non official build: Selecting which plugins to build
+----------------------------------------------------
+In order to cut the build time for unofficial builds (made by an
+individual developer locally), the selection if which Fuel plugins to
+build (if any) can be done by environment variable
+"BUILD_FUEL_PLUGINS" prior to building.
+
+Only the plugin targets from fuel/build/f_isoroot/Makefile that are
+specified in the environment variable will then be built. In order to
+completely disable the building of plugins, the environment variable
+is set to " ". When using this functionality, the resulting iso file
+will be prepended with the prefix "unofficial-" to clearly indiciate
+that this is not a full build.
+
+This method of plugin selection is not meant to be used from within
+Gerrit!
+
Low level build method using make
---------------------------------
The low level method is based on Make: