sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

dev-manual: Updates to the "Using .bbappend Files" section. 

This section was a bit confusing on the use of "_prepend" as associated
with the FILESEXTRAPATHS statement.  Especially in the final note
where it indicated you don't need "_prepend" if your append file
is not adding any new files.  I updated the note to be more specific.

Another small change I made was to replace the Crown Bay BSP referenced
in the section with the Emenlow BSP, which has a longer life span than
CB.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 35bdc8031bc4ecf1ea321b0cafade97eeaa56513)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2015-01-16 12:24:21 -08:00 committed by Richard Purdie
parent 1e0797adfe
commit c037dd7b4c
1 changed files with 9 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
documentation/dev-manual/dev-manual-common-tasks.xml
View File

@ -567,8 +567,8 @@
<para>
Following is the append file, which is named
<filename>formfactor_0.0.bbappend</filename> and is from the
Crown Bay BSP Layer named
<filename>meta-intel/meta-crownbay</filename>.
Emenlow BSP Layer named
<filename>meta-intel/meta-emenlow</filename>.
The file is in <filename>recipes-bsp/formfactor</filename>:
<literallayout class='monospaced'>
FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:"
@ -594,7 +594,7 @@
which resolves to a directory named
<filename>formfactor</filename> in the same directory
in which the append file resides (i.e.
<filename>meta-intel/meta-crownbay/recipes-bsp/formfactor/formfactor</filename>.
<filename>meta-intel/meta-emenlow/recipes-bsp/formfactor/formfactor</filename>.
This implies that you must have the supporting directory
structure set up that will contain any files or patches you
will be including from the layer.
@ -611,16 +611,18 @@
BitBake automatically defines the
<filename>THISDIR</filename> variable.
You should never set this variable yourself.
Using "_prepend" ensures your path will
be searched prior to other paths in the final list.
Using "_prepend" as part of the
<filename>FILESEXTRAPATHS</filename> ensures your path
will be searched prior to other paths in the final
list.
</para>
<para>
Also, not all append files add extra files.
Many append files simply exist to add build options
(e.g. <filename>systemd</filename>).
For these cases, it is not necessary to use the
"_prepend" part of the statement.
For these cases, your append file would not even
use the <filename>FILESEXTRAPATHS</filename> statement.
</para>
</note>
</para>