kumquat-buildroot/docs/manual
Thomas Petazzoni a4239f7fd1 core: introduce the BR2_EXTERNAL variable
This commit introduces the BR2_EXTERNAL environment variable, which
will allow to keep Buildroot customization (board-specific
configuration files or root filesystem overlays, package Config.in and
makefiles, as well as defconfigs) outside of the Buildroot tree.

This commit only introduces the variable itself, and ensures that it
is available within Config.in options. This allows us to use
$BR2_EXTERNAL in a 'source' statement in Config.in.

Following patches extend the usage of BR2_EXTERNAL to other areas
(packages and defconfigs).

In details, this commit:

 * Introduces the BR2_EXTERNAL Kconfig option. This option has no
   prompt, and is therefore not visible to the user and also not
   stored in the .config file. It is automatically set to the value of
   the BR2_EXTERNAL environment variable. The only purpose of this
   BR2_EXTERNAL Kconfig option is to allow $BR2_EXTERNAL to be
   properly expanded when used inside Kconfig source statements.

 * Calculates the BR2_EXTERNAL value to use. If passed on the command
   line, then this value is taken in priority, and saved to a
   .br-external hidden file in the output directory. If not passed on
   the command line, then we read the .br-external file from the
   output directory. This allows the user to not pass the BR2_EXTERNAL
   value at each make invocation. If no BR2_EXTERNAL value is passed,
   we define it to support/dummy-external, so that the kconfig code
   finds an existing $(BR2_EXTERNAL)/package/Config.in file to
   include.

 * Passes the BR2_EXTERNAL into the *config environment, so that its
   value is found when parsing/evaluating Config.in files and .config
   values.

Signed-off-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr>
Tested-by: "Yann E. MORIN" <yann.morin.1998@free.fr>
Acked-by: Ryan Barnett <rjbarnet@rockwellcollins.com>
Tested-by: "Samuel Martin" <s.martin49@gmail.com>
Acked-by: "Samuel Martin" <s.martin49@gmail.com>
Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
2013-12-08 22:38:13 +01:00
..
adding-packages-autotools.txt manual: remove package clean commands 2013-12-08 19:41:54 +01:00
adding-packages-cmake.txt manual: remove package clean commands 2013-12-08 19:41:54 +01:00
adding-packages-conclusion.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
adding-packages-directory.txt manual: remove package clean commands 2013-12-08 19:41:54 +01:00
adding-packages-generic.txt manual: remove package clean commands 2013-12-08 19:41:54 +01:00
adding-packages-gettext.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
adding-packages-hooks.txt manual: add some info on the POST_RSYNC hook 2013-11-11 00:12:05 +01:00
adding-packages-tips.txt docs: document the new github helper function 2013-12-06 22:37:34 +01:00
adding-packages.txt manual: split info on hooks to a separate section/file 2013-11-11 00:11:40 +01:00
advanced.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
appendix.txt manual: rename section name of package lists 2013-10-14 12:50:11 +02:00
beyond-buildroot.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
ccache-support.txt ccache: expose control interface via 'make ccache-options' 2013-10-27 10:30:10 +01:00
common-usage.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
configure.txt docs: update manual after Crosstool-NG backend removal 2013-10-06 20:53:58 +02:00
contribute.txt manual: update review process and patchwork 2013-10-14 23:16:22 +02:00
customize-busybox-config.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
customize-kernel-config.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
customize-packages.txt rework patch model 2013-03-19 23:10:49 +01:00
customize-rootfs.txt post-{build, images} hooks: export BUILD_DIR too 2013-11-13 00:25:18 +01:00
customize-store.txt docs: update manual after Crosstool-NG backend removal 2013-10-06 20:53:58 +02:00
customize-toolchain.txt manual: customize-toolchain.txt: update internal backend section 2013-11-01 17:09:39 +01:00
customize-uclibc-config.txt uclibc: convert to the package infrastructure 2013-07-04 00:13:23 +02:00
customize.txt rework patch model 2013-03-19 23:10:49 +01:00
debugging-buildroot.txt pkg-infra: add user-supplied step-hooks 2013-11-13 00:27:26 +01:00
developer-guide.txt pkg-infra: add user-supplied step-hooks 2013-11-13 00:27:26 +01:00
download-infra.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
download-location.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
eclipse-integration.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
faq-troubleshooting.txt Remove references to module-init-tools 2013-09-02 23:01:34 +02:00
get-involved.txt manual: update review process and patchwork 2013-10-14 23:16:22 +02:00
getting.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
going-further.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
how-buildroot-works.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
introduction.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
known-issues.txt manual/known-issues.txt: fix s/Soucery/Sourcery/ typo 2013-10-07 09:33:46 +02:00
legal-notice.txt legal info: update documentation with split target/host output 2013-11-17 09:15:17 +01:00
make-tips.txt manual generation: check dependencies first 2013-11-01 16:41:04 +01:00
makedev-syntax.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
makeusers-syntax.txt packages: add ability for packages to create users 2013-04-25 22:56:42 +02:00
manual.mk core: introduce the BR2_EXTERNAL variable 2013-12-08 22:38:13 +01:00
manual.txt docs/manual: add a 'Known issues' chapter 2013-10-06 20:34:40 +02:00
package-make-target.txt manual: remove package clean commands 2013-12-08 19:41:54 +01:00
patch-policy.txt Trivial documentation fix for Signed-off-by 2013-09-16 15:43:00 +02:00
prerequisite.txt docs/manual: Add version number to perl in prerequisites 2013-11-11 15:06:34 +01:00
rebuilding-packages.txt docs: update manual after Crosstool-NG backend removal 2013-10-06 20:53:58 +02:00
starting-up.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
using-buildroot-toolchain.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
using.txt manual: cleanup and update editor tags 2013-02-17 22:50:04 +01:00
working-with.txt working-with: board support 2013-02-28 22:37:49 +01:00
writing-rules.txt Add documentation for the header style 2013-06-16 21:40:18 +02:00