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>
This commit is contained in:
parent
49df0b84fa
commit
fcd220b4fd
|
@ -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
|
As can be seen, the layers recipes are added to BBFILES. The
|
||||||
BBFILE_COLLECTIONS variable is then appended to with the
|
BBFILE_COLLECTIONS variable is then appended to with the
|
||||||
layer name. The BBFILE_PATTERN variable is immediately expanded
|
layer name. The BBFILE_PATTERN variable is immediately expanded
|
||||||
with a regular expression used to match files from BBFILES into a
|
with a regular expression used to match files from BBFILES into
|
||||||
particular layer, in this case by using the base pathname.
|
a particular layer, in this case by using the base pathname.
|
||||||
The BBFILE_PRIORITY variable then assigns different
|
The BBFILE_PRIORITY variable then assigns different
|
||||||
priorities to the files in different layers. This is useful
|
priorities to the files in different layers. This is useful
|
||||||
in situations where the same package might appear in multiple
|
in situations where the same package might appear in multiple
|
||||||
layers and allows you to choose which layer should 'win'.
|
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>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
|
|
|
@ -403,6 +403,15 @@
|
||||||
|
|
||||||
<glossdiv id='var-glossary-l'><title>L</title>
|
<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>
|
<glossentry id='var-LICENSE'><glossterm>LICENSE</glossterm>
|
||||||
<glossdef>
|
<glossdef>
|
||||||
<para>List of package source licenses.</para>
|
<para>List of package source licenses.</para>
|
||||||
|
|
Loading…
Reference in New Issue