summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2016-07-12 14:10:13 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2016-07-19 15:04:51 +0100
commit640181cce81663b0a2055592382d127eac5d63ba (patch)
tree213332d2d8a871a48ecf8e636ccf22b46d6dde56 /documentation/ref-manual
parent48336f5139a6d6ff43cb371f7831817cecec0ae9 (diff)
downloadpoky-640181cce81663b0a2055592382d127eac5d63ba.tar.gz
ref-manual: Added clarifying note to the BBCLASSEXTEND variable.
Fixes [YOCTO #9909] Added a note that talks about how the BBCLASSEXTEND mechanism adds recipe variants. (From yocto-docs rev: a05990ecb760519a685a1c5ddcf2ce3e048bfbf2) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r--documentation/ref-manual/ref-variables.xml21
1 files changed, 21 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 3278ccc27e..b876bc3115 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -995,6 +995,27 @@
995 BBCLASSEXTEND =+ "native nativesdk" 995 BBCLASSEXTEND =+ "native nativesdk"
996 BBCLASSEXTEND =+ "multilib:<replaceable>multilib_name</replaceable>" 996 BBCLASSEXTEND =+ "multilib:<replaceable>multilib_name</replaceable>"
997 </literallayout> 997 </literallayout>
998 <note>
999 <para>
1000 Internally, the <filename>BBCLASSEXTEND</filename>
1001 mechanism generates recipe variants by rewriting
1002 variable values and applying overrides such as
1003 <filename>_class-native</filename>.
1004 For example, to generate a native version of a recipe
1005 named "foo", a
1006 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>
1007 on "foo" is rewritten to a <filename>DEPENDS</filename>
1008 on "foo-native".
1009 </para>
1010
1011 <para>
1012 No reparsing, which adds some limitations, of the
1013 recipe is done for each variant.
1014 For example, it is not possible to "include" a
1015 different file depending on the variant, since
1016 "include's" are processed when the recipe is parsed.
1017 </para>
1018 </note>
998 </para> 1019 </para>
999 </glossdef> 1020 </glossdef>
1000 </glossentry> 1021 </glossentry>