diff options
author | Joshua Lock <josh@linux.intel.com> | 2010-06-08 17:53:25 +0100 |
---|---|---|
committer | Joshua Lock <josh@linux.intel.com> | 2010-06-08 17:53:25 +0100 |
commit | fcd220b4fd254f45305fb65512e53d0371dc466c (patch) | |
tree | f78e4e8ff10debe8a5651c32b1348fe57e76f691 | |
parent | 49df0b84fa434e7eb40dc8c4942d6df1495c4892 (diff) | |
download | openembedded-core-fcd220b4fd254f45305fb65512e53d0371dc466c.tar.gz openembedded-core-fcd220b4fd254f45305fb65512e53d0371dc466c.tar.bz2 openembedded-core-fcd220b4fd254f45305fb65512e53d0371dc466c.zip |
handbook: document the LAYERDIR variable
LAYERDIR is one of the few variables which requires immediate expansion and is
worth documenting explicitly.
Signed-off-by: Joshua Lock <josh@linux.intel.com>
-rw-r--r-- | handbook/extendpoky.xml | 9 | ||||
-rw-r--r-- | handbook/ref-variables.xml | 9 |
2 files changed, 16 insertions, 2 deletions
diff --git a/handbook/extendpoky.xml b/handbook/extendpoky.xml index b437c77fa3..936a74480e 100644 --- a/handbook/extendpoky.xml +++ b/handbook/extendpoky.xml @@ -582,12 +582,17 @@ require conf/distro/include/poky-extras-src-revisions.inc As can be seen, the layers recipes are added to BBFILES. The BBFILE_COLLECTIONS variable is then appended to with the layer name. The BBFILE_PATTERN variable is immediately expanded - with a regular expression used to match files from BBFILES into a - particular layer, in this case by using the base pathname. + with a regular expression used to match files from BBFILES into + a particular layer, in this case by using the base pathname. The BBFILE_PRIORITY variable then assigns different priorities to the files in different layers. This is useful in situations where the same package might appear in multiple layers and allows you to choose which layer should 'win'. + Note the use of LAYERDIR with the immediate expansion operator. + LAYERDIR expands to the directory of the current layer and + requires use of the immediate expansion operator so that Bitbake + does not lazily expand the variable when it's parsing a + different directory. </para> <para> diff --git a/handbook/ref-variables.xml b/handbook/ref-variables.xml index 7bbcdb81f0..e4523bfdc1 100644 --- a/handbook/ref-variables.xml +++ b/handbook/ref-variables.xml @@ -403,6 +403,15 @@ <glossdiv id='var-glossary-l'><title>L</title> + <glossentry id='var-LAYERDIR'><glossterm>LAYERDIR</glossterm> + <glossdef> + <para>When used inside a layer.conf gives the path of the + current layer. This variable requires immediate expansion + (see the Bitbake manual) as lazy expansion can result in + the expansion happening in the wrong directory and therefore + giving the wrong value.</para> + </glossdef> + </glossentry> <glossentry id='var-LICENSE'><glossterm>LICENSE</glossterm> <glossdef> <para>List of package source licenses.</para> |