From patchwork Wed Jul 29 10:02: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: 93855 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 1DB4EC54FCD for ; Wed, 29 Jul 2026 10:02:52 +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.7962.1785319363457498445 for ; Wed, 29 Jul 2026 03:02:44 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=P9L7ksxK; 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 C2E494E40FD9 for ; Wed, 29 Jul 2026 10:02:41 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 989376039A for ; Wed, 29 Jul 2026 10:02:41 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id C724911C14BD9; Wed, 29 Jul 2026 12:02:36 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1785319357; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=QDtpdLHTh52W+9g2/AWNoVmmecANC89AKjXILMlqFmA=; b=P9L7ksxKZj0vQ8RUmCFllsSOc+hobZyncC1oRwJBXJxdzHlt/oHMiLfC8Dp8N2E7yrXzZR q0p5Orqcgf5A8cFuW87444I9jfHZQCSJrR1ycqFezHuA4WpAhmJpfjyNERyoS1d5KWK41f GISntHLAFUTnX8gTOW4Qj7idWBDkSe+CDpEspeCPa32cCL8/6g4qqhxcW2xgo7GsT3sfMT 1XV4d3EoiW24/TVZBDhz+m4Xtg/SQ7MfZuBkgGhNZCHFLg+cN4gtD71vYCjc14p92GX4aT +KxsB2Oqoy/wVYMDMuKrOeRyu6GgZ62tjgjx52NUgjCnR/ORdTIGBdYeM+o0yQ== From: Antonin Godard Date: Wed, 29 Jul 2026 12:02:24 +0200 Subject: [PATCH 1/5] sdk-manual/appendix-customizing-standard.rst: use code block for bitbake assignment MIME-Version: 1.0 Message-Id: <20260729-sdk-clarifications-v1-1-661e65201bc7@bootlin.com> References: <20260729-sdk-clarifications-v1-0-661e65201bc7@bootlin.com> In-Reply-To: <20260729-sdk-clarifications-v1-0-661e65201bc7@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1316; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=2EKq4AqLt9dzEWSjFE3TeoULEdp5ju9U1AxmRg0rHDM=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBqac+2Aso8p3FcDUWDmQlfIUu6U3+zNXPqO58ZR iNcOgQXh5eJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCamnPtgAKCRDRgEFAKaOo NjotD/sF3DbO9lt4hc9bOZizgwwTOfgAFU/OFy+UJxNerXENU5fO83OOqbkO2dsE8s3Te1bVzSz 7LpmC6fRjHuqJ/mqTcK1UyyPRMIiBfljZW+owMupz515VYzK4iovIutXkqsSpddBRz6aPQnxVmH U2f+af32m4A43oIynBTlmNRhvJivn8Ju3/fmDQM94KRV+ntrHSBveV0wDYDpcE4Zk+hMwYLZlEu Xeuia9j1Nes775W48SrmQLNtBmqTHGVKt2MtdzGPs2VA29M+2KefgOFBiYRRZ71xJDW9a+e3hxK nUhJZIc6yar/PE/ITy4d75KPxIOBVLwjqPYYN7herVsQzLBiMACUJ50JNxv4LRrwoFt2rJSi+cY KTBu1D7DdI3hIxVPtsft1pzD++XithKwX54vPGUyKcVzFP8IjAMGvsRtuDD7RaebSr4XAuFVnJQ SLrVPdcVopGEfXG+8etpk5S0dyhsLyyN3QRSkAjE1o1NFBOqIr7M3kC2CaOuZ23jKSeAEPFykNN /JHfVW4rlYypqCHatFz02Sqi4k0FfFp3PkRO14TDV0ebrbTZJZK8e4zakB2HBL6t6sZSE+hGslV YfywdaufqviW+IubpjIipA9q0V/JFgkMZeq70ZSJ2Tg34JhWhgyH/xxa3LLbuAcOe5iLO8Xrnr7 9wAP53I0DuSfpbg== 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 ; Wed, 29 Jul 2026 10:02:52 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10186 Use a code block for the DISTRO_FEATURES assignment instead of how it appears as regular text currently. 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 Wed Jul 29 10:02: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: 93856 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 3C2FCC54FD2 for ; Wed, 29 Jul 2026 10:02:52 +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.7963.1785319367985236719 for ; Wed, 29 Jul 2026 03:02:48 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=XVxBbcQY; 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 523644E40FD9 for ; Wed, 29 Jul 2026 10:02:46 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 274956039A for ; Wed, 29 Jul 2026 10:02:46 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 7969211C14BD3; Wed, 29 Jul 2026 12:02:41 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1785319361; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=fXNh1uUTBK6c6961EihAjv4fV9QPdsm4X7XIaiateYg=; b=XVxBbcQYUGEPelAYNNVwYkaJ6FgLGHhKBEY7xnEg0qjInxdVJK0KP7BF5OwlS21RzBlMKt c/VWQ7teylRgBW2du9ChfTKPtK5eLbMy5hUImYbq55ltfHNZo4sxs3G3jTPG4TC5OFklFu aS64pX+Wi9h/EGxEBkzgs62q3iI3QjJXx2WI+GPqNBKv6CuTg+i7lnoU5OhSMfqVT4C/HM Y39q8hkneYr3p5Oe1LUT1T3Nxwg6IaPfsPZ4podeuK4FJcu37Er84xfTeGSNojeCD+wFUs +va6mG3knyaAOy3T9PAt+bff403T3JLW8n2nPgnS9XJDIVuXdHygDT50GcyOmw== From: Antonin Godard Date: Wed, 29 Jul 2026 12:02:25 +0200 Subject: [PATCH 2/5] sdk-manual/intro.rst: remove a confusing sentence MIME-Version: 1.0 Message-Id: <20260729-sdk-clarifications-v1-2-661e65201bc7@bootlin.com> References: <20260729-sdk-clarifications-v1-0-661e65201bc7@bootlin.com> In-Reply-To: <20260729-sdk-clarifications-v1-0-661e65201bc7@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1234; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=XaDpeAdD7L2LQsJD1K9k0FdZK3dLnh2mB4LW5TOaaaw=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBqac+2cHiOQQGvUV/zdb6Yn5Ef4MXRshDEbGoUU Vz1mJQEaHiJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCamnPtgAKCRDRgEFAKaOo Nt5tD/9CF7tamCCKGBa0h1o+04SQbJDBfpMosZ69iwRYqR23NSit/5cwVRIegzvYRV073tPKbuP rQeBjyD822imToS4kW6ZZ8sn9fYl2d+fcdhq2mnUDIJ9wDgLcEn3GzETquZdWD2eAbV8gqDznXT LhYx4soxL2DQh4WTxTOH+3OFhhgwyE3AnF797k8JnfwoufGTY/bsSvAo9VfTBtSS2iCyQsjXgXW RyHHT5CcBASJwP01US8cT1mSFeVOhhLpmgCvxt9+mbDftRv/Rn+742fXc5IMvbZBjBPD7axDdrv g1kOo0nlOeYwDBsdVgyw4j57nu7PQIQO9Q0BmizmT8ae2MsxLpIx8uSf+5amJV/D4Z6R7dyCzkb /imrB2qN1cvEdX410C1QS8Vf0yaf0ncHbLTs2yzPlTNoyTZyuHeCS5C7JzoywObUXYghJva1Hey 7PjIofziduMGxAjXDfHh1d2COBHuw+9sCuv006RrFg7sER7V9b6TPjY9k1iaEzR1wpY7zO85qjr fk7O2aRX/aSqn4NTfuZW+m1z9qhuNfGmWBs8+fhb63BQ9zplTCEba+6O+SYSoZFB+t2/dOKowL3 zXxbgF3Q/DHiwmL1gCUPp9rvP3iiZhLpHK7iCwwJMzNZWW9x5b25Ffm9r9Xmgbfpco3E93rbKte pW62LxuOK/Ax/1Q== 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 ; Wed, 29 Jul 2026 10:02:52 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10187 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. 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 Wed Jul 29 10:02: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: 93854 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 C4C8EC54F52 for ; Wed, 29 Jul 2026 10:02:50 +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.8049.1785319368666502683 for ; Wed, 29 Jul 2026 03:02:48 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=sRXgbyb2; 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 F3C884E40FDB for ; Wed, 29 Jul 2026 10:02:46 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id CA7596039A for ; Wed, 29 Jul 2026 10:02:46 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 08A1611C14BDA; Wed, 29 Jul 2026 12:02:45 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1785319366; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=vGuXV59lWzV6p6J0AziOVh5A8KbDeSiOim+M4pWEKos=; b=sRXgbyb2Cm4XFuK2o+SUIfI9E+5pzsoKfPMMi25hPZaHj/wPysLhPIb7aYftJZV7oLceru oyR5Tkof2Okg35bDGxM14cGOInf++Qg0X7I2+9PsGoGjFPnuOHs96Si5zEKV3x6ZwT6Cw3 yFk3VY28XcabAMaQ56Az5iufT424VfYqwot5iAsMAetgdbxlEpnT4bSyBJJlTJqDvDp+/Q 382x0/gSf1eLwegYccJTfGnDUfm5MVb1jFXRlSSV1ZoDW5WqE3YoWW7e0ACWU4tbM9pGjn w87Y32S3A8vGhXfS/63ZjlohSwvZ/yJ6KHOv9axl2Lb2WESHFdDOxLeVHONTJw== From: Antonin Godard Date: Wed, 29 Jul 2026 12:02:26 +0200 Subject: [PATCH 3/5] sdk-manual/intro.rst: link to sysroot term MIME-Version: 1.0 Message-Id: <20260729-sdk-clarifications-v1-3-661e65201bc7@bootlin.com> References: <20260729-sdk-clarifications-v1-0-661e65201bc7@bootlin.com> In-Reply-To: <20260729-sdk-clarifications-v1-0-661e65201bc7@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1382; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=8++KtHnHNtvLeYQ2/fGK2AHgMqb2ahUeRUoqLHwvdGk=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBqac+3ivxadIaVyhV4G997BK3Rx5tcSxmuOOH1p kM/DMEee1uJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCamnPtwAKCRDRgEFAKaOo NqSyEACrbWV5TwSsWmiEN6kMGuZsDIjFF9EXu6wemf+GKnCQ7hDkBztssXHk3Z5bXMGqYFq3QX5 D8ij0o7CxcMY9VKznmkDwIh1y5TP5gepUVbIZjQaV4HfhOs5auaaM3ikESYFvqKp45hnQ5fEtt8 pfzvenyrzPYeblcwtHj10Dj0cHuI7FlkEijDvwEHdTHuwVPhCI//hB/QTAYA7YHDJzkq3IbxWnL vHpzx1H6Ft0Q+mim6vnEXzF1dcGAxbnbpRuScKuaEce0MFsqxdNIWgLssyrDSO7LI5uxXSsUo82 opo4kk5vQzXSTcTyZUU7KSDjAVYL3utv0EQyTSdSxSEsp2j1WvsFFlvx59R2LME2KPgPSxiJT7X +uHYpdnAD1DqUg7bdNTAFbSkWl12VmgrRhmi6c7SDCy006CdmYCVVVg+KeC1d3naYZpJFMg1Oik m7F01+fQUeuiBXGoZYbDrVUyZfF8/kLuGfqe3GlXFz9+jiCv6IUoKvCeWgGeUgvhbTutDkVexxT 5zAp6guN0irhubwzchf0xbWW+jz/b+O9Ub4H/uHF16X9QVKi/oMzJOScDu87oFeEF+6YDm5d21Q WFK0hdh1/m5o8Wr6thQ/jPDOQRP+MgnMc2LSnao0ENkAqKTO6aV/X/2e6hcMs8Tq2SugU92Jm76 e6lXEYf7l6RzFuQ== 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 ; Wed, 29 Jul 2026 10:02:50 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10188 Link to the definition of a sysroot (from our glossary) when it is first introduced and later in the "Sysroots" section. 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 Wed Jul 29 10:02: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: 93858 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 11CFAC54F51 for ; Wed, 29 Jul 2026 10:02:52 +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.7964.1785319370042709885 for ; Wed, 29 Jul 2026 03:02:50 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=Kn3JRgql; 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 5F02B4E40FDC for ; Wed, 29 Jul 2026 10:02:48 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 34FE16039A for ; Wed, 29 Jul 2026 10:02:48 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id A59A611C14BDD; Wed, 29 Jul 2026 12:02:46 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1785319367; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=iJnBtd5Mj+/mQc5x4s3kCxmguRnWXcbeU2qtGQq2fdk=; b=Kn3JRgql5l+gvO9jCCnmO+/21z2Mnq0VamqelYi3KWTpI7qRPRW7FP8YlXR0mmo0V0+wRS neOZ7RryJzQ+iUZIPJ/8qm/wEuQnx2WC5i3eaIPD/ZYM9r1ZxM4aM0NoV4+K6lne/5StBl xdiGhIGJBdhzrIjI12kfXBoC/fPStPfxHFwjuPI5YlzwRc5IpFdEIRGyIxsQDHvgjliukF 0XT+RWHmUlcP2Xt+urvM39e45ZSBwPqa5n+7CM/A4veOO/qwDlVZKlpuHCdr7poTPDrcf0 ATTUTHxbqAWjiNemRw5cjVrj7l9MBWAUvRLS+bAT04423y2lqbNdeCNNqK+JvA== From: Antonin Godard Date: Wed, 29 Jul 2026 12:02:27 +0200 Subject: [PATCH 4/5] sdk-manual: rename the section to remove "extensible" MIME-Version: 1.0 Message-Id: <20260729-sdk-clarifications-v1-4-661e65201bc7@bootlin.com> References: <20260729-sdk-clarifications-v1-0-661e65201bc7@bootlin.com> In-Reply-To: <20260729-sdk-clarifications-v1-0-661e65201bc7@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=2690; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=vTMNnQm93ELOyAe3uLJ4eJYq4CeNw8j06FnhIlkv/+k=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBqac+3B+PC8SC/LoEqFk5IlefthShQi9B4BrSyb nAiWwS8PjaJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCamnPtwAKCRDRgEFAKaOo NpqhD/9RmFNIdjMwFLVpWNQKlO+wBgsJtPexeeF4O8IYJPM8BE3NZUfqik6xwBYwy3z/Qf8KP2t IxC8+wqdK6mGett4DRxWcR0fouV2ni5MSu1hERplN/v0qj+uwJbrvYtR4jNwBcVVMFS5NxD8jXX gzwxbrtN8PSbVAcv1UxHft6es6BAQ6a2iHDqe9q3ZqZTaTmcWKiLe2RAJNIFrx/R7oJVx9lSba3 7j96bvDFl6SqzMriVZJnmuXCjS1Vl+UesO2XW03m7l8eMhIp6W1mpb0hQVCaSroi1OWqPL0dwHp v51XGzPTuvctz0EJ+Dmrf0k91UgVZ/DX+45ZqOE3RDEuXKhX4yPpVMKqcAt06IM8YuN8FvQMJWk B6ngsdNSBm19tjBDJ+iXrp06h0cwJlZhBVsu4vhV8C4GoTghuG7sIb1Zxd+gEffcGFlmbs3R9IM h+xO6I1MqRfAXSM7D2MyfwoMi4uJzi84HFpMK+ZD0sGkYXlRz736m4/EY+T1ckCaCsvpRcadABa 47SocONMyoPT00Ar4/711fdK0ySOXZTIaI8UeHKp/6rF2uH64WEgRYKyVbT42YpkvPNuUJk7UPE R6l/CF9xSQ98cpwkzzf2/Z1V6sEE51JgN9PKgaL1u0d6QCgfMb+YE77n2wye/UMwaAHtV5DzXep wtNM8re9WEDVv3A== 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 ; Wed, 29 Jul 2026 10:02:52 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10189 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..d8603c2f5 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 SDK 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..477274ab9 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 the Software Development Kit (SDK) Manual +=================================================================================== | diff --git a/documentation/sdk-manual/intro.rst b/documentation/sdk-manual/intro.rst index 53246bd9a..8ccbcfa20 100644 --- a/documentation/sdk-manual/intro.rst +++ b/documentation/sdk-manual/intro.rst @@ -4,11 +4,11 @@ Introduction ************ -eSDK Introduction -================= +SDK 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 the +Software Development Kit (SDK) manual. This manual explains how to use both the Yocto Project extensible and standard SDKs to develop applications and images. From patchwork Wed Jul 29 10:02: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: 93857 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 42A56C54FD1 for ; Wed, 29 Jul 2026 10:02:52 +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.7965.1785319370908253505 for ; Wed, 29 Jul 2026 03:02:51 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=aCzpKKKY; 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 40E724E40FD9 for ; Wed, 29 Jul 2026 10:02:49 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 169F36039A for ; Wed, 29 Jul 2026 10:02:49 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 130A411C14BD0; Wed, 29 Jul 2026 12:02:48 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1785319368; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=Y+0FJBjpcMdb7Vq2SWaki3pUzgNp82hQbteQor0dulE=; b=aCzpKKKYoXRI5WyZnkH5Qmomzt6vKPT0s6abyBneoGXe0WWR0ySnTRMW5Yoyl74xFlDIdH m+box+rhmdI2ghrLjAraxh7i3+Pj62xTOKP2cVZZ2qzOYdsbFTz/+E6ebcrpQ1l/egRrEC BXK+1cdlfw2MDUEZGGAc8r+tdwX7IGXJcCDCDqTtFEvR5Dg4Xbf0weYE8fYV8uhT8D7Wi6 TGpR1wqFzxP98ZiI61MfajJP+ykoZhMHEISEPTvPrvd5goomV3nU9B2FGXPbxtHUEjeEB6 9fy4xG/dgEqToqwm1Gj5SEpmi3C4v1yM7xghpbUNvq3ee+CvyxhngR+YPtd3rQ== From: Antonin Godard Date: Wed, 29 Jul 2026 12:02:28 +0200 Subject: [PATCH 5/5] sdk-manual/intro.rst: detail differences between standard and extensible sysroots MIME-Version: 1.0 Message-Id: <20260729-sdk-clarifications-v1-5-661e65201bc7@bootlin.com> References: <20260729-sdk-clarifications-v1-0-661e65201bc7@bootlin.com> In-Reply-To: <20260729-sdk-clarifications-v1-0-661e65201bc7@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1446; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=diKMm6iX7Oxm2IEAphWOKQ+osD8ynEaBF0UcAiLsRSE=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBqac+3KfkSQpEbnQgpvdnaPx85PYlFiAT6f2ST1 JbNUmddr9GJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCamnPtwAKCRDRgEFAKaOo NjDnD/4raDpkFav1SrwwIAxOTv3E3tUqC4zdLwwVAKbhbWUGNwm83BgSSN5iPR02BLdy7qqV8mQ 8KTNn9Ruv+VQN9xPq9MZSf+pEc2Wxp9jdNT69kW8yeBqLUD8Y7WbEDAyUtqq5u3oNMleq6h/8qZ h7w5IZupYFckSswkTcHK2wbsCm/Gcu4wilE/wCVQcPfJ6BWQsKO2bisnOiPi6T/Ri+10mu4xAi2 j2xu+5dqLwC+HQbGiD16gS/n7T98N9bkjVWkmDV4qJmgdrq/WweHNfjVMhcL2M/hNqIETFt8Yaf KWJbCkPOatO/1wa0fNuO9FIs/ueFiZRgZnu6Jlc8WTCeOdVRrFyjnOmBILBc4PdnU8oojKEfXNw KjNXv7m68+WFFYuj7cfKLSO0lo/Jm46OI9OpN/pQi6lP+jbD2k/qFO/4fM5QuEAkWz8HUjYCAw4 bPKkyalF15p4UdZyF+VYV81vi1Q2RPPlDluwnDoIrCQksvbUVhqSo45QzHh18KyMfgHtdSmupQQ M7c6sUyIiMp+WxTIAGcs7K+s9fw62H47Dlzyv1j+sGZ6Ikb0Jk5W6wbgNr6lz+AGFLC6EtRzuLi dO0x5DiT3GWG685qbKZGlvVDSrrTdvCfudhw70yGqkxA/NhmdNDnRMiXKFNJURY+u6YmbzzX+bT P675K7+ccioZb8A== 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 ; Wed, 29 Jul 2026 10:02:52 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10190 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 | 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 -----------------