diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2016-10-03 12:25:56 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2016-10-11 08:51:22 +0100 |
commit | 8312ba80fa37d8356fc7fc73e469ce1b7741ccea (patch) | |
tree | 1b0f7fd121865d0a8788b51b101cafc505f545a5 /documentation | |
parent | aaeb1ee90bdcbe3446bb25cebcc2e104ea93b20d (diff) | |
download | openembedded-core-contrib-8312ba80fa37d8356fc7fc73e469ce1b7741ccea.tar.gz |
ref-manual: Applied review changes to the STAGING_DIR_HOST
I basically moved the note from the bottome to a position
within the bulleted list.
Fixes [YOCTO #10348]
(From yocto-docs rev: a55dc7e0f8465abf8398f51d90bbe2df7e639b3f)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/ref-manual/ref-variables.xml | 72 |
1 files changed, 39 insertions, 33 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 753279cb5b..3e903327a2 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -12708,13 +12708,46 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" following values: <itemizedlist> <listitem><para>For recipes building for the target - machine, the value is - "${<link linkend='var-STAGING_DIR'>STAGING_DIR</link>}/${<link linkend='var-MACHINE'>MACHINE</link>}". - </para></listitem> + machine, the value is + "${<link linkend='var-STAGING_DIR'>STAGING_DIR</link>}/${<link linkend='var-MACHINE'>MACHINE</link>}". + </para></listitem> <listitem><para>For native recipes building - for the build host, the value is empty given the - assumption that when building for the build host, - the build host's own directories should be used. + for the build host, the value is empty given the + assumption that when building for the build host, + the build host's own directories should be used. + <note><para> + <filename>-native</filename> recipes are not + installed into host paths like such as + <filename>/usr</filename>. + Rather, these recipes are installed into + <filename>STAGING_DIR_NATIVE</filename>. + When compiling <filename>-native</filename> + recipes, standard build environment variables + such as + <link linkend='var-CPPFLAGS'><filename>CPPFLAGS</filename></link> + and + <link linkend='var-CFLAGS'><filename>CFLAGS</filename></link> + are set up so that both host paths and + <filename>STAGING_DIR_NATIVE</filename> are + searched for libraries and headers using, for + example, GCC's <filename>-isystem</filename> + option.</para> + + <para>This emphasizes that the + <filename>STAGING_DIR*</filename> variables + should be viewed as input variables by tasks + such as + <link linkend='ref-tasks-configure'><filename>do_configure</filename></link>, + <link linkend='ref-tasks-compile'><filename>do_compile</filename></link>, + and + <link linkend='ref-tasks-install'><filename>do_install</filename></link>. + Having the real system root correspond to + <filename>STAGING_DIR_HOST</filename> makes + conceptual sense for + <filename>-native</filename> recipes, as + they make use of host headers and libraries. + </para> + </note> </para></listitem> <listitem><para>For native SDK recipes that build for the SDK @@ -12722,33 +12755,6 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" "${STAGING_DIR}/${<link linkend='var-MULTIMACH_HOST_SYS'>MULTIMACH_HOST_SYS</link>}". </para></listitem> </itemizedlist> - <note><para> - <filename>-native</filename> recipes are not installed - into host paths like such as <filename>/usr</filename>. - Rather, these recipes are installed into - <filename>STAGING_DIR_NATIVE</filename>. - When compiling <filename>-native</filename> recipes, - standard build environment variables such as - <link linkend='var-CPPFLAGS'><filename>CPPFLAGS</filename></link> - and - <link linkend='var-CFLAGS'><filename>CFLAGS</filename></link> - are set up so that both host paths and - <filename>STAGING_DIR_NATIVE</filename> are searched - for libraries and headers using, for example, - GCC's <filename>-isystem</filename> option.</para> - - <para>This emphasizes that the - <filename>STAGING_DIR*</filename> variables should be - viewed as input variables by tasks such as - <link linkend='ref-tasks-configure'><filename>do_configure</filename></link>, - <link linkend='ref-tasks-compile'><filename>do_compile</filename></link>, - and - <link linkend='ref-tasks-install'><filename>do_install</filename></link>. - Having the real system root correspond to - <filename>STAGING_DIR_HOST</filename> makes conceptual - sense for <filename>-native</filename> recipes, as - they make use of host headers and libraries.</para> - </note> </para> </glossdef> </glossentry> |