summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2015-01-16 12:24:21 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2015-02-17 15:16:49 +0000
commitc037dd7b4c7d4398aa7524351f33c61a19091e89 (patch)
tree5c7dab01af0c27cd8a8c87b557c0e04ddf9df288
parent1e0797adfe4d47d0b712c942bcb795d4c7d19bfa (diff)
downloadpoky-c037dd7b4c7d4398aa7524351f33c61a19091e89.tar.gz
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>
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml16
1 files changed, 9 insertions, 7 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 1458b18bfd..33b4038834 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -567,8 +567,8 @@
567 <para> 567 <para>
568 Following is the append file, which is named 568 Following is the append file, which is named
569 <filename>formfactor_0.0.bbappend</filename> and is from the 569 <filename>formfactor_0.0.bbappend</filename> and is from the
570 Crown Bay BSP Layer named 570 Emenlow BSP Layer named
571 <filename>meta-intel/meta-crownbay</filename>. 571 <filename>meta-intel/meta-emenlow</filename>.
572 The file is in <filename>recipes-bsp/formfactor</filename>: 572 The file is in <filename>recipes-bsp/formfactor</filename>:
573 <literallayout class='monospaced'> 573 <literallayout class='monospaced'>
574 FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:" 574 FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:"
@@ -594,7 +594,7 @@
594 which resolves to a directory named 594 which resolves to a directory named
595 <filename>formfactor</filename> in the same directory 595 <filename>formfactor</filename> in the same directory
596 in which the append file resides (i.e. 596 in which the append file resides (i.e.
597 <filename>meta-intel/meta-crownbay/recipes-bsp/formfactor/formfactor</filename>. 597 <filename>meta-intel/meta-emenlow/recipes-bsp/formfactor/formfactor</filename>.
598 This implies that you must have the supporting directory 598 This implies that you must have the supporting directory
599 structure set up that will contain any files or patches you 599 structure set up that will contain any files or patches you
600 will be including from the layer. 600 will be including from the layer.
@@ -611,16 +611,18 @@
611 BitBake automatically defines the 611 BitBake automatically defines the
612 <filename>THISDIR</filename> variable. 612 <filename>THISDIR</filename> variable.
613 You should never set this variable yourself. 613 You should never set this variable yourself.
614 Using "_prepend" ensures your path will 614 Using "_prepend" as part of the
615 be searched prior to other paths in the final list. 615 <filename>FILESEXTRAPATHS</filename> ensures your path
616 will be searched prior to other paths in the final
617 list.
616 </para> 618 </para>
617 619
618 <para> 620 <para>
619 Also, not all append files add extra files. 621 Also, not all append files add extra files.
620 Many append files simply exist to add build options 622 Many append files simply exist to add build options
621 (e.g. <filename>systemd</filename>). 623 (e.g. <filename>systemd</filename>).
622 For these cases, it is not necessary to use the 624 For these cases, your append file would not even
623 "_prepend" part of the statement. 625 use the <filename>FILESEXTRAPATHS</filename> statement.
624 </para> 626 </para>
625 </note> 627 </note>
626 </para> 628 </para>