[PATCH 5/5] sdk-manual/intro.rst: detail differences between standard and extensible sysroots

Antonin Godard <[email protected]> Wed, 29 Jul 2026 12:02:28 +0200
Newsgroups org.yoctoproject.lists.docs
Message-ID <[email protected]>
The sysroot in the standard and the extensible SDKs are managed
differently. Detail this in the Sysroots section.

[YOCTO #14830]

Signed-off-by: Antonin Godard <[email protected]>
---
 documentation/sdk-manual/intro.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/documentation/sdk-manual/intro.rst b/documentation/sdk-manual/intro.rst
index 8ccbcfa20..2e5f73f0b 100644
--- a/documentation/sdk-manual/intro.rst
+++ b/documentation/sdk-manual/intro.rst
@@ -123,6 +123,21 @@ sysroot is based on the target root filesystem image that is built by
 the OpenEmbedded build system and uses the same metadata configuration
 used to build the cross-toolchain.
 
+However, the extensible and standard SDKs sysroot differ in content:
+
+-  The standard SDK sysroot only contains libraries and headers for the packages
+   found in the :term:`TOOLCHAIN_TARGET_TASK` and :term:`TOOLCHAIN_HOST_TASK`
+   definitions, for the target and native sysroots respectively.
+
+   See :doc:`/sdk-manual/appendix-customizing-standard` to learn how to
+   customize it.
+
+-  The extensible SDK sysroot is completely managed by the ``devtool``
+   command-line tool, and its content is the same as the sysroot of the image
+   recipe for which the SDK was built.
+
+   See :doc:`/sdk-manual/appendix-customizing` to learn how to customize it.
+
 The QEMU Emulator
 -----------------
 

-- 
2.55.0