ref-manual/variables.rst: update RECIPE_SYSROOT* descriptions

Slightly reword to emphasise the order of steps during staging.
Further clarify those variables' relation to STAGING_DIR* variables.

(From yocto-docs rev: 4b219d437a5674aa71b6b2544d1548987202203f)

Signed-off-by: Adam Blank <adam.blank.g@gmail.com>
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
(cherry picked from commit eeb22235d5310ed440692914851df0b7aac056a4)
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Paul Barker <paul@pbarker.dev>
This commit is contained in:
Adam Blank
2026-04-10 14:17:47 +02:00
committed by Paul Barker
parent c81390249b
commit 69bc220db8

View File

@@ -7433,13 +7433,13 @@ system and gives an overview of their function and contents.
section.
:term:`RECIPE_SYSROOT`
This variable points to the directory that holds all files populated from
This variable points to the directory populated with all files provided by
recipes specified in :term:`DEPENDS`. As the name indicates,
think of this variable as a custom root (``/``) for the recipe that will be
think of this variable as a custom root (``/``) for the recipe, that will be
used by the compiler in order to find headers and other files needed to complete
its job.
This variable is related to :term:`STAGING_DIR_HOST` or :term:`STAGING_DIR_TARGET`
This variable is used to define :term:`STAGING_DIR_HOST` or :term:`STAGING_DIR_TARGET`
according to the type of the recipe and the build target.
To better understand this variable, consider the following examples:
@@ -7453,11 +7453,11 @@ system and gives an overview of their function and contents.
Do not modify it.
:term:`RECIPE_SYSROOT_NATIVE`
This is similar to :term:`RECIPE_SYSROOT` but the populated files are from
``-native`` recipes. This allows a recipe built for the target machine to
use ``native`` tools.
This is similar to :term:`RECIPE_SYSROOT` but files in it are provided by
native recipes. This allows a recipe built for the target machine to
use native tools.
This variable is related to :term:`STAGING_DIR_NATIVE`.
This variable is used to define :term:`STAGING_DIR_NATIVE`.
The default value is ``"${WORKDIR}/recipe-sysroot-native"``.
Do not modify it.