summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKristi Rifenbark <kristi.rifenbark@gmail.com>2017-12-18 15:21:24 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2017-12-22 22:23:06 +0000
commitc1e0242aaab3586fce2e9e679e5087500a3e9520 (patch)
treea4ee5f33491f6d7519e3978fac028909684ec2f9
parent52586b4102169cb6d6f5ffe4d3e7e79d3b220965 (diff)
downloadpoky-c1e0242aaab3586fce2e9e679e5087500a3e9520.tar.gz
ref-manual: Added BBFILES_DYNAMIC variable to glossary
FIXED [YOCTO #12089] (From yocto-docs rev: 0906e9080e1c150feab60bb9d095688d274a061e) Signed-off-by: Kristi Rifenbark <kristi.rifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/ref-manual/ref-variables.xml47
1 files changed, 47 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 631759d372..521eaeaed2 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -1142,6 +1142,53 @@
1142 </glossdef> 1142 </glossdef>
1143 </glossentry> 1143 </glossentry>
1144 1144
1145 <glossentry id='var-BBFILES_DYNAMIC'><glossterm>BBFILES_DYNAMIC</glossterm>
1146 <info>
1147 BBFILES_DYNAMIC[doc] = "Activates content when identified layers are present."
1148 </info>
1149 <glossdef>
1150 <para role="glossdeffirst">
1151<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
1152 Activates content when identified layers are present.
1153 You identify the layers by the collections that the layers
1154 define.
1155 </para>
1156
1157 <para>
1158 Use the <filename>BBFILES_DYNAMIC</filename> variable to
1159 avoid <filename>.bbappend</filename> files whose
1160 corresponding <filename>.bb</filename> file is in a layer
1161 that attempts to modify other layers through
1162 <filename>.bbappend</filename> but does not want to
1163 introduce a hard dependency on those other layers.
1164 </para>
1165
1166 <para>
1167 Use the following form for
1168 <filename>BBFILES_DYNAMIC</filename>:
1169 <literallayout class='monospaced'>
1170 <replaceable>collection_name</replaceable>:<replaceable>filename_pattern</replaceable>
1171 </literallayout>
1172 The following example identifies two collection names and
1173 two filename patterns:
1174 <literallayout class='monospaced'>
1175 BBFILES_DYNAMIC += " \
1176 clang-layer:${LAYERDIR}/bbappends/meta-clang/*/*/*.bbappend \
1177 core:${LAYERDIR}/bbappends/openembedded-core/meta/*/*/*.bbappend \
1178 "
1179 </literallayout>
1180 This next example shows an error message that occurs
1181 because invalid entries are found, which cause parsing to
1182 abort:
1183 <literallayout class='monospaced'>
1184 ERROR: BBFILES_DYNAMIC entries must be of the form &lt;collection name&gt;:&lt;filename pattern&gt;, not:
1185 /work/my-layer/bbappends/meta-security-isafw/*/*/*.bbappend
1186 /work/my-layer/bbappends/openembedded-core/meta/*/*/*.bbappend
1187 </literallayout>
1188 </para>
1189 </glossdef>
1190 </glossentry>
1191
1145 <glossentry id='var-BBINCLUDELOGS'><glossterm>BBINCLUDELOGS</glossterm> 1192 <glossentry id='var-BBINCLUDELOGS'><glossterm>BBINCLUDELOGS</glossterm>
1146 <info> 1193 <info>
1147 BBINCLUDELOGS[doc] = "Variable that controls how BitBake displays logs on build failure." 1194 BBINCLUDELOGS[doc] = "Variable that controls how BitBake displays logs on build failure."