summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
Diffstat (limited to 'documentation')
-rw-r--r--documentation/ref-manual/ref-variables.xml33
1 files changed, 18 insertions, 15 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 7fbc508f53..9783f71952 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -13618,11 +13618,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
13618 <para role="glossdeffirst"> 13618 <para role="glossdeffirst">
13619<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> 13619<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
13620 Specifies the path to the sysroot directory for the system 13620 Specifies the path to the sysroot directory for the system
13621 that the component is built to run on (the system that hosts 13621 on which the component is built to run (the system that
13622 the component). 13622 hosts the component).
13623 For most recipes, this sysroot is the one that the recipe's 13623 For most recipes, this sysroot is the one in which that
13624 recipe's
13624 <link linkend='ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></link> 13625 <link linkend='ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></link>
13625 task copies files into. 13626 task copies files.
13626 Exceptions include <filename>-native</filename> recipes, 13627 Exceptions include <filename>-native</filename> recipes,
13627 where the <filename>do_populate_sysroot</filename> task 13628 where the <filename>do_populate_sysroot</filename> task
13628 instead uses 13629 instead uses
@@ -13631,17 +13632,19 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
13631 <filename>STAGING_DIR_HOST</filename> can have the 13632 <filename>STAGING_DIR_HOST</filename> can have the
13632 following values: 13633 following values:
13633 <itemizedlist> 13634 <itemizedlist>
13634 <listitem><para>For recipes building for the target 13635 <listitem><para>
13635 machine, the value is 13636 For recipes building for the target machine, the
13637 value is
13636 "${<link linkend='var-STAGING_DIR'>STAGING_DIR</link>}/${<link linkend='var-MACHINE'>MACHINE</link>}". 13638 "${<link linkend='var-STAGING_DIR'>STAGING_DIR</link>}/${<link linkend='var-MACHINE'>MACHINE</link>}".
13637 </para></listitem> 13639 </para></listitem>
13638 <listitem><para>For native recipes building 13640 <listitem><para>
13639 for the build host, the value is empty given the 13641 For native recipes building for the build host, the
13640 assumption that when building for the build host, 13642 value is empty given the assumption that when
13641 the build host's own directories should be used. 13643 building for the build host, the build host's own
13642 <note><para> 13644 directories should be used.
13643 <filename>-native</filename> recipes are not 13645 <note>
13644 installed into host paths like such as 13646 <para><filename>-native</filename> recipes are
13647 not installed into host paths like such as
13645 <filename>/usr</filename>. 13648 <filename>/usr</filename>.
13646 Rather, these recipes are installed into 13649 Rather, these recipes are installed into
13647 <filename>STAGING_DIR_NATIVE</filename>. 13650 <filename>STAGING_DIR_NATIVE</filename>.
@@ -13657,7 +13660,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
13657 example, GCC's <filename>-isystem</filename> 13660 example, GCC's <filename>-isystem</filename>
13658 option.</para> 13661 option.</para>
13659 13662
13660 <para>This emphasizes that the 13663 <para>Thus, the emphasis is that the
13661 <filename>STAGING_DIR*</filename> variables 13664 <filename>STAGING_DIR*</filename> variables
13662 should be viewed as input variables by tasks 13665 should be viewed as input variables by tasks
13663 such as 13666 such as
@@ -13671,7 +13674,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
13671 <filename>-native</filename> recipes, as 13674 <filename>-native</filename> recipes, as
13672 they make use of host headers and libraries. 13675 they make use of host headers and libraries.
13673 </para> 13676 </para>
13674 </note> 13677 </note>
13675 </para></listitem> 13678 </para></listitem>
13676 </itemizedlist> 13679 </itemizedlist>
13677 </para> 13680 </para>