sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

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>
This commit is contained in:
Scott Rifenbark 2016-10-03 12:25:56 -07:00 committed by Richard Purdie
parent aaeb1ee90b
commit 8312ba80fa
1 changed files with 39 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

60
documentation/ref-manual/ref-variables.xml
View File

@ -12715,6 +12715,39 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
for the build host, the value is empty given the for the build host, the value is empty given the
assumption that when building for the build host, assumption that when building for the build host,
the build host's own directories should be used. 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> </para></listitem>
<listitem><para>For native SDK <listitem><para>For native SDK
recipes that build for the 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>}". "${STAGING_DIR}/${<link linkend='var-MULTIMACH_HOST_SYS'>MULTIMACH_HOST_SYS</link>}".
</para></listitem> </para></listitem>
</itemizedlist> </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> </para>
</glossdef> </glossdef>
</glossentry> </glossentry>