From patchwork Fri Jul 31 09:19:24 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 93992 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id AFF66C55167 for ; Fri, 31 Jul 2026 09:19:48 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.2853.1785489581204448327 for ; Fri, 31 Jul 2026 02:19:42 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=zKP48iiy; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id 8A8E94E41046 for ; Fri, 31 Jul 2026 09:19:39 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 60E236039A for ; Fri, 31 Jul 2026 09:19:39 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id D110E11C165EB; Fri, 31 Jul 2026 11:19:34 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1785489575; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=Y3lphF5WQRprPZR8UuSCjNVYOsBL+MMIPXDSWze3JhU=; b=zKP48iiyaGKjyuiMT7wfydAeNf7bLkuHZvKDc86HKEAeC3M56WU2yLXb3UV1vpJl8VCMgI VaaCJ+dCNiMJjre+qn3/lO1sXqWQgITjS1AuLrs05PsHa699O3Za8Bz2PuZIpPTiyTH8tU JoFVywIBRVJB/dthnBOMmQNIoFN8jGscG13Lgl/PJlHtaRlPoY9CK82SCpJUQxE4EJ8do2 NWxeLj96ma04eLkn18ut431BPuDJ5LbLHKTCqZv9rcGycLHmZ+dYIy2rJPbJzrUOmF6aiR yBgoFVtHmeKw+CQ7dtHIaUapMB1WB0Sbn7mmgSUzGx0FlT3mkdE8QQ+L5GtSDw== From: Antonin Godard Date: Fri, 31 Jul 2026 11:19:24 +0200 Subject: [PATCH v2 1/5] sdk-manual/appendix-customizing-standard.rst: use code block for bitbake assignment MIME-Version: 1.0 Message-Id: <20260731-sdk-clarifications-v2-1-b34f797492b1@bootlin.com> References: <20260731-sdk-clarifications-v2-0-b34f797492b1@bootlin.com> In-Reply-To: <20260731-sdk-clarifications-v2-0-b34f797492b1@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni X-Mailer: b4 0.15.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1372; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=tsA/aamya2qdjs78pwYMlZFo7UKJ73+ZilM/YjXv46k=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBqbGigBdUwGnpEGm1V2haP4eQRamWtqrkYWciDX 08vfJ2GVUmJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCamxooAAKCRDRgEFAKaOo NrkhD/9KYx8qeq83YFkRJQU46T43o/u+mvRN7pW6E0dcv236KV7SnMhkVvIrsvjfLPydVDWc9Jc I0NiKNNenK/uJqSw7dbmtY6ngfvxttivLYESK8QDENR5Dj7HIr5QSRG1rACk6nuL0CsTL6I9DVq PHB3SwclHPp302L5/SYQkBRqPaPjN+sh13SnUMhqIaDJzV9jspalVMSZ1TnlE1WYMepuZ2STYA7 68ws52KqzgvFWGx0abiqdx3Cqu2EjKr4nk2Abx925KgyxdjKDFMWkCZCouNVadSFYfiCl/oN0R0 X6ULVlTMELR08MFhy/SJqIhnUob2hqvxvcJFMzBgvVS1QaQh2Ts1L2gzjfNMLkgM0AY/DMlOXKH kGfCp/G7yv5cN4OS9f08AUyRBEnY467aIN0/Zez3MtEjhPKiZWOTO6pkd2zMO1zfJTR94rOESXp YAV1rkGRxDM+q91Yz72O9SZ5bD4AHcbYiUp8BTJAyirXXQv0tJNbaf9HBZlPYz/GEOi9UUkuDJU nQ1G3VVZoz11a/QeyPtAnzrXnueErxAVVx6k/R32bPXLtD41qADnEaXcyqwJy8t0w2S314IDF5N 6Ot18XVgGnVGDg+cIFvoDY06oOKH+rDPnZwf6rw/dtEESi7q4kQWRQ4ycJQW2AGLr04CEQx/pzH zp2H2N6ZI2q3Jvg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Fri, 31 Jul 2026 09:19:48 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10207 Use a code block for the DISTRO_FEATURES assignment instead of how it appears as regular text currently. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/sdk-manual/appendix-customizing-standard.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/documentation/sdk-manual/appendix-customizing-standard.rst b/documentation/sdk-manual/appendix-customizing-standard.rst index c619c15e4..90b73dc20 100644 --- a/documentation/sdk-manual/appendix-customizing-standard.rst +++ b/documentation/sdk-manual/appendix-customizing-standard.rst @@ -27,8 +27,9 @@ Adding API Documentation to the Standard SDK You can include API documentation as well as any other documentation provided by recipes with the standard SDK by adding "api-documentation" -to the -:term:`DISTRO_FEATURES` -variable: DISTRO_FEATURES:append = " api-documentation" Setting this -variable as shown here causes the OpenEmbedded build system to build the -documentation and then include it in the standard SDK. +to the :term:`DISTRO_FEATURES` variable:: + + DISTRO_FEATURES:append = " api-documentation" + +Setting this variable as shown here causes the OpenEmbedded build system to +build the documentation and then include it in the standard SDK. From patchwork Fri Jul 31 09:19:25 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 93991 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id C0AFAC54F54 for ; Fri, 31 Jul 2026 09:19:48 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.2855.1785489585729186223 for ; Fri, 31 Jul 2026 02:19:46 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=dfEZIjWW; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id 14C274E41046 for ; Fri, 31 Jul 2026 09:19:44 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id DED5B6039A for ; Fri, 31 Jul 2026 09:19:43 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 5031A11C165E5; Fri, 31 Jul 2026 11:19:39 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1785489579; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=xv39Y3Yaf3lAD11rzo3Y52HmAcIQH7TMg2c2SH1t150=; b=dfEZIjWWVJU9/0UUpcecxbOd0qbKfVpntOUF42wzlg1jzyYfuHQ8Wxhc1NxcIw+ZQCOk+Z Kn0ScwpLvKDtqeYueHRv1ODNl0zpvYxRpStjGZzCoRpE+ruCKsuHch5q6F1K1t5XC0yvSN 4utq7PrNF4DoNBugnBo/iXIUJJQJceNjD1sRRe87lC9L/KJhCaAO1vMBnDzSJBTz7sGOeS rg5BGDmDzk9OI8qIjMb7Ag3IGiUbjRMQlyx6xhMnyTTixiBfiNCGI9kD4JH11ATnfJnW94 ZC3QHMa4caszvx2Tn5dPu7QdYyTlHg5HUbck6JC+W2LsSYgUiafhAJrvffU9wg== From: Antonin Godard Date: Fri, 31 Jul 2026 11:19:25 +0200 Subject: [PATCH v2 2/5] sdk-manual/intro.rst: remove a confusing sentence MIME-Version: 1.0 Message-Id: <20260731-sdk-clarifications-v2-2-b34f797492b1@bootlin.com> References: <20260731-sdk-clarifications-v2-0-b34f797492b1@bootlin.com> In-Reply-To: <20260731-sdk-clarifications-v2-0-b34f797492b1@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni X-Mailer: b4 0.15.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1290; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=14cHM7DcJba46HHHxPCbo+hDr/Z4Iko8pxDMR8sWgb4=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBqbGigkdgzV/zw4uPNMBhR0npKMv3v4xKBttQkq vddsx77Z+eJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCamxooAAKCRDRgEFAKaOo NgRTD/9oEO6gksftNB+8Sxcwno6dJ2K0zPqP38EBcldqc4uNgyAqx8v2pOqHErZ1zDQAO/sunSD Vfx0f91jovG+nqW2LnrPrUanJPuJ8UYCDNcttDe8mXkNUa+0DsCdt6sHE1F3VMzTwb9kUFB/H7e j6tCE3jNqsRksMz7vInkiBIO119cWBCh88e2GElwX/hhNdjdzcGWxQquDc7BWupvNL0wQNXs0sE lFSv3hpSXEjDlPpwTjdY+E3fBnxRcl9smGVD6/ZMoQCNl8ce4MyDyF4GSRfGw2WusXbETEv1pCh 5/oYbl3aBib8ZGhfYaoPR8ZdrjRX3CXmv+AXz1xB2ZUSLiFqCOuQzeeBBMfatpXnRnCpb5vwbBs v2VhKwWZyqyEUC5dNRCwbvABqGy8Z4hq/IbXl0zj6Aoj4JA+CVeEI1RAWJtr/6kSVvIQO5pufkd W01dWCMjlNtORr18yCAVBLwZfTNsPQtJ5VbPhAt+TNnssX2eTkViqOfW8T6VNIjCruRDVuZasGA wlp6+svahGx7yjGBS9qkmG5zOpqTBH12sBtXUleVbHrcC6h6Je9NQGgQcfS0JXAyzUUwm7JNT3Y 08qFtT131XHOlGBHFrieW/IjJ7HMo54hSxc3KmAeYfgPtfAEGlhVrfucnqMpXwvATDuR80LoIQ+ 8aSWTX8ES1ZZ9Sw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Fri, 31 Jul 2026 09:19:48 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10208 I have a hard time understanding the meaning of this sentence at this point in the manual. populate_sdk and populate_sdk_ext are best known as tasks, so the meaning for them as "archives" is unclear. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/sdk-manual/intro.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/documentation/sdk-manual/intro.rst b/documentation/sdk-manual/intro.rst index dd2902cc4..3e78219fc 100644 --- a/documentation/sdk-manual/intro.rst +++ b/documentation/sdk-manual/intro.rst @@ -35,9 +35,7 @@ destined to run on some target machine. SDKs are completely self-contained. The binaries are linked against their own copy of ``libc``, which results in no dependencies on the target system. To achieve this, the pointer to the dynamic loader is configured at install -time since that path cannot be dynamically altered. This is the reason -for a wrapper around the ``populate_sdk`` and ``populate_sdk_ext`` -archives. +time since that path cannot be dynamically altered. Another feature of the SDKs is that only one set of cross-compiler toolchain binaries are produced for any given architecture. This feature From patchwork Fri Jul 31 09:19:26 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 93993 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id D3D71C54F54 for ; Fri, 31 Jul 2026 09:19:58 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.2768.1785489590517658533 for ; Fri, 31 Jul 2026 02:19:50 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=NVBYLhjA; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id D1F574E41046 for ; Fri, 31 Jul 2026 09:19:48 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id A73E66039A for ; Fri, 31 Jul 2026 09:19:48 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id CE5E511C165F0; Fri, 31 Jul 2026 11:19:43 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1785489583; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=939gnGI4atLQyC2LDSUVECDkEVZTz7018SqVEPFGyik=; b=NVBYLhjAUsgbnpQeNaitybusbAeKgnvMtNhM/tkoEceRyRN8ornr4mCkwIn/cNK4J0pqdG Hk+NRu0L8ogcUzy7KGoFq/yQUzyYyfihe+D746/SY3ew7bZuPOuY6Lztuza5j70NJdxbHn N39OeljnQE3Pw4ZxAT9iAPkxua6lMJfDiLy1sAaGZQjG7UQ0y7Yn9FQihHbZ58taMzrPN/ nvHF0SHefmm+QjarVEoGoqpgnynL+CZVJ9NqIaY6rv1XiXITWHWEmNxwlwA6BlHvHBlla2 4pCw++Slc12rDpr2gt6AyXLpcRRpBj0F6xACTNAT56/yzN5DaisY1/YMCqKtww== From: Antonin Godard Date: Fri, 31 Jul 2026 11:19:26 +0200 Subject: [PATCH v2 3/5] sdk-manual/intro.rst: link to sysroot term MIME-Version: 1.0 Message-Id: <20260731-sdk-clarifications-v2-3-b34f797492b1@bootlin.com> References: <20260731-sdk-clarifications-v2-0-b34f797492b1@bootlin.com> In-Reply-To: <20260731-sdk-clarifications-v2-0-b34f797492b1@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni X-Mailer: b4 0.15.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1438; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=A2/kinPAH6S0ZFgEdtAVxUyXE+SE8RZJxizs9e4LqJ4=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBqbGihMReLkNqulgtiR6IqlaqcHtJs3oznCyl8H uZIxQYcqyCJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCamxooQAKCRDRgEFAKaOo Nj9LEACGlI6LK0+hLFkqn/75QZQyWwMFTwL/iHIC4JvsVKbU5sbkANkC6TA7t8gfRrAOK6LmzFw Iy4aqkYTJCPjTmoh5HNzBXhv97Xwzfh/pzVLV4J01XuOtYbPpecKAjq5oLySA25IOF8shdJZXH2 lKl6HLZElk7Z7yag89Eia10A2hsWXsU59PiNrfi3PSu+GvRc26Ck3puFEayiHVq5ZsQrpFlrgQ2 b7lQchFhIDzO2v2YZsstX5Vm7yuHJvDcP0TvOaVDEvZeyZTvJooKu9e56lmSVamPH1Oq/ppWWxY yvR+F0tk7hPKa0ParPAKvj6qmp67EJCDddCvyYsMHAituKGKjHA8/ntW8BeHzhjgKh6OXhg5scs oUHP1uZESyv4qtj1ajRMMCWY1/QLqGEWWZvGDQj1zQwsyXe+GZOoOMvZ9jb6rG+aTEAlrNlTrbp RZhM23VZ58SxUpACetE1veNaV0e/QeN9DkKZ3hl+CVmrlc9TAL+p3mZUgb0de7arYFSjREG43bh TdnjMRlQFw+ajK1YlWEgYnvPGBmxQ0TSAWBJY0ioiopjdWJ23Utn3sstEnKxdbUi0kYDgU+XMGN VtFf1Nl1irqWIeGEhI7btau4QKsACffZ8i8NDoUx5VZ2rCW+MCJUF9xxFf05WxfPFdlkTL64t0F JY6u1fYfXkaxpmw== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Fri, 31 Jul 2026 09:19:58 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10209 Link to the definition of a sysroot (from our glossary) when it is first introduced and later in the "Sysroots" section. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/sdk-manual/intro.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/sdk-manual/intro.rst b/documentation/sdk-manual/intro.rst index 3e78219fc..53246bd9a 100644 --- a/documentation/sdk-manual/intro.rst +++ b/documentation/sdk-manual/intro.rst @@ -45,7 +45,7 @@ environment script and contained in variables such as :term:`CC` and :term:`LD`. This reduces the space needed for the tools. Understand, however, that every target still needs its own -sysroot because those binaries are target-specific. +:term:`sysroot` because those binaries are target-specific. The SDK development environment consists of the following: @@ -117,7 +117,7 @@ cross-toolchain works with a matching target sysroot. Sysroots -------- -The native and target sysroots contain needed headers and libraries for +The native and target :term:`sysroots ` contain needed headers and libraries for generating binaries that run on the target architecture. The target sysroot is based on the target root filesystem image that is built by the OpenEmbedded build system and uses the same metadata configuration From patchwork Fri Jul 31 09:19:27 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 93994 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id CEA93C55167 for ; Fri, 31 Jul 2026 09:19:58 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.2770.1785489595003890293 for ; Fri, 31 Jul 2026 02:19:55 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=kg2pmFtv; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id 586AC4E41046 for ; Fri, 31 Jul 2026 09:19:53 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 285056039A for ; Fri, 31 Jul 2026 09:19:53 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 9A22211C165F5; Fri, 31 Jul 2026 11:19:48 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1785489588; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=tN6HG7M0Tu2AUjLbCF55BL5UUY7Oj93ybcXI+JXjPms=; b=kg2pmFtvXAsLTT2KS0/0VziXy/N0EeH3EA77Rw1Cpj0FcZXCElAJPxejB/IrnFSXnqTV4k Fq+XWHltdrvlsBTSGzAXUzVXz4hStNtolLbOwkj0x1/zoNI8OXcBlePY7Oy4GDWH4mgaR1 H8MeNlCfiJGWTL6tKA5EoHVvls5CXFnx9XlioQpaqZr/OHG3qKrDe2hGJ1kuPC4nWdDaGZ N1VofOPXio6qStgSAYR919O0n0vpW6Fzsd41TjG7NXvm8hO2RSbo3+PSgp/irYylk2oEVp 9PZYssFttXQbWKp+16gDN5lS+qjgXPhebUdFLBGxDe7HwB+FYiCwWJbQqShS0Q== From: Antonin Godard Date: Fri, 31 Jul 2026 11:19:27 +0200 Subject: [PATCH v2 4/5] sdk-manual: rename the section to remove "extensible" MIME-Version: 1.0 Message-Id: <20260731-sdk-clarifications-v2-4-b34f797492b1@bootlin.com> References: <20260731-sdk-clarifications-v2-0-b34f797492b1@bootlin.com> In-Reply-To: <20260731-sdk-clarifications-v2-0-b34f797492b1@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni X-Mailer: b4 0.15.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=2709; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=HHFCi3rgV3g01U5LPlZ2q5kduOEb/MrAnaEsEqvHeao=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBqbGihiatAPJytNd90JUiXTPn0SanvBu/0fXsnp HH2x/5uKymJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCamxooQAKCRDRgEFAKaOo NvQ2D/92lIoRrDMdsOLEkM32kdeCIG1piuw40C+Y/mTJo5h8yDn1Mk4md5VAzULp10M0m+zRk1g 0kwbpMn8uip8/B/whh+lsIg7felXr6kTpo3yUvWY75a1QqtuW62hQ3pPP5T0nweTSZfO2kWW2Lh am5Zj5JKhpIs40WROaLSAgufl1Z74sy0+v0Jx8mrMU+v6anz/mNH4xwDM8yMKUDrAYNHYxBYTC9 xcCmsh0F9jnD3PojzQtMAgCeMG46jtYOKyo7+qWaK29xlPyiYRvb13rcVQBJsPd6XoMST1Z6N2i X3yZwtw4VNKdVodFmLlJwAm4pwaJ5i+Z9yaBK6DMQ4i4a9GSKsNQDxZFhtipwtUBHpdz4dY5MIf 1X370RW3Me+UO1AoCuWhtuslUmfwAukTLKrMhL1Ul2n+23FG7cW/Sm/flIyOfSsZmFzX0uF1J6a a9j7QNbVJqAhGbgdSyGxfIrmIfJHPR1JLThI69haE+Tccfj3+Rfe/nUmHyE+w1yu3HzryiNmuKn 3hzbYFimvPn2+SrTCb4KeCXbqZ1wbuuV0jCajdmocfutLXf9+HsiRuNI/AN9GSMecn00EaVvMEy f3HgzS9xXypFpRs4v5+u/Xx1hCrp8JT6YK5KvcNwGisByqpG/fHfgjlQhl/AzCMVLIrpbbOBdbF tmTU/elZK2wIiiA== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Fri, 31 Jul 2026 09:19:58 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10210 The SDK manual covers both the standard and extensible SDKs yet the title does not imply that, so rename the section to "Yocto Project Application Development and the Software Development Kit (SDK) Manual". As a consequence, rename the first section title and reword the intro. Signed-off-by: Antonin Godard --- documentation/index.rst | 2 +- documentation/sdk-manual/index.rst | 6 +++--- documentation/sdk-manual/intro.rst | 8 ++++---- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/documentation/index.rst b/documentation/index.rst index afabb6615..24a6802a4 100644 --- a/documentation/index.rst +++ b/documentation/index.rst @@ -67,7 +67,7 @@ infrastructure. Linux Kernel Development Manual Security Manual Profile and Tracing Manual - Application Development and the Extensible SDK (eSDK) + Application Development and SDKs Manual Toaster Manual Test Environment Manual BitBake User Manual diff --git a/documentation/sdk-manual/index.rst b/documentation/sdk-manual/index.rst index dc7186b91..a5c35caba 100644 --- a/documentation/sdk-manual/index.rst +++ b/documentation/sdk-manual/index.rst @@ -1,8 +1,8 @@ .. SPDX-License-Identifier: CC-BY-SA-2.0-UK -======================================================================================== -Yocto Project Application Development and the Extensible Software Development Kit (eSDK) -======================================================================================== +===================================================================================== +Yocto Project Application Development and Software Development Kits (SDK/eSDK) Manual +===================================================================================== | diff --git a/documentation/sdk-manual/intro.rst b/documentation/sdk-manual/intro.rst index 53246bd9a..b78248d54 100644 --- a/documentation/sdk-manual/intro.rst +++ b/documentation/sdk-manual/intro.rst @@ -4,11 +4,11 @@ Introduction ************ -eSDK Introduction -================= +SDK/eSDK Introduction +===================== -Welcome to the Yocto Project Application Development and the Extensible -Software Development Kit (eSDK) manual. This manual +Welcome to the Yocto Project Application Development and +Software Development Kits (SDK/eSDK) manual. This manual explains how to use both the Yocto Project extensible and standard SDKs to develop applications and images. From patchwork Fri Jul 31 09:19:28 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 93995 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id CB854C54F54 for ; Fri, 31 Jul 2026 09:20:08 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.2772.1785489600159640741 for ; Fri, 31 Jul 2026 02:20:00 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=LzPhN9Em; spf=pass (domain: bootlin.com, ip: 185.246.84.56, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 5A3B61A134B for ; Fri, 31 Jul 2026 09:19:58 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 301A36039A for ; Fri, 31 Jul 2026 09:19:58 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 2166011C165EF; Fri, 31 Jul 2026 11:19:53 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1785489593; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=jEYPR4SjwCGZELpS5EFQH+oDehq/pdILuzfbTH82jqw=; b=LzPhN9EmV2MCpPN/J8bBXpXkMCdyumsVYP3HoB380m5w7n7735tS3I/piUuZWexmRusqCe OOv+IKvxTVPgymct70mrScSFCuOt5L07oDrUvdzaCrfKiF/OvM/2egf25VeLcMN4ovRRHY tJ7p4HTXz5iel1fdaBzSo2ILOUYHwYQlVQGTQKgn2ewx31fbkETpFTY8qttmVlQx5EhqE/ RiACBSNon9sS2m0SaEF+r8UETuA2lDENK4g+3W/3yp8x3e0z6eA11JEC11WGTST9FtaIFQ J28rKdeJn52wltMbChkCrE0ELHkWsTU1pyHqETdH45avt/NisPZ8Fz/6xzQ9hA== From: Antonin Godard Date: Fri, 31 Jul 2026 11:19:28 +0200 Subject: [PATCH v2 5/5] sdk-manual/intro.rst: detail differences between standard and extensible sysroots MIME-Version: 1.0 Message-Id: <20260731-sdk-clarifications-v2-5-b34f797492b1@bootlin.com> References: <20260731-sdk-clarifications-v2-0-b34f797492b1@bootlin.com> In-Reply-To: <20260731-sdk-clarifications-v2-0-b34f797492b1@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni X-Mailer: b4 0.15.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1723; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=iwG4qSAeq4CxgC/K1ZCE+C1IZfmFdnZF+gDrXHrAWQ8=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBqbGihcR8kelf4Dv7JXkUj93SiCAy5GNH46piq7 UE6FLMTqv2JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCamxooQAKCRDRgEFAKaOo NmlmD/4sHdBijkjo/36k+X83yxoLR3YFoMPVl4Um1xdgitYuXpN5SD+cJ+fPqRoRJv/uOfhTANH o07gilgqfcwCkCjVWZlNIKsFRxJS7obs7UPOnL7yBIWqDP0M0Dm8XaEwgrsnJ7atOuWJU92bEym ytuc6p0fKEZ1+5RHt5lAdL/fth6PmNtKH/J3XYFge9GJ2lhsdK+o9I+3/7StXIVJWIe/bHh+93A fi2Q6RANJ4kn84dg0LWKj/URWkAq43IBY7p5zqHyqwsn8Sbl9dKC+2nWduf1GtU7ygzLl3MMfj7 /cKOPy/KWlM/3uOQLnZYh8g9rFnCjJpx1AU4FpBss5tVsqL3vovR5Rq0c8Ue1R600yf57Z5psBX mZDvkWdBKCF31jaNrqpWt3RYGOw9+FjNI0i6J/ckspCJQ9e1uAxG6CTdYiiLuJSpA9TANxqyPj/ b9xpjYXlIIpyZWZRQDQUOOVlAzE582Nu4jJZzKePgxLhsB2qZFKk06vTDoO1UaAN+yMgRRdF/ke KROOK26yMtUzYIqr30LJDh/dsSvftjofc7IWd6gew7fb6haqUkh5XlkhxukNb/EVnsW6XEOv7rA ylKvrtmGQReio10o92h9NELk05KxmbWFsm36jxy/4it8FebO6ED9+Xc8EM4ubGNj8QWb3wDjMuc MK1++Lz4hnjuI6Q== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Fri, 31 Jul 2026 09:20:08 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10211 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 --- documentation/sdk-manual/intro.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/documentation/sdk-manual/intro.rst b/documentation/sdk-manual/intro.rst index b78248d54..c8fa8d619 100644 --- a/documentation/sdk-manual/intro.rst +++ b/documentation/sdk-manual/intro.rst @@ -123,6 +123,25 @@ 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 :term:`sysroots ` differ in content: + +- The standard SDK :term:`sysroot` only contains libraries and headers for the packages + --- and their dependencies --- found in the :term:`TOOLCHAIN_TARGET_TASK` + and :term:`TOOLCHAIN_HOST_TASK` definitions, for the target and host + :term:`sysroots ` respectively. + + See :doc:`/sdk-manual/appendix-obtain` to learn how to build it and + :doc:`/sdk-manual/appendix-customizing-standard` to learn how to customize + it. + +- The extensible SDK :term:`sysroot` is completely managed by the :doc:`devtool + ` command-line tool, and its content is the + same as the :term:`sysroot` of the image recipe for which the SDK was built. + + See :doc:`/sdk-manual/appendix-obtain` to learn how to build it and + :doc:`/sdk-manual/appendix-customizing` to learn how to customize + it. + The QEMU Emulator -----------------