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

dev-manual: Edits to "Using .bbappend Files" 

I re-wrote this to more clearly describe use.

(From yocto-docs rev: c3d6eecd38c6d4c8b4e0b4e134cbd53ae3fd2aee)

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 2013-04-17 12:51:56 -07:00 committed by Richard Purdie
parent a3d2886a47
commit 6a3f129958
1 changed files with 35 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -395,7 +395,7 @@
LICENSE = "MIT" LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://${COREBASE}/LICENSE;md5=3f40d7994397109285ec7b81fdeb3b58 \ LIC_FILES_CHKSUM = "file://${COREBASE}/LICENSE;md5=3f40d7994397109285ec7b81fdeb3b58 \
file://${COREBASE}/meta/COPYING.MIT;md5=3da9cfbcb788c80a0384361b4de20420" file://${COREBASE}/meta/COPYING.MIT;md5=3da9cfbcb788c80a0384361b4de20420"
PR = "r20" PR = "r21"
SRC_URI = "file://config file://machconfig" SRC_URI = "file://config file://machconfig"
S = "${WORKDIR}" S = "${WORKDIR}"
@ -410,9 +410,15 @@
if [ -s "${S}/machconfig" ]; then if [ -s "${S}/machconfig" ]; then
install -m 0644 ${S}/machconfig ${D}${sysconfdir}/formfactor/ install -m 0644 ${S}/machconfig ${D}${sysconfdir}/formfactor/
fi fi
} } </literallayout>
</literallayout> In the main recipe, note the
Here is the append file, which is named <ulink url='&YOCTO_DOCS_REF_URL;#var-SRC_URI'><filename>SRC_URI</filename></ulink>
variable, which tells the OpenEmbedded build system where to
find files during the build.
</para>
<para>
Following is the append file, which is named
<filename>formfactor_0.0.bbappend</filename> and is from the <filename>formfactor_0.0.bbappend</filename> and is from the
Crown Bay BSP Layer named Crown Bay BSP Layer named
<filename>meta-intel/meta-crownbay</filename>. <filename>meta-intel/meta-crownbay</filename>.
@ -422,21 +428,33 @@
PRINC := "${@int(PRINC) + 2}" PRINC := "${@int(PRINC) + 2}"
</literallayout> </literallayout>
This example adds or overrides files in </para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-SRC_URI'><filename>SRC_URI</filename></ulink>
within a <filename>.bbappend</filename> by extending the path <para>
BitBake uses to search for files. By default, the build system uses the
The most reliable way to do this is by prepending the <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESPATH'><filename>FILESPATH</filename></ulink>
variable to locate files.
This append file extends the locations by setting the
<ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'><filename>FILESEXTRAPATHS</filename></ulink> <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'><filename>FILESEXTRAPATHS</filename></ulink>
variable. variable.
For example, if you have your files in a directory that is named Setting this variable in the <filename>.bbappend</filename>
the same as your package file is the most reliable and recommended method for adding
(<ulink url='&YOCTO_DOCS_REF_URL;#var-PN'><filename>PN</filename></ulink>), directories to the search path used by the build system
you can add this directory by adding the following to your to find files.
<filename>.bbappend</filename> file: </para>
<literallayout class='monospaced'>
FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:" <para>
</literallayout> The statement in this example extends the directories to include
<filename>${THISDIR}/${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PN'><filename>PN</filename></ulink><filename>}</filename>,
which resolves to the same directory in which the append file
resides (i.e.
<filename>meta-intel/meta-crownbay/recipes-bsp/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.
</para>
<para>
Using the immediate expansion assignment operator Using the immediate expansion assignment operator
<filename>:=</filename> is important because of the reference to <filename>:=</filename> is important because of the reference to
<filename>THISDIR</filename>. <filename>THISDIR</filename>.