From 69bc220db8d1199a4c4a1905b2d2664467cce94d Mon Sep 17 00:00:00 2001 From: Adam Blank Date: Fri, 10 Apr 2026 14:17:47 +0200 Subject: [PATCH] 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 Signed-off-by: Antonin Godard (cherry picked from commit eeb22235d5310ed440692914851df0b7aac056a4) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker --- documentation/ref-manual/variables.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 94052a66d3..a83dd54d6b 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -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.