NetCube-Systems-Austria/kumquat-buildroot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

manual: switch BR2_EXTERNAL examples to use absolute paths

Browse Source 
Although it is possible to use relative paths, there are a few pitfalls
when doing so.

To avoid confusion for a (newcoming) user, use absolute paths in the
manual (as is done in examples for $(O)), since it is guaranteed to be
working without corner cases.

[Peter: s/relatively/relative/ as suggested by Thomas]
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr>
Cc: Samuel Martin <s.martin49@gmail.com>
Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
This commit is contained in:
Yann E. MORIN 2014-02-21 23:17:53 +01:00 committed by Peter Korsgaard
parent 5f5e5f2919
commit 1de64ec8c0
1 changed files with 5 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
docs/manual/customize-outside-br.txt
View File

@ -30,18 +30,18 @@ there is no need to pass +BR2_EXTERNAL+ at every +make+ invocation. It
can however be changed at any time by passing a new value, and can be
removed by passing an empty value.
The +BR2_EXTERNAL+ path can be either an absolute or a relative path,
*Note:* the +BR2_EXTERNAL+ path can be either an absolute or a relative path,
but if it's passed as a relative path, it is important to note that it
is interpreted relatively to the main Buildroot source directory, not
is interpreted relative to the main Buildroot source directory, *not*
the Buildroot output directory.
Some examples:
-----
buildroot/ $ make BR2_EXTERNAL=../foobar menuconfig
buildroot/ $ make BR2_EXTERNAL=/path/to/foobar menuconfig
-----
Starting from now on, external definitions from the +../foobar+
Starting from now on, external definitions from the +/path/to/foobar+
directory will be used:
-----
@ -52,7 +52,7 @@ directory will be used:
We can switch to another external definitions directory at any time:
-----
buildroot/ $ make BR2_EXTERNAL=../barfoo xconfig
buildroot/ $ make BR2_EXTERNAL=/where/we/have/barfoo xconfig
-----
Or disable the usage of external definitions: