summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2016-09-01 14:16:52 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2016-09-23 15:27:32 +0100
commit4b8e7d8ccaa1a779ca651ed189ff7eb247743376 (patch)
treed9443f009d543dea33ee4562deeb40e292347b83 /documentation/ref-manual
parent2c38cc69bb806881f66e5a68e1f4daa21f98e896 (diff)
downloadpoky-4b8e7d8ccaa1a779ca651ed189ff7eb247743376.tar.gz
ref-manual: Updated the MLPREFIX variable description.
Fixes [YOCTO #10197] Provided better examples and a bit of a historical note. (From yocto-docs rev: 5845aadcc4e6932abde4ce7c74834c0f2a9fb806) 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.xml33
1 files changed, 33 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index f72bbd0e05..e34843512a 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -7931,6 +7931,39 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7931 <link linkend='var-BPN'><filename>BPN</filename></link> variable). 7931 <link linkend='var-BPN'><filename>BPN</filename></link> variable).
7932 <filename>MLPREFIX</filename> gets set when a prefix has been 7932 <filename>MLPREFIX</filename> gets set when a prefix has been
7933 added to <filename>PN</filename>. 7933 added to <filename>PN</filename>.
7934 <note>
7935 The "ML" in <filename>MLPREFIX</filename> stands for
7936 "MultiLib".
7937 This representation is historical and comes from
7938 a time when <filename>nativesdk</filename> was a suffix
7939 rather than a prefix on the recipe name.
7940 When <filename>nativesdk</filename> was turned into a
7941 prefix, it made sense to set
7942 <filename>MLPREFIX</filename> for it as well.
7943 </note>
7944 </para>
7945
7946 <para>
7947 To help understand when <filename>MLPREFIX</filename>
7948 might be needed, consider when
7949 <link linkend='var-BBCLASSEXTEND'><filename>BBCLASSEXTEND</filename></link>
7950 is used to provide a <filename>nativesdk</filename> version
7951 of a recipe in addition to the target version.
7952 If that recipe declares build-time dependencies on tasks in
7953 other recipes by using
7954 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>,
7955 then a dependency on "foo" will automatically get rewritten
7956 to a dependency on "nativesdk-foo".
7957 However, dependencies like the following will not get
7958 rewritten automatically:
7959 <literallayout class='monospaced'>
7960 do_foo[depends] += "<replaceable>recipe</replaceable>:do_foo"
7961 </literallayout>
7962 If you want such a dependency to also get transformed,
7963 you can do the following:
7964 <literallayout class='monospaced'>
7965 do_foo[depends] += "${MLPREFIX}<replaceable>recipe</replaceable>:do_foo"
7966 </literallayout>
7934 </para> 7967 </para>
7935 </glossdef> 7968 </glossdef>
7936 </glossentry> 7969 </glossentry>