ref-manual: Updated STAGING_DIR_TARGET and MULTIMACH* variables.
Fixes [YOCTO #9988] Updated the STAGING_DIR_TARGET variable with a better introductory sentence. Updated the MULTIMACH_TARGET_SYS variable with a more expanded explanation. Added a new glossary entry for the MULTIMACH_HOST_SYS variable. (From yocto-docs rev: d17873d695772b62325de35dd0e5b9ccc7f12f1a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
parent
05beac3ef0
commit
4396ffb3c9
|
@ -8035,6 +8035,31 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
|
||||||
</glossdef>
|
</glossdef>
|
||||||
</glossentry>
|
</glossentry>
|
||||||
|
|
||||||
|
<glossentry id='var-MULTIMACH_HOST_SYS'><glossterm>MULTIMACH_HOST_SYS</glossterm>
|
||||||
|
<info>
|
||||||
|
MULTIMACH_HOST_SYS[doc] = "Separates files for different machines such that you can build for multiple host machines using the same output directories."
|
||||||
|
</info>
|
||||||
|
<glossdef>
|
||||||
|
<para role="glossdeffirst">
|
||||||
|
<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
|
||||||
|
Serves the same purpose as
|
||||||
|
<link linkend='var-MULTIMACH_TARGET_SYS'><filename>MULTIMACH_TARGET_SYS</filename></link>,
|
||||||
|
but for the "HOST" system, in situations that involve a
|
||||||
|
"HOST" and a "TARGET" system.
|
||||||
|
See the
|
||||||
|
<link linkend='var-STAGING_DIR_TARGET'><filename>STAGING_DIR_TARGET</filename></link>
|
||||||
|
variable for more information.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
The default value of this variable is:
|
||||||
|
<literallayout class='monospaced'>
|
||||||
|
${PACKAGE_ARCH}${HOST_VENDOR}-${HOST_OS}
|
||||||
|
</literallayout>
|
||||||
|
</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
|
||||||
<glossentry id='var-MULTIMACH_TARGET_SYS'><glossterm>MULTIMACH_TARGET_SYS</glossterm>
|
<glossentry id='var-MULTIMACH_TARGET_SYS'><glossterm>MULTIMACH_TARGET_SYS</glossterm>
|
||||||
<info>
|
<info>
|
||||||
MULTIMACH_TARGET_SYS[doc] = "Separates files for different machines such that you can build for multiple target machines using the same output directories."
|
MULTIMACH_TARGET_SYS[doc] = "Separates files for different machines such that you can build for multiple target machines using the same output directories."
|
||||||
|
@ -8042,10 +8067,33 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
|
||||||
<glossdef>
|
<glossdef>
|
||||||
<para role="glossdeffirst">
|
<para role="glossdeffirst">
|
||||||
<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
|
<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
|
||||||
Separates files for different machines such that you can build
|
Uniquely identifies the type of the target system for
|
||||||
for multiple target machines using the same output directories.
|
which packages are being built.
|
||||||
See the <link linkend='var-STAMP'><filename>STAMP</filename></link> variable
|
This variable allows output for different types of target
|
||||||
for an example.
|
systems to be put into different subdirectories of the same
|
||||||
|
output directory.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
The default value of this variable is:
|
||||||
|
<literallayout class='monospaced'>
|
||||||
|
${PACKAGE_ARCH}${TARGET_VENDOR}-${TARGET_OS}
|
||||||
|
</literallayout>
|
||||||
|
Some classes (e.g.
|
||||||
|
<link linkend='ref-classes-cross-canadian'><filename>cross-canadian</filename></link>)
|
||||||
|
modify the <filename>MULTIMACH_TARGET_SYS</filename> value.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
See the
|
||||||
|
<link linkend='var-STAMP'><filename>STAMP</filename></link>
|
||||||
|
variable for an example.
|
||||||
|
<link linkend='var-MULTIMACH_HOST_SYS'><filename>MULTIMACH_HOST_SYS</filename></link>
|
||||||
|
is the corresponding variable for the host system in
|
||||||
|
situations that involve a "HOST" and a "TARGET" system.
|
||||||
|
See the
|
||||||
|
<link linkend='var-STAGING_DIR_TARGET'><filename>STAGING_DIR_TARGET</filename></link>
|
||||||
|
variable for more information.
|
||||||
</para>
|
</para>
|
||||||
</glossdef>
|
</glossdef>
|
||||||
</glossentry>
|
</glossentry>
|
||||||
|
@ -12320,14 +12368,16 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
|
||||||
|
|
||||||
<glossentry id='var-STAGING_DIR_TARGET'><glossterm>STAGING_DIR_TARGET</glossterm>
|
<glossentry id='var-STAGING_DIR_TARGET'><glossterm>STAGING_DIR_TARGET</glossterm>
|
||||||
<info>
|
<info>
|
||||||
STAGING_DIR_TARGET[doc] = "Specifies the path to the sysroot used for the "HOST" system."
|
STAGING_DIR_TARGET[doc] = "Specifies the path to the sysroot used for the system for which the component generates code."
|
||||||
</info>
|
</info>
|
||||||
<glossdef>
|
<glossdef>
|
||||||
<para role="glossdeffirst">
|
<para role="glossdeffirst">
|
||||||
<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
|
<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
|
||||||
Specifies the path to the sysroot used for the "HOST"
|
Specifies the path to the sysroot used for the system for
|
||||||
system.
|
which the component generates code.
|
||||||
In most cases, this path is the
|
For components that do not generate code, which is the
|
||||||
|
majority), <filename>STAGING_DIR_TARGET</filename> is set
|
||||||
|
to match
|
||||||
<link linkend='var-STAGING_DIR_HOST'><filename>STAGING_DIR_HOST</filename></link>.
|
<link linkend='var-STAGING_DIR_HOST'><filename>STAGING_DIR_HOST</filename></link>.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
|
@ -12344,9 +12394,6 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
|
||||||
to the sysroot used for the "HOST" system, while
|
to the sysroot used for the "HOST" system, while
|
||||||
<filename>STAGING_DIR_TARGET</filename>
|
<filename>STAGING_DIR_TARGET</filename>
|
||||||
points to the sysroot used for the "TARGET" system.
|
points to the sysroot used for the "TARGET" system.
|
||||||
For recipes where <filename>STAGING_DIR_TARGET</filename>
|
|
||||||
makes no sense, it is set to match
|
|
||||||
<filename>STAGING_DIR_HOST</filename>.
|
|
||||||
</para>
|
</para>
|
||||||
</glossdef>
|
</glossdef>
|
||||||
</glossentry>
|
</glossentry>
|
||||||
|
|
Loading…
Reference in New Issue