summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentation/ref-manual/ref-variables.xml33
1 files changed, 32 insertions, 1 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 6551ff6b90..753279cb5b 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -12696,9 +12696,13 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12696 Specifies the path to the sysroot directory for the system 12696 Specifies the path to the sysroot directory for the system
12697 that the component is built to run on (the system that hosts 12697 that the component is built to run on (the system that hosts
12698 the component). 12698 the component).
12699 This sysroot is the one that the recipe's 12699 For most recipes, this sysroot is the one that the recipe's
12700 <link linkend='ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></link> 12700 <link linkend='ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></link>
12701 task copies files into. 12701 task copies files into.
12702 Exceptions include <filename>-native</filename> recipes,
12703 where the <filename>do_populate_sysroot</filename> task
12704 instead uses
12705 <link linkend='var-STAGING_DIR_NATIVE'><filename>STAGING_DIR_NATIVE</filename></link>.
12702 Depending on the type of recipe and the build target, 12706 Depending on the type of recipe and the build target,
12703 <filename>STAGING_DIR_HOST</filename> can have the 12707 <filename>STAGING_DIR_HOST</filename> can have the
12704 following values: 12708 following values:
@@ -12718,6 +12722,33 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12718 "${STAGING_DIR}/${<link linkend='var-MULTIMACH_HOST_SYS'>MULTIMACH_HOST_SYS</link>}". 12722 "${STAGING_DIR}/${<link linkend='var-MULTIMACH_HOST_SYS'>MULTIMACH_HOST_SYS</link>}".
12719 </para></listitem> 12723 </para></listitem>
12720 </itemizedlist> 12724 </itemizedlist>
12725 <note><para>
12726 <filename>-native</filename> recipes are not installed
12727 into host paths like such as <filename>/usr</filename>.
12728 Rather, these recipes are installed into
12729 <filename>STAGING_DIR_NATIVE</filename>.
12730 When compiling <filename>-native</filename> recipes,
12731 standard build environment variables such as
12732 <link linkend='var-CPPFLAGS'><filename>CPPFLAGS</filename></link>
12733 and
12734 <link linkend='var-CFLAGS'><filename>CFLAGS</filename></link>
12735 are set up so that both host paths and
12736 <filename>STAGING_DIR_NATIVE</filename> are searched
12737 for libraries and headers using, for example,
12738 GCC's <filename>-isystem</filename> option.</para>
12739
12740 <para>This emphasizes that the
12741 <filename>STAGING_DIR*</filename> variables should be
12742 viewed as input variables by tasks such as
12743 <link linkend='ref-tasks-configure'><filename>do_configure</filename></link>,
12744 <link linkend='ref-tasks-compile'><filename>do_compile</filename></link>,
12745 and
12746 <link linkend='ref-tasks-install'><filename>do_install</filename></link>.
12747 Having the real system root correspond to
12748 <filename>STAGING_DIR_HOST</filename> makes conceptual
12749 sense for <filename>-native</filename> recipes, as
12750 they make use of host headers and libraries.</para>
12751 </note>
12721 </para> 12752 </para>
12722 </glossdef> 12753 </glossdef>
12723 </glossentry> 12754 </glossentry>