From patchwork Thu Jan 29 15:22:52 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79980 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 2ECFED61022 for ; Thu, 29 Jan 2026 15:24:08 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17184.1769700246763857554 for ; Thu, 29 Jan 2026 07:24:07 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=aTjePA69; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id 993DFC22F47; Thu, 29 Jan 2026 15:24:07 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 80403606FD; Thu, 29 Jan 2026 15:24:04 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id C687B119A868D; Thu, 29 Jan 2026 16:24:03 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700244; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=wjl4d53mc6wCO/qGfxZ93rzrOZHOvIp3vm+zpMsjDDE=; b=aTjePA69fCKTEdr2KI+oEbUEP6cVrFmVjxUeFJA0oVzwGHH5DH3ytUB1qaFyK6WMSyCh1O lOE/HnYm6Ll8xq/XMsxSIbkv9ZK0KwBkBygVIcQnLDbMN7KjQ5BCxwywLMY1qpm5KQdqOK womRomISPBfmHlSxLYi/3W3MEuoaghequHpzDZ7qol7hFvzxkoR5/9JnTPSggVemlPhQjD ZAKaCTDP0j7CYBGAJr6AlvCnU6k4MebZnE7cVuMYaGJ+l1NxlSDQaxR5XUKicL3VFdNTqc IWMm07KFUtveLKBjvx4ge+OAuJFK1dfbyKEdaflooCs/P9b9g/xcEaMg2B5uSg== From: Antonin Godard Date: Thu, 29 Jan 2026 16:22:52 +0100 Subject: [PATCH v3 01/57] transitioning-to-a-custom-environment.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-1-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=3401; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=0F4IHnBzDvWpK8t8LkLBteRlMMQt3d8H4EbekxMvrKY=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uJ6tLEFTYtwXoLkDEYAEMNTICRg+rh9DiXk YD+BdBM0AeJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7iQAKCRDRgEFAKaOo Np2FD/4hlKWYY8XpPxthWiW838RM1h/kxuyLgMNq7KCeZCuSwBYQnRa/eaN8eVQoetMv6PXbTS5 1IhQSHzoiTp8nAl2bRaopizhB9h6rsTxhovQtjr6UBM3A/pOFjrpOUUZ35NqP1vPpB7yuzkvnDd f1E0BmFcRgJDYAoNFXEohSaT5lg3rkW4e72Zeyxm8l2Xe3ou9x/MtVfF+xrMffIzJ9x1HFoC6w/ 48ZyRLpn7Yn6iPBZc0iMKm5iQgfq0TZYiRo6EiakBO9giJCLaMySI3C0yaevF7brrUSc3cOO77l ptSCPt/IJ3yxCW+q6/noqZ05Q77hQbrcaL25wxn9XVOoCatfSpQD0cHJIGW80fFK0eYU+pHNotV P37d1ZQ9PONojH+1a1Zoj0Z+Ohrxy5fzlJ71zzOLuGVxBkIpZkNrQ+++dSURREwTSfLSMLY7jy6 WkwEaLJt8MerBIVEnTf3grBjsT1CskYgJv8uzrVIcEPCOszU4Wz/9KW44sdzm3bAbuImezU7p3E k/rZLhTX+HjLvso3FFd1UQnGw3HjJL7o7bbqiBVlVC9Wi66cAq+u8xgJFGtEUywevMsXEEtWGat a33fijmzQLTQWOXM07mihvnCYkHGCFUJ1kdysrx8krk6yDM1pNJG6RH3hFVnUnUzE7E1kPOQj1s FbQ8hgdPZx9PDNg== 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 ; Thu, 29 Jan 2026 15:24:08 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8786 - Use :term: for Poky. - Mention use of fragments instead of local.conf. - Remove Yocto < 2.4 reference. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- .../transitioning-to-a-custom-environment.rst | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/documentation/transitioning-to-a-custom-environment.rst b/documentation/transitioning-to-a-custom-environment.rst index a5f55c567..e292399f4 100644 --- a/documentation/transitioning-to-a-custom-environment.rst +++ b/documentation/transitioning-to-a-custom-environment.rst @@ -39,7 +39,7 @@ Transitioning to a custom environment for systems development that you've downloaded. Be aware that some BSPs may not be immediately supported on the very latest release, but they will be eventually. - You might want to start with the build specification that Poky provides + You might want to start with the build specification that :term:`Poky` provides (which is reference embedded distribution) and then add your newly chosen layers to that. Here is the information :ref:`about adding layers `. @@ -48,16 +48,14 @@ Transitioning to a custom environment for systems development configuration**. For instance, you've chosen a machine type and added in the corresponding BSP layer. You'll then need to change the value of the :term:`MACHINE` variable in your - configuration file (build/local.conf) to point to that same machine - type. There could be other layer-specific settings you need to change as - well. Each layer has a ``README`` document that you can look at for this type of - usage information. + configuration (using the :ref:`ref-fragments-builtin-core-machine` + fragment) to point to that same machine type. There could be other + layer-specific settings you need to change as well. Each layer has a + ``README`` document that you can look at for this type of usage information. #. **Add a new layer for any custom recipes and metadata you create**. - Use the ``bitbake-layers create-layer`` tool for Yocto Project 2.4+ - releases. If you are using a Yocto Project release earlier than 2.4, use the - ``yocto-layer create`` tool. The ``bitbake-layers`` tool also provides a number - of other useful layer-related commands. See + Use the ``bitbake-layers create-layer`` command. The ``bitbake-layers`` tool + also provides a number of other useful layer-related commands. See :ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script` section. @@ -99,7 +97,7 @@ Transitioning to a custom environment for systems development Distribution settings define the packaging back-end (e.g. rpm or other) as well as the package feed and possibly the update solution. You would create - your own distribution in a new layer inheriting from Poky but overriding what + your own distribution in a new layer inheriting from :term:`Poky` but overriding what needs to change for your distribution. If you find yourself adding a lot of configuration to your local.conf file aside from paths and other typical local settings, it's time to :ref:`consider creating your own distribution From patchwork Thu Jan 29 15:22:53 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79981 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 49525D61026 for ; Thu, 29 Jan 2026 15:24:08 +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.17084.1769700246846626626 for ; Thu, 29 Jan 2026 07:24:07 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=oOuOj1ev; 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 417204E42322; Thu, 29 Jan 2026 15:24:05 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 179B5606FD; Thu, 29 Jan 2026 15:24:05 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 66EE8119A8853; Thu, 29 Jan 2026 16:24:04 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700244; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=GwcAqsT3CCWattMGmOQVIEWGWB1ZE/tE+p7pfbtMkKY=; b=oOuOj1evZlmALeanv3dibv4DqHFRYgSq0/z6rlaDJuTpIJw/xy/MevCuzVUWLEmJ0mTZLT yhsqq5dJwx0pIMJlqwOll3Du9C+Tz/XZLUW672enbRx3ol4CONNg9nSDcpJ4d6RrM/lmW+ Yn+bYDPCPnPHUvnxmX7JGqe74+9wsBHxpSsM38k0L5h8gUar0Ve1VuDG6DIglU+C5bFvR3 k4rK2lrsllNk4miFR0web0pRpyoimsaxMrF8tFltb5m4Loy+8m5fXG7ka/Hvz3skL6bxcs B3napjGXqIFILcAv89wIMh0QG67mLmI87/8HRKHyKgjbyK+b0cPmUw6B6NSLgA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:22:53 +0100 Subject: [PATCH v3 02/57] dev-manual/poky-manual-setup.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-2-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2723; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=3JeE1CqZb1jfR3PeVpUqB3svHxZO0jjsVs41yTlWxRM=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uJSMzwjzjhZ0rr7zR9SzRjqW7/plt027BC9 raBJPCjjoGJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7iQAKCRDRgEFAKaOo Nm63EAC89V3B+WP717HABRXqUQX9E7sv8/+ikQ3ngVawM8oYWPGjI3DasDFIRnF2Hyt0nE429Mo 82K34tTds1SyfhdrlZl9DxVdFYiEJ+qyeJjUe0t6+p1T1+jAkPtzKXNBWZDyjfZ0z0E/Qg4HwU8 nJC9gEynVPWg46M6HuEjmbxD2he3bKN3rWvNsTnaq8z1DOJ9GgkKe5GZOoybigthqRi/HLVR25x 6uOp6WBYnbGvywGPzqIXY3lWcZ6BFOc/nPLz0lBbW5fXKFHMw3NWaRzv2BJ9wVwr7AHkCkTRBAs ym3D69LeSbO0VkHodzu4Q1RC59nxA/2ZXH7kBGeOHVYdcLAsZwFquB+S0MG2CzsqI3qVnRrzs9L 3u8XFjnthJ7N/KUIvcAW6T0uL8xVpLYL1uZJmlmgOocFJ+rM6ceLGr7hg+9yfMGS1eBidi+51Li esUuSG3rH+iZXD2c8TsIKiuS0mYezPv1nU4vzUsanTEunzagYvLRAIopanwv/OiQ52u6HfVlg/I JDLu7ZcKFePkw7RHKO/ixE8K/KXxt+FlOIZ+VpfcXkUNN71DLsM/wBan5fCsUG6kJdxeTBj14vG w/t73o6w1G2LcexonxVOJzMptuwMxYDPMC9/b5xDLVhNH1q+E5JxpEredgeMoa7CjM8JMUM1+hx wFeuSdVanPaaqgw== 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 ; Thu, 29 Jan 2026 15:24:08 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8788 The commit "dev-manual/start.rst: simplify the document after poky obsolescence" removed some of the information related to source archives published on downloads.yoctoproject.org. Mention it in this document as it makes sense to use those when manually setting up a Poky build. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/poky-manual-setup.rst | 29 +++++++++++++++++++++++++- 1 file changed, 28 insertions(+), 1 deletion(-) diff --git a/documentation/dev-manual/poky-manual-setup.rst b/documentation/dev-manual/poky-manual-setup.rst index 4bc9b97b6..2b1c3f63d 100644 --- a/documentation/dev-manual/poky-manual-setup.rst +++ b/documentation/dev-manual/poky-manual-setup.rst @@ -13,8 +13,17 @@ document guides through this setup step-by-step. :doc:`/brief-yoctoprojectqs/index`, which shows how to setup :term:`Poky` with ``bitbake-setup``. +Obtaining The Source Repositories +================================= + +You can obtain the source repositories required to build the Poky reference +distro in two ways described below: :ref:`cloning the repositories with Git +`, or +:ref:`downloading the released archives `. + Use Git to Clone The Layers -=========================== +--------------------------- Go to the :yocto_home:`Releases ` page, and choose a release (such as ``&DISTRO_REL_LATEST_TAG;``), corresponding to either the latest stable @@ -42,6 +51,24 @@ following commands: $ git clone -b &DISTRO_REL_LATEST_TAG; https://git.openembedded.org/openembedded-core ./layers/openembedded-core $ git clone -b &DISTRO_REL_LATEST_TAG; https://git.yoctoproject.org/meta-yocto ./layers/meta-yocto + +Using the Source Archives +------------------------- + +The Yocto Project also provides source archives of its releases, which +are available at :yocto_dl:`/releases/yocto/`. Then, choose the subdirectory +containing the release you wish to use, for example +:yocto_dl:`&DISTRO_REL_LATEST_TAG; `. + +You will find there source archives of :term:`OpenEmbedded-Core (OE-Core)`, +:term:`BitBake`, and :yocto_git:`meta-yocto `. + +.. note:: + + The recommended method for accessing Yocto Project components is to :ref:`use + Git to clone the upstream repository ` and work from within the locally cloned repositories. + Building Your Image =================== From patchwork Thu Jan 29 15:22:54 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79982 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 5843DD61028 for ; Thu, 29 Jan 2026 15:24:08 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17185.1769700247437962409 for ; Thu, 29 Jan 2026 07:24:07 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=mL3YSYfU; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id DA985C22F48; Thu, 29 Jan 2026 15:24:08 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id DADA7606FD; Thu, 29 Jan 2026 15:24:05 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 017E2119A8856; Thu, 29 Jan 2026 16:24:04 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700245; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=qhztzmMSSmDEfYP91g9lyBLwHEUb0kNBVvXBoC44vXI=; b=mL3YSYfUOy4f1Unu0ib9lDZW1F2AmnoWN2N0pv40cLypG0fFj/j5lnEfeekIVEnnOr88pF Igl5Yz+81LI3QACCkn96b5lx+iP9AqZC/Joca8tQbBuHOdc2K6nJrsR0KkN5Nc4uj337Dn xJeLmFtrW16HO8rxhti2DUjC5SjHLpRas4Cju2KfPxGtz/gXeeTEGziSTQb2Rs9rq78o18 LAlUqUuTFfVBkcqP16N7j/2CEWbQ5H781X9W0Y0YLiFwF/3CEGJNH38rpdnzWuukIvlrpI urYIf5V4Z05u/BoIVkBQAi58Uu88ZlXnudBRYO9quYcnrGBD6rhj5s6hZwFOVg== From: Antonin Godard Date: Thu, 29 Jan 2026 16:22:54 +0100 Subject: [PATCH v3 03/57] dev-manual/start.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-3-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=27070; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=h4tM0t5TnWgJxc3JRzxEgmxsDLpFvzlbFqnLgpMHDvc=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uJ5xiesIWDXD/ddUtYX7THWHafbfPfRPM0a hAE5+MqS0iJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7iQAKCRDRgEFAKaOo NsphD/0cqyvwIw8mTgQgvQ/fp8oITZTaRnIpVQbsct3KEymoychmNs+4PIcroZhhkk6TGVbqDmU DJ1qsonGgkaifxoc94ZOoWROenkEbJJjqOXahV4HeFXTEDF7yshfuc13OOD21EGs7psqSDf27s0 nEOEpRclWEeCVvSYoFrKtVypTbyd6+HRaBJ8w48i3l38tu0OVf4vbcin1scNej0faSWhSPjBy4X 2joXsNO8u41v77XLoVV9Nek2HN7O/Y4trEOTJhg/BrkZDB7idz+FhcYKamI+/qsEiZ+Ov/B79aG V5tJ08tsSHkXsi1QvtEmTFWafNF53fbXY2bmOSixYO2VoyY75hhL9nD6AJFw5aSyRHb6xsZjSAH gPp4K8pakkMSdeOzRB+ABuu2+OpD0Ni7amy59eIbE6zb7jlmfyTOH2OpMgFKqPATu7dEl44RKKj aX8giEAlF9HtxyRVLogbvEYUqwsHHtQUACGxUjTXtloL64vlkyIVgggvskvL9nyA7wcIRU7JLmI U+Ug1KLYTrQlx1rAzpv5VEpB+BKLLOwj3GBmZI43dFXb3c+0+yu67BIh1sop76EEqA7HMgMGajZ XosgbJdZ74u9jaKzwQwEmdC2xAOqKpcC2m3wtPOQROoe3RWTKXlYnruF/Mnx/Yip4APVG45oB0k wsKa/XLOXODc+Vw== 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 ; Thu, 29 Jan 2026 15:24:08 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8789 The Poky repository has stopped being updated in favor of bitbake-setup or manual clones of the required repositories. Simplify the document by making references to these guides as well as removing sections that are covered in the references documents. Keep a "Initializing the Build Environment" as this task is common and referenced in different places in the documentation. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/bsp-guide/bsp.rst | 7 +- documentation/dev-manual/start.rst | 324 +++------------------ documentation/kernel-dev/common.rst | 36 +-- .../overview-manual/development-environment.rst | 21 +- documentation/ref-manual/structure.rst | 5 - documentation/sdk-manual/appendix-obtain.rst | 27 +- 6 files changed, 49 insertions(+), 371 deletions(-) diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst index a6444d9af..056f69249 100644 --- a/documentation/bsp-guide/bsp.rst +++ b/documentation/bsp-guide/bsp.rst @@ -72,7 +72,7 @@ For information on typical BSP development workflow, see the section. For more information on how to set up a local copy of source files from a Git repository, see the -:ref:`dev-manual/start:locating yocto project source files` +:doc:`/dev-manual/poky-manual-setup` section in the Yocto Project Development Tasks Manual. The BSP layer's base directory (``meta-bsp_root_name``) is the root @@ -204,10 +204,7 @@ section. .. note:: To see the available branch names in a cloned repository, use the ``git - branch -a`` command. See the - ":ref:`dev-manual/start:checking out by branch in poky`" - section in the Yocto Project Development Tasks Manual for more - information. + branch -a`` command. #. *Optionally Set Up an Alternative BSP Layer:* If your hardware can be more closely leveraged to an existing BSP not within the diff --git a/documentation/dev-manual/start.rst b/documentation/dev-manual/start.rst index b21cd4f0f..2aa3d5da5 100644 --- a/documentation/dev-manual/start.rst +++ b/documentation/dev-manual/start.rst @@ -76,7 +76,7 @@ particular working environment and set of practices. :term:`Metadata` (i.e. recipes, configuration files, classes, and so forth) and any software you are developing under the control of an SCM system that is compatible - with the OpenEmbedded build system is advisable. Of all of the SCMs + with the :term:`OpenEmbedded build system` is advisable. Of all of the SCMs supported by BitBake, the Yocto Project team strongly recommends using :ref:`overview-manual/development-environment:git`. Git is a distributed system @@ -218,7 +218,7 @@ particular working environment and set of practices. repositories. See the ":ref:`overview-manual/development-environment:yocto project source repositories`" section in the Yocto Project Overview and Concepts Manual for information on these repositories. See the - ":ref:`dev-manual/start:locating yocto project source files`" + ":doc:`/dev-manual/poky-manual-setup`" section for information on how to set up local Git repositories for related upstream Yocto Project Git repositories. @@ -338,7 +338,7 @@ Project Build Host: Once you have completed the previous steps, you are ready to continue using a given development path on your native Linux machine. If you are going to use BitBake, see the -":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" +":ref:`dev-manual/start:preparing the poky reference distro`" section. If you are going to use the Extensible SDK, see the ":doc:`/sdk-manual/extensible`" Chapter in the Yocto Project Application Development and the Extensible Software Development @@ -433,7 +433,7 @@ as your Yocto Project build host: Once you have a container set up, everything is in place to develop just as if you were running on a native Linux machine. If you are going to use the Poky container, see the -":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" +":ref:`dev-manual/start:preparing the Poky reference distro`" section. If you are going to use the Extensible SDK container, see the ":doc:`/sdk-manual/extensible`" Chapter in the Yocto Project Application Development and the Extensible Software Development @@ -576,302 +576,60 @@ the `Yocto Project BitBake `__ extension accordingly. -Locating Yocto Project Source Files -=================================== +Preparing the Poky Reference Distro +----------------------------------- -This section shows you how to locate, fetch, unpack, patch and configure the source -files you'll need to work with the Yocto Project. +Now that the :term:`Build Host` has been prepared to build images, the next step +can be to build the :term:`Poky` reference distro. There are two ways of setting +up the :term:`Poky` reference distro: -.. note:: - - - For concepts and introductory information about Git as it is used - in the Yocto Project, see the ":ref:`overview-manual/development-environment:git`" - section in the Yocto Project Overview and Concepts Manual. - - - For concepts on Yocto Project source repositories, see the - ":ref:`overview-manual/development-environment:yocto project source repositories`" - section in the Yocto Project Overview and Concepts Manual." - -Accessing Source Repositories ------------------------------ - -Working from a copy of the upstream :ref:`dev-manual/start:accessing source repositories` is the -preferred method for obtaining and using a Yocto Project release. You -can view the Yocto Project Source Repositories at -:yocto_git:`/`. In particular, you can find the ``poky`` -repository at :yocto_git:`/poky`. - -Use the following procedure to locate the latest upstream copy of the -``poky`` Git repository: - -#. *Access Repositories:* Open a browser and go to - :yocto_git:`/` to access the GUI-based interface into the - Yocto Project source repositories. +- Using the ``bitbake-setup`` command-line utility from :term:`BitBake`. + Follow: -#. *Select the Repository:* Click on the repository in which you are - interested (e.g. ``poky``). + :doc:`Setting Up The Environment With bitbake-setup ` -#. *Find the URL Used to Clone the Repository:* At the bottom of the - page, note the URL used to clone that repository - (e.g. :yocto_git:`/poky`). +- Manually cloning the required repositories. Follow: - .. note:: + :doc:`/dev-manual/poky-manual-setup` - For information on cloning a repository, see the - ":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" section. +.. note:: -Accessing Source Archives -------------------------- + The :term:`Poky` distro is a reference distro. It can be used to try the + Yocto Project but should not be used in a production environment. Instead, it + is recommended to create your own distro, see the + :doc:`/dev-manual/custom-distribution` section of the Yocto Project + Development Tasks Manual. -The Yocto Project also provides source archives of its releases, which -are available on :yocto_dl:`/releases/yocto/`. Then, choose the subdirectory -containing the release you wish to use, for example -:yocto_dl:`&DISTRO_REL_LATEST_TAG; `. +Initializing the Build Environment +---------------------------------- -You will find there source archives of individual components (if you wish -to use them individually), and of the corresponding Poky release bundling -a selection of these components. +Initializing the build environment is a common task, as it needs to be done for +each new instance of the shell where the :term:`Poky` reference distro was set up: -.. note:: +- If ``bitbake-setup`` was used to setup the :term:`Poky` reference distro, you + need to source the ``init-build-env`` file of the :term:`bitbake:Setup` + directory that was created after the :ref:`bitbake:ref-bbsetup-command-init` + command execution: - The recommended method for accessing Yocto Project components is to - use Git to clone the upstream repository and work from within that - locally cloned repository. - -Using the Downloads Page ------------------------- - -The :yocto_home:`Yocto Project Website <>` uses a "RELEASES" page -from which you can locate and download tarballs of any Yocto Project -release. Rather than Git repositories, these files represent snapshot -tarballs similar to the tarballs located in the Index of Releases -described in the ":ref:`dev-manual/start:accessing source archives`" section. - -#. *Go to the Yocto Project Website:* Open The - :yocto_home:`Yocto Project Website <>` in your browser. - -#. *Get to the Downloads Area:* Select the "RELEASES" item from the - pull-down "DEVELOPMENT" tab menu near the top of the page. - -#. *Select a Yocto Project Release:* On the top of the "RELEASES" page, currently - supported releases are displayed; further down, past supported Yocto Project - releases are visible. The "Download" links in the rows of the table there - will lead to the download tarballs for the release. - - .. note:: - - For a "map" of Yocto Project releases to version numbers, see the - :yocto_home:`Releases ` page. - - You can use the "RELEASE ARCHIVE" link to reveal a menu of all Yocto - Project releases. - -#. *Download Tools or Board Support Packages (BSPs):* Next to the tarballs you - will find download tools or BSPs as well. Just select a Yocto Project - release and look for what you need. - -Cloning and Checking Out Branches -================================= - -To use the Yocto Project for development, you need a release locally -installed on your development system. This locally installed set of -files is referred to as the :term:`Source Directory` -in the Yocto Project documentation. - -The preferred method of creating your Source Directory is by using -:ref:`overview-manual/development-environment:git` to clone a local copy of the upstream -``poky`` repository. Working from a cloned copy of the upstream -repository allows you to contribute back into the Yocto Project or to -simply work with the latest software on a development branch. Because -Git maintains and creates an upstream repository with a complete history -of changes and you are working with a local clone of that repository, -you have access to all the Yocto Project development branches and tag -names used in the upstream repository. - -Cloning the ``poky`` Repository -------------------------------- - -Follow these steps to create a local version of the upstream -:term:`Poky` Git repository. - -#. *Set Your Directory:* Change your working directory to where you want - to create your local copy of ``poky``. - -#. *Clone the Repository:* The following example command clones the - ``poky`` repository and uses the default name "poky" for your local - repository:: - - $ git clone git://git.yoctoproject.org/poky - Cloning into 'poky'... - remote: Counting objects: 432160, done. - remote: Compressing objects: 100% (102056/102056), done. - remote: Total 432160 (delta 323116), reused 432037 (delta 323000) - Receiving objects: 100% (432160/432160), 153.81 MiB | 8.54 MiB/s, done. - Resolving deltas: 100% (323116/323116), done. - Checking connectivity... done. - - Unless you - specify a specific development branch or tag name, Git clones the - "master" branch, which results in a snapshot of the latest - development changes for "master". For information on how to check out - a specific development branch or on how to check out a local branch - based on a tag name, see the - ":ref:`dev-manual/start:checking out by branch in poky`" and - ":ref:`dev-manual/start:checking out by tag in poky`" sections, respectively. - - Once the local repository is created, you can change to that - directory and check its status. The ``master`` branch is checked out - by default:: - - $ cd poky - $ git status - On branch master - Your branch is up-to-date with 'origin/master'. - nothing to commit, working directory clean - $ git branch - * master - - Your local repository of poky is initially identical to the - upstream poky repository from which it was cloned. As you - work with the local branch, you can periodically use the - ``git pull`` command to be sure you stay up-to-date - with the upstream poky branch. - -Checking Out by Branch in Poky ------------------------------- + .. code-block:: console -When you clone the upstream poky repository, you have access to all its -development branches. Each development branch in a repository is unique -as it forks off the "master" branch. To see and use the files of a -particular development branch locally, you need to know the branch name -and then specifically check out that development branch. + $ source /build/init-build-env -.. note:: - Checking out an active development branch by branch name gives you a - snapshot of that particular branch at the time you check it out. - Further development on top of the branch that occurs after check it - out can occur. - -#. *Switch to the Poky Directory:* If you have a local poky Git - repository, switch to that directory. If you do not have the local - copy of poky, see the - ":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" - section. - -#. *Determine Existing Branch Names:* - :: - - $ git branch -a - * master - remotes/origin/1.1_M1 - remotes/origin/1.1_M2 - remotes/origin/1.1_M3 - remotes/origin/1.1_M4 - remotes/origin/1.2_M1 - remotes/origin/1.2_M2 - remotes/origin/1.2_M3 - . . . - remotes/origin/thud - remotes/origin/thud-next - remotes/origin/warrior - remotes/origin/warrior-next - remotes/origin/zeus - remotes/origin/zeus-next - ... and so on ... - -#. *Check out the Branch:* Check out the development branch in which you - want to work. For example, to access the files for the Yocto Project - &DISTRO; Release (&DISTRO_NAME;), use the following command:: - - $ git checkout -b &DISTRO_NAME_NO_CAP; origin/&DISTRO_NAME_NO_CAP; - Branch &DISTRO_NAME_NO_CAP; set up to track remote branch &DISTRO_NAME_NO_CAP; from origin. - Switched to a new branch '&DISTRO_NAME_NO_CAP;' - - The previous command checks out the "&DISTRO_NAME_NO_CAP;" development - branch and reports that the branch is tracking the upstream - "origin/&DISTRO_NAME_NO_CAP;" branch. - - The following command displays the branches that are now part of your - local poky repository. The asterisk character indicates the branch - that is currently checked out for work:: - - $ git branch - master - * &DISTRO_NAME_NO_CAP; - -Checking Out by Tag in Poky ---------------------------- - -Similar to branches, the upstream repository uses tags to mark specific -commits associated with significant points in a development branch (i.e. -a release point or stage of a release). You might want to set up a local -branch based on one of those points in the repository. The process is -similar to checking out by branch name except you use tag names. +- If the :term:`Poky` distro was setup using manual clones of the layers, you + need to source the ``oe-init-build-env`` script present in the + :term:`OpenEmbedded-Core (OE-Core)` layer: -.. note:: + .. code-block:: console - Checking out a branch based on a tag gives you a stable set of files - not affected by development on the branch above the tag. - -#. *Switch to the Poky Directory:* If you have a local poky Git - repository, switch to that directory. If you do not have the local - copy of poky, see the - ":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" - section. - -#. *Fetch the Tag Names:* To checkout the branch based on a tag name, - you need to fetch the upstream tags into your local repository:: - - $ git fetch --tags - $ - -#. *List the Tag Names:* You can list the tag names now:: - - $ git tag - 1.1_M1.final - 1.1_M1.rc1 - 1.1_M1.rc2 - 1.1_M2.final - 1.1_M2.rc1 - . - . - . - yocto-2.5 - yocto-2.5.1 - yocto-2.5.2 - yocto-2.5.3 - yocto-2.6 - yocto-2.6.1 - yocto-2.6.2 - yocto-2.7 - yocto_1.5_M5.rc8 - - -#. *Check out the Branch:* - :: - - $ git checkout tags/yocto-&DISTRO; -b my_yocto_&DISTRO; - Switched to a new branch 'my_yocto_&DISTRO;' - $ git branch - master - * my_yocto_&DISTRO; - - The previous command creates and - checks out a local branch named "my_yocto_&DISTRO;", which is based on - the commit in the upstream poky repository that has the same tag. In - this example, the files you have available locally as a result of the - ``checkout`` command are a snapshot of the "&DISTRO_NAME_NO_CAP;" - development branch at the point where Yocto Project &DISTRO; was - released. + $ source openembedded-core/oe-init-build-env -Initializing the Build Environment -================================== +This will setup your current shell and change the current working directory to +the :term:`Build Directory`. -Before you can use Yocto you need to setup the build environment. -From within the ``poky`` directory, source the :ref:`ref-manual/structure:``oe-init-build-env``` environment -setup script to define Yocto Project's build environment on your build host:: +Where To Go From Here +--------------------- - $ source oe-init-build-env +- Configure your build: follow :ref:`overview-manual/concepts:User Configuration`. -Note, that this step will have to be repeated every time you open a new shell. +- Learn how and what to build with :term:`BitBake`: follow :doc:`/dev-manual/building`. diff --git a/documentation/kernel-dev/common.rst b/documentation/kernel-dev/common.rst index c0df39e39..1e098c158 100644 --- a/documentation/kernel-dev/common.rst +++ b/documentation/kernel-dev/common.rst @@ -22,21 +22,13 @@ Preparing the Build Host to Work on the Kernel Before you can do any kernel development, you need to be sure your build host is set up to use the Yocto Project. For information on how to get set up, see the ":doc:`/dev-manual/start`" section in -the Yocto Project Development Tasks Manual. Part of preparing the system -is creating a local Git repository of the -:term:`Source Directory` (``poky``) on your system. Follow the steps in the -":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" -section in the Yocto Project Development Tasks Manual to set up your -Source Directory. +the Yocto Project Development Tasks Manual. .. note:: Be sure you check out the appropriate development branch or you create your local branch by checking out a specific tag to get the - desired version of Yocto Project. See the - ":ref:`dev-manual/start:checking out by branch in poky`" and - ":ref:`dev-manual/start:checking out by tag in poky`" - sections in the Yocto Project Development Tasks Manual for more information. + desired version of Yocto Project. Kernel development is best accomplished using :ref:`devtool ` @@ -158,28 +150,8 @@ this procedure leaves you ready to make modifications to the kernel source as described in the ":ref:`kernel-dev/common:using traditional kernel development to patch the kernel`" section: -#. *Initialize the BitBake Environment:* Before you can do anything - using BitBake, you need to initialize the BitBake build environment - by sourcing the build environment script (i.e. - :ref:`structure-core-script`). - Also, for this example, be sure that the local branch you have - checked out for ``poky`` is the Yocto Project &DISTRO_NAME; branch. If - you need to checkout out the &DISTRO_NAME; branch, see the - ":ref:`dev-manual/start:checking out by branch in poky`" - section in the Yocto Project Development Tasks Manual:: - - $ cd poky - $ git branch - master - * &DISTRO_NAME_NO_CAP; - $ source oe-init-build-env - - .. note:: - - The previous commands assume the - :ref:`overview-manual/development-environment:yocto project source repositories` - (i.e. ``poky``) have been cloned using Git and the local repository is named - "poky". +#. *Initialize the BitBake Environment:* Follow the steps in the + :doc:`/dev-manual/start` section of the Yocto Project Development Tasks Manual. #. *Prepare Your local.conf File:* By default, the :term:`MACHINE` variable is set to "qemux86-64", which is fine if you are building for the QEMU emulator diff --git a/documentation/overview-manual/development-environment.rst b/documentation/overview-manual/development-environment.rst index 066d78431..ab9bd084c 100644 --- a/documentation/overview-manual/development-environment.rst +++ b/documentation/overview-manual/development-environment.rst @@ -184,15 +184,6 @@ development: .. image:: figures/source-repos.png :width: 100% - For steps on how to view and access these upstream Git repositories, - see the ":ref:`dev-manual/start:accessing source repositories`" - Section in the Yocto Project Development Tasks Manual. - -- :yocto_dl:`Yocto release archives: ` This is where you can - download tarballs corresponding to each Yocto Project release. Downloading - and extracting these files does not produce a local copy of a Git repository - but rather a snapshot corresponding to a particular release. - - :yocto_home:`DOWNLOADS page `: The :yocto_home:`Yocto Project website <>` includes a "DOWNLOADS" page accessible through the "SOFTWARE" menu that allows you to download any Yocto @@ -203,10 +194,6 @@ development: .. image:: figures/yp-download.png :width: 100% - For steps on how to use the "DOWNLOADS" page, see the - ":ref:`dev-manual/start:using the downloads page`" - section in the Yocto Project Development Tasks Manual. - Git Workflows and the Yocto Project =================================== @@ -372,10 +359,6 @@ commands. Ubuntu, use the Ubuntu Software feature). For the Git download page, see https://git-scm.com/download. - - For information beyond the introductory nature in this section, - see the ":ref:`dev-manual/start:locating yocto project source files`" - section in the Yocto Project Development Tasks Manual. - Repositories, Tags, and Branches -------------------------------- @@ -403,9 +386,7 @@ You can create a local copy of any repository by "cloning" it with the ``git clone`` command. When you clone a Git repository, you end up with an identical copy of the repository on your development system. Once you have a local copy of a repository, you can take steps to develop -locally. For examples on how to clone Git repositories, see the -":ref:`dev-manual/start:locating yocto project source files`" -section in the Yocto Project Development Tasks Manual. +locally. It is important to understand that Git tracks content change and not files. Git uses "branches" to organize different development efforts. diff --git a/documentation/ref-manual/structure.rst b/documentation/ref-manual/structure.rst index c0eae9b7b..d567cade0 100644 --- a/documentation/ref-manual/structure.rst +++ b/documentation/ref-manual/structure.rst @@ -10,11 +10,6 @@ contents is key to using the Yocto Project effectively. This chapter describes the Source Directory and gives information about those files and directories. -For information on how to establish a local Source Directory on your -development system, see the -":ref:`dev-manual/start:locating yocto project source files`" -section in the Yocto Project Development Tasks Manual. - .. note:: The OpenEmbedded build system does not support file or directory diff --git a/documentation/sdk-manual/appendix-obtain.rst b/documentation/sdk-manual/appendix-obtain.rst index 83eefecd6..fb2326fac 100644 --- a/documentation/sdk-manual/appendix-obtain.rst +++ b/documentation/sdk-manual/appendix-obtain.rst @@ -94,36 +94,11 @@ As an alternative to locating and downloading an SDK installer, you can build the SDK installer. Follow these steps: #. *Set Up the Build Environment:* Be sure you are set up to use BitBake - in a shell. See the ":ref:`dev-manual/start:preparing the build host`" section + in a shell. See the ":doc:`/dev-manual/start`" section in the Yocto Project Development Tasks Manual for information on how to get a build host ready that is either a native Linux machine or a machine that uses CROPS. -#. *Clone the ``poky`` Repository:* You need to have a local copy of the - Yocto Project :term:`Source Directory` - (i.e. a local - ``poky`` repository). See the ":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" and - possibly the ":ref:`dev-manual/start:checking out by branch in poky`" and - ":ref:`dev-manual/start:checking out by tag in poky`" sections - all in the Yocto Project Development Tasks Manual for information on - how to clone the ``poky`` repository and check out the appropriate - branch for your work. - -#. *Initialize the Build Environment:* While in the root directory of - the Source Directory (i.e. ``poky``), run the - :ref:`structure-core-script` environment - setup script to define the OpenEmbedded build environment on your - build host: - - .. code-block:: console - - $ source oe-init-build-env - - Among other things, the script creates the :term:`Build Directory`, which - is ``build`` in this case and is located in the Source Directory. After - the script runs, your current working directory is set to the ``build`` - directory. - #. *Make Sure You Are Building an Installer for the Correct Machine:* Check to be sure that your :term:`MACHINE` variable in the ``local.conf`` file in your :term:`Build Directory` matches the architecture From patchwork Thu Jan 29 15:22:55 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79984 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 5204BD61027 for ; Thu, 29 Jan 2026 15:24:18 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17186.1769700248454475575 for ; Thu, 29 Jan 2026 07:24:08 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=nkBdLZIV; 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 C16DD1A2B09 for ; Thu, 29 Jan 2026 15:24:06 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 99872606FD; Thu, 29 Jan 2026 15:24:06 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id C28DE119A8857; Thu, 29 Jan 2026 16:24:05 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700246; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=XI9UKCAGFh/EbMqvZeGpICyxkOTlKQL9zRNZcyPmj9Q=; b=nkBdLZIVAAR4SmPAkOF8LEEOn+x4lr1rFEW09XF17rLDSYvfgSWNsk5k69fnHqRQec3mgw dxLywFUqm5NB5jvIr8v4/IfebnJuliUYAUSgQxVVigwR8z6zZvQ0l9dwqo0pSUr8L67V+A sNb8Fvr6KkuFQ7M/sQKe/3E3CCpBplVr9SQVDyJe2QwUG6Kp1nA3yr7+N1ZjCrfjIJEtue +f5hl+7QOXJL4AKjqU3rKG9eBNlF72kYWNwffqjrjfIbpLpWRq4BlWyH8TGAN34nH33YpD P28uhHxH8tK+zRIOzFjb/DV6qgEdmNc6Xv62RFk05R5nb7QFyIp7fH6AcW7eiw== From: Antonin Godard Date: Thu, 29 Jan 2026 16:22:55 +0100 Subject: [PATCH v3 04/57] bsp-guide/bsp.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-4-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=14116; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=bELrHa49FMRd88qyNGyFnTBsZbqBzlbW2fKmGZJz7ug=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uJQ7OdBI6oQL6/CO39UUHZPxqQ+5pIM3HOF XnLIVnJRN+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7iQAKCRDRgEFAKaOo NlmvD/46hFnsD+tnf+VS1JJqHVnKMCzcRzYnedkCOqaq+vpg7vPL5m/X5piqQHVRf1T2eNt/4VP Bvn/f5Zrlaf7OmTU/Kx1EgbMqV39dd6ECS//tzo5X/Bg1D1QJ6rQhvcYzpzk1jjxtq8DjMfZqRX 2/8aZ319Kf/CBqJeG9LJw1D+3rqJVhD4fIoH1v4RUfAwzE7eNQZcRlA+sqPSpGO3NMzimE82U6e 5Nvl62h3yAdVVCgROijG9ghmiCtaZVmmfvfcGU/4Mxh4OpxplDtTCqO53wqy5E5ibOgFo34pvaQ WCpXsjmc6aGme+F5RXnyYaegAP4crKfekZz6OmSosi4CsgKwkW6Kf6AUcdj3ugJE3A6YDBEiZOj 9BeoH3RgNhN6qHP90J+4r/iEyorrs4R528qsTr3vb62qz6HzVFQMePnnUQyy/Pps3cjVYfAnfrb b0ZubBTK8wAaXfd7goS5Gn+kPjjHuc3/bQfbBDtU0Wq5wNQKCma66SRAExviXKFU4Yl0eRjZraC VpDOq90jedbfpK493pZ7mTdCqb1qx/qo3slJMqx8Sw2AN1TZI7m2LrerDVOcp7eE04yNK5JFOdN 1dzyaiDaWU7rTUEnEp5hNU6W0Cvtu0vZBilTsz/ES1ecC1QZ/8rs/cpVXiqSG7K/aV3G7R4UGRh iiG+1ae9FjswKkQ== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8790 Remove references to the Poky repository, replace by OpenEmbedded-Core in most cases, and refer to bitbake-setup or the manual setup in the intro. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/bsp-guide/bsp.rst | 154 +++++++++++++--------------------------- 1 file changed, 50 insertions(+), 104 deletions(-) diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst index 056f69249..343b2753c 100644 --- a/documentation/bsp-guide/bsp.rst +++ b/documentation/bsp-guide/bsp.rst @@ -62,8 +62,8 @@ Here is an example that clones the Raspberry Pi BSP layer:: $ git clone git://git.yoctoproject.org/meta-raspberrypi -In addition to BSP layers, the ``meta-yocto-bsp`` layer is part of the -shipped ``poky`` repository. The ``meta-yocto-bsp`` layer maintains +In addition to BSP layers, the ``meta-yocto-bsp`` layer is part of +:yocto_git:`meta-yocto `. The ``meta-yocto-bsp`` layer maintains several "reference" BSPs including the ARM-based Beaglebone and generic versions of both 32-bit and 64-bit IA machines. @@ -150,24 +150,23 @@ section. to get a build host ready that is either a native Linux machine or a machine that uses CROPS. -#. *Clone the poky Repository:* You need to have a local copy of the - Yocto Project :term:`Source Directory` (i.e. a local - ``poky`` repository). See the - ":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" and - possibly the - ":ref:`dev-manual/start:checking out by branch in poky`" or - ":ref:`dev-manual/start:checking out by tag in poky`" - sections - all in the Yocto Project Development Tasks Manual for information on - how to clone the ``poky`` repository and check out the appropriate - branch for your work. +#. *Prepare the Source Repositories*: + + There are two ways of setting up the :term:`Poky` reference distro: + + - Using the ``bitbake-setup`` command-line utility from :term:`BitBake`. + Follow: + + :doc:`Setting Up The Environment With bitbake-setup ` + + - Manually cloning the required repositories. Follow: + + :doc:`/dev-manual/poky-manual-setup` #. *Determine the BSP Layer You Want:* The Yocto Project supports many BSPs, which are maintained in their own layers or in layers designed - to contain several BSPs. To get an idea of machine support through - BSP layers, you can look at the - :yocto_dl:`index of machines ` - for the release. + to contain several BSPs. The :oe_layerindex:`Layer Index <>` can help finding + BSP layers to use. #. *Optionally Clone the meta-intel BSP Layer:* If your hardware is based on current Intel CPUs and devices, you can leverage this BSP @@ -175,10 +174,7 @@ section. :yocto_git:`README ` file. #. *Navigate to Your Source Directory:* Typically, you set up the - ``meta-intel`` Git repository inside the :term:`Source Directory` (e.g. - ``poky``). :: - - $ cd /home/you/poky + ``meta-intel`` Git repository next to the other layers in your build. #. *Clone the Layer:* :: @@ -224,18 +220,21 @@ section. Resolving deltas: 100% (2447/2447), done. Checking connectivity... done. -#. *Initialize the Build Environment:* While in the root directory of - the Source Directory (i.e. ``poky``), run the - :ref:`ref-manual/structure:``oe-init-build-env``` environment - setup script to define the OpenEmbedded build environment on your - build host. :: +#. *Initialize the Build Environment:* While in the :term:`Source Directory`, + run the :ref:`ref-manual/structure:``oe-init-build-env``` environment setup + script located in :term:`OpenEmbedded-Core (OE-Core)` to define the OpenEmbedded + build environment on your build host. :: - $ source oe-init-build-env + $ source layers/openembedded-core/oe-init-build-env Among other things, the script creates the :term:`Build Directory`, which is - ``build`` in this case and is located in the :term:`Source Directory`. After - the script runs, your current working directory is set to the ``build`` - directory. + "build". After the script runs, your current working directory is set to + the :term:`Build Directory`. + + .. note:: + + Alternatively, you can source the ``init-build-env`` file provided by + :doc:`bitbake-setup ` Example Filesystem Layout ========================= @@ -597,10 +596,10 @@ optimization flags, which are carefully chosen to give best performance on a given processor. Tuning files are found in the ``meta/conf/machine/include`` directory -within the :term:`Source Directory`. +within :term:`OpenEmbedded-Core (OE-Core)`. For example, many ``tune-*`` files (e.g. ``tune-arm1136jf-s.inc``, ``tune-1586-nlp.inc``, and so forth) reside in the -``poky/meta/conf/machine/include`` directory. +``meta/conf/machine/include`` directory. To use an include file, you simply include them in the machine configuration file. For example, the Raspberry Pi BSP @@ -636,7 +635,7 @@ directory. Here is the ``machconfig`` file for the Raspberry Pi BSP:: according to the formfactor configuration file that is installed by the main formfactor recipe ``meta/recipes-bsp/formfactor/formfactor_0.0.bb``, which is found in - the :term:`Source Directory`. + :term:`OpenEmbedded-Core (OE-Core)`. Display Support Files --------------------- @@ -664,7 +663,7 @@ types of files although, in practice, it is likely that you would have one or the other. For your BSP, you typically want to use an existing Yocto Project kernel -recipe found in the :term:`Source Directory` +recipe found in :term:`OpenEmbedded-Core (OE-Core)` at ``meta/recipes-kernel/linux``. You can append machine-specific changes to the kernel recipe by using a similarly named append file, which is @@ -766,20 +765,23 @@ workflow. .. note:: - - There are three hardware reference BSPs in the Yocto - Project release, located in the ``poky/meta-yocto-bsp`` + - There are four hardware reference BSPs in the Yocto + Project release, located in the :yocto_git:`meta-yocto-bsp + ` BSP layer: - Texas Instruments Beaglebone (``beaglebone-yocto``) - Two generic IA platforms (``genericx86`` and ``genericx86-64``) + - A generic ARM 64 platform (``genericarm64``) + When you set up a layer for a new BSP, you should follow a standard layout. This layout is described in the ":ref:`bsp-guide/bsp:example filesystem layout`" section. In the standard layout, notice the suggested structure for recipes and configuration information. You can see the standard layout for a BSP by examining any supported - BSP found in the ``meta-intel`` layer inside the Source Directory. + BSP found in the :yocto_git:`meta-intel ` layer. #. *Make Configuration Changes to Your New BSP Layer:* The standard BSP layer structure organizes the files you need to edit in ``conf`` and @@ -861,9 +863,8 @@ The requirements for a released BSP that conform to the Yocto Project are: - *File System Layout:* When possible, use the same directory names in your BSP layer as listed in the ``recipes.txt`` file, which is found - in ``poky/meta`` directory of the :term:`Source Directory` - or in the OpenEmbedded-Core Layer (``openembedded-core``) at - :oe_git:`/openembedded-core/tree/meta`. + in :oe_git:`meta ` directory of + :term:`OpenEmbedded-Core (OE-Core)`. You should place recipes (``*.bb`` files) and recipe modifications (``*.bbappend`` files) into ``recipes-*`` subdirectories by @@ -872,8 +873,8 @@ The requirements for a released BSP that conform to the Yocto Project are: up your own ``recipes-*`` subdirectory. Within any particular ``recipes-*`` category, the layout should match - what is found in the OpenEmbedded-Core Git repository - (``openembedded-core``) or the Source Directory (``poky``). In other + what is found in the :term:`OpenEmbedded-Core (OE-Core)` Git repository. + In other words, make sure you place related files in appropriately-related ``recipes-*`` subdirectories specific to the recipe's function, or within a subdirectory containing a set of closely-related recipes. @@ -1169,7 +1170,7 @@ Use these steps to create a BSP layer: - *Create a Machine Configuration File:* Create a ``conf/machine/bsp_root_name.conf`` file. See - :yocto_git:`meta-yocto-bsp/conf/machine ` + :yocto_git:`meta-yocto-bsp/conf/machine ` for sample ``bsp_root_name.conf`` files. There are other samples such as :yocto_git:`meta-ti ` and @@ -1187,7 +1188,7 @@ Use these steps to create a BSP layer: The remainder of this section provides a description of the Yocto Project reference BSP for Beaglebone, which resides in the -:yocto_git:`meta-yocto-bsp ` +:yocto_git:`meta-yocto-bsp ` layer. BSP Layer Configuration Example @@ -1235,63 +1236,8 @@ There are one or more machine configuration files in the For example, the machine configuration file for the `BeagleBone and BeagleBone Black development boards `__ is -located in :yocto_git:`poky/meta-yocto-bsp/conf/machine/beaglebone-yocto.conf -`:: - - #@TYPE: Machine - #@NAME: Beaglebone-yocto machine - #@DESCRIPTION: Reference machine configuration for http://beagleboard.org/bone and http://beagleboard.org/black boards - - PREFERRED_PROVIDER_virtual/xserver ?= "xserver-xorg" - - MACHINE_EXTRA_RRECOMMENDS = "kernel-modules" - - EXTRA_IMAGEDEPENDS += "virtual/bootloader" - - DEFAULTTUNE ?= "cortexa8hf-neon" - include conf/machine/include/arm/armv7a/tune-cortexa8.inc - - IMAGE_FSTYPES += "tar.bz2 jffs2 wic wic.bmap" - EXTRA_IMAGECMD:jffs2 = "-lnp " - WKS_FILE ?= "beaglebone-yocto.wks" - MACHINE_ESSENTIAL_EXTRA_RDEPENDS += "kernel-image kernel-devicetree" - do_image_wic[depends] += "mtools-native:do_populate_sysroot dosfstools-native:do_populate_sysroot virtual/bootloader:do_deploy" - - SERIAL_CONSOLES ?= "115200;ttyS0 115200;ttyO0 115200;ttyAMA0" - - PREFERRED_PROVIDER_virtual/kernel ?= "linux-yocto" - PREFERRED_VERSION_linux-yocto ?= "6.12%" - - KERNEL_IMAGETYPE = "zImage" - DTB_FILES = "am335x-bone.dtb am335x-boneblack.dtb am335x-bonegreen.dtb" - KERNEL_DEVICETREE = '${@' '.join('ti/omap/%s' % d for d in '${DTB_FILES}'.split())}' - - PREFERRED_PROVIDER_virtual/bootloader ?= "u-boot" - - SPL_BINARY = "MLO" - UBOOT_SUFFIX = "img" - UBOOT_MACHINE = "am335x_evm_defconfig" - - MACHINE_FEATURES = "usbgadget usbhost vfat alsa" - - IMAGE_BOOT_FILES ?= "u-boot.${UBOOT_SUFFIX} ${SPL_BINARY} ${KERNEL_IMAGETYPE} ${DTB_FILES}" - - # support runqemu - EXTRA_IMAGEDEPENDS += "qemu-native qemu-helper-native" - IMAGE_CLASSES += "qemuboot" - QB_DEFAULT_FSTYPE = "wic" - QB_FSINFO = "wic:no-kernel-in-fs" - QB_KERNEL_ROOT = "/dev/vda2" - QB_SYSTEM_NAME = "qemu-system-arm" - QB_MACHINE = "-machine virt" - QB_CPU = "-cpu cortex-a15" - QB_KERNEL_CMDLINE_APPEND = "console=ttyAMA0 systemd.mask=systemd-networkd" - QB_OPT_APPEND = "-device virtio-rng-device" - QB_TAP_OPT = "-netdev tap,id=net0,ifname=@TAP@,script=no,downscript=no" - QB_NETWORK_DEVICE = "-device virtio-net-device,netdev=net0,mac=@MAC@" - QB_ROOTFS_OPT = "-drive id=disk0,file=@ROOTFS@,if=none,format=raw -device virtio-blk-device,drive=disk0" - QB_SERIAL_OPT = "" - QB_TCPSERIAL_OPT = "-device virtio-serial-device -chardev socket,id=virtcon,port=@PORT@,host=127.0.0.1 -device virtconsole,chardev=virtcon" +located in :yocto_git:`/meta-yocto/tree/meta-yocto-bsp/conf/machine/beaglebone-yocto.conf +`. The variables used to configure the machine define machine-specific properties; for example, machine-dependent packages, machine tunings, the type of kernel @@ -1309,7 +1255,7 @@ Project Reference Manual. The recipe that provides "virtual/xserver" when more than one provider is found. In this case, the recipe that provides "virtual/xserver" is "xserver-xorg", available in - ``poky/meta/recipes-graphics/xorg-xserver``. + ``meta/recipes-graphics/xorg-xserver`` in :term:`OpenEmbedded-Core (OE-Core)`. - :term:`MACHINE_EXTRA_RRECOMMENDS`: A list of machine-dependent packages not essential for booting the @@ -1400,7 +1346,7 @@ Project Reference Manual. .. note:: For more information on how the SPL variables are used, see the - :yocto_git:`u-boot.inc ` + :oe_git:`u-boot.inc ` include file. - :term:`UBOOT_* `: Defines @@ -1438,7 +1384,7 @@ The ``meta-yocto-bsp/recipes-kernel/linux`` directory in the layer contains metadata used to build the kernel. In this case, a kernel append file (i.e. ``linux-yocto_6.1.bbappend``) is used to override an established kernel recipe (i.e. ``linux-yocto_6.1.bb``), which is located in -:yocto_git:`/poky/tree/meta/recipes-kernel/linux`. +:oe_git:`/openembedded-core/tree/meta/recipes-kernel/linux`. The contents of the append file are:: From patchwork Thu Jan 29 15:22:56 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79983 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 56443D61028 for ; Thu, 29 Jan 2026 15:24:18 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.17087.1769700248671086678 for ; Thu, 29 Jan 2026 07:24:08 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=zCrx5502; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id 24DD0C22F4B for ; Thu, 29 Jan 2026 15:24:10 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 235D3606FD; Thu, 29 Jan 2026 15:24:07 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 7C8E1119A868D; Thu, 29 Jan 2026 16:24:06 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700246; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=abAe3RVDM4u1zBAhm+yCiLQo8DnpUmlIiY2+RJuU0Kw=; b=zCrx5502Z4I7P/QolPWYzFRGo6Xx1U4+G23lbfvZ7kKLLPdtk5IMhvRMzvoO+sdEJS9Cat ibkTTjgpOuXwheMpgU73PNwYq/BqVnmueWFiscC5gRMMWX5AnbbO2xqcU2BRaWLl2FKwL1 Q3E1OCGxd68FsHY/MiyRfuTRgOFLdE7Ehpd0qBRSfBhI/aGGOJIBBaqPUrbk9+ObcVL30I 3/3glsvgBGasZOBDG88IPQ9ERvFZWfMR5cCD9GzcTBjh+KCMLYxemUAbYLUlWaH1d1b/js SaHRIhOc7mZs1XHLzjzr6uVIywPAl61el22oneHF084lWILZOYWpmm/jNiWM5g== From: Antonin Godard Date: Thu, 29 Jan 2026 16:22:56 +0100 Subject: [PATCH v3 05/57] kernel-dev/advanced.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-5-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2577; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=9IN9YDb7FgzPwAYsZUikwKnVDh18xUzKCbZcA155HBI=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uJZetvAEILHdaqnvUvXRniYVAr2orLtnoWv yeSdXGkxmGJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7iQAKCRDRgEFAKaOo NoNiD/4mLU0zMo/9lSu7jMYHTB6U/wer4s4wzrlLZ5mXowN6Bb/aTbiBZn2H8WlWqn8qY262KW4 WXPQU0pHiU8MMpZyQUy2YMtV2GXfErPrZs3O2Gokuy93b3g1iDzcgeiN0GlKUVjD+x7201EhGNj X2mSFsBb9f4fSplqOK3TjJ2S2EXsM0ExdzTQKc+OpWUpFXIWnTO2iBbBCIR+XiCKf1C0FKG4xg0 W7y85RimADHRNgPeYKjp7lqv2dZkB9/zC45bd3DK+c478ePhBv1PvL40RWxXBQIaWP8j2vp4yuE undmeDX8eQw9kvNrFUUtIvxNjM1TpDJLG4ewpSxThRasH5CSLEhiWk348Y9VBOOh90DmsLU3hfy Xi2HZYeFeZxiUypDYhmgkm4Zxjdn72HRBrSbLyU9RRcAPzSofNWacLb1ZrxYJXEyA73XwWUz2GO Kqf0i4V6U0BQbucWniaj/rzTxlm5PLn6PwbptWq+gVnyXQUT6HNJpJ3Kq3gKUezkBF64376ySQe aFPdH6GyECJkeG2Vrj94B+09uwcbj23nUQJ+a1svtE03lbjVnHFmKgxeWwNdZgvyu9N3txxQm4X yeXxqV3ihLp53WFdKWRNM3XkFRFPW1nThHVQf5PtqQQ7LaKezVOp1CyHmn6XcDwLwNGQ5RYVLPs tLwSPpAZM6oYRNQ== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8791 Remove references to the Poky repository, replace by OpenEmbedded-Core in most cases, and refer to bitbake-setup or the manual setup in the intro. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/kernel-dev/advanced.rst | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/documentation/kernel-dev/advanced.rst b/documentation/kernel-dev/advanced.rst index 4c463503f6..97cb663222 100644 --- a/documentation/kernel-dev/advanced.rst +++ b/documentation/kernel-dev/advanced.rst @@ -24,9 +24,8 @@ grouped under the "Yocto Linux Kernel" heading in the Kernel development tools ("kern-tools") are also available in the Yocto Project Source Repositories under the "Yocto Linux Kernel" heading in the ``yocto-kernel-tools`` Git repository. The recipe that builds these -tools is ``meta/recipes-kernel/kern-tools/kern-tools-native_git.bb`` in -the :term:`Source Directory` (e.g. -``poky``). +tools is ``recipes-kernel/kern-tools/kern-tools-native_git.bb`` in +:term:`OpenEmbedded-Core (OE-Core)`. Using Kernel Metadata in a Recipe ================================= @@ -357,9 +356,9 @@ kernel of a specific type (e.g. a real-time kernel). Syntactically, kernel types are no different than features as described in the ":ref:`kernel-dev/advanced:features`" section. The :term:`LINUX_KERNEL_TYPE` variable in the kernel recipe selects the kernel type. For example, in the -``linux-yocto_4.12.bb`` kernel recipe found in ``poky/meta/recipes-kernel/linux``, a +``linux-yocto_4.12.bb`` kernel recipe found in ``meta/recipes-kernel/linux``, a :ref:`require ` -directive includes the ``poky/meta/recipes-kernel/linux/linux-yocto.inc`` file, +directive includes the ``meta/recipes-kernel/linux/linux-yocto.inc`` file, which has the following statement that defines the default kernel type:: LINUX_KERNEL_TYPE ??= "standard" @@ -373,8 +372,7 @@ type as follows:: .. note:: You can find kernel recipes in the ``meta/recipes-kernel/linux`` directory - of the :ref:`overview-manual/development-environment:yocto project source repositories` - (e.g. ``poky/meta/recipes-kernel/linux/linux-yocto_4.12.bb``). See the + of the :ref:`overview-manual/development-environment:yocto project source repositories`. See the ":ref:`kernel-dev/advanced:using kernel metadata in a recipe`" section for more information. From patchwork Thu Jan 29 15:22:57 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79988 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 94985D61033 for ; Thu, 29 Jan 2026 15:24:18 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.17088.1769700249233564193 for ; Thu, 29 Jan 2026 07:24:09 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=LK6eFv7P; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id 9AC8AC22F47 for ; Thu, 29 Jan 2026 15:24:10 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 96BF0606FD for ; Thu, 29 Jan 2026 15:24:07 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id F2331119A8853; Thu, 29 Jan 2026 16:24:06 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700247; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=aalmdJwSS4yLbioFayyEDwxcGdCJZrwXg3DlXqPK1lk=; b=LK6eFv7PTasawSGPvUnM95flWAmDqx/oFdy6/zqeokb1SXxdIO540ycKe7YPnNCDVI+onk Eg7tzpaXLzlgaDps4cH6H8gEZDIEu8XiuQfcXwiqiAKYczc7xiZSMy+XlOL/5IEzRrFDGr VztyQ7cGawBLmbwa1mtJkXLzH3c0n1RfxTfxTntf210ebcsljDmpIpn2J4FDItyko4PMPP PpiekuM3+vroWTMJw1uhiwNGlrJYmN5qp3gc0H+LnbR4mAWVa4T6zP7+4pwO5LqoUx99gN Dvkz16maErp0EL6Zo6qvDhqv+Gv1rXayjGrMEflUTEPIhhLcDia3Ra87pl8ecg== From: Antonin Godard Date: Thu, 29 Jan 2026 16:22:57 +0100 Subject: [PATCH v3 06/57] contributor-guide/submit-changes.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-6-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=6375; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=TNQdQZokhHUSO7oHJ757hNlJdO6WEQn6epJXAkrREPk=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uKCAwfbYYahnu4jrFeeEcZwiL6albPYmy79 Kwt6XzhX0+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7igAKCRDRgEFAKaOo Nu5xD/0W4AwXm5Q+zrXY0WM+HPc5wMomBT18j8AhDdLm8V0FluHmzQCNGUWFwPzzFocpVRR5HMb OZwjUjmy39pOL6+Y/aD1WU52rVMsgTn/sat113oHCQCa9C3HCtLgKKQT7/rB0C4n96eX+vByZLb zsKX/9lGTYhfN3/tkgDtb8l0eeRR0c/x7A/4uUdgk3UDTxeJrtgZP5ipoYOq+3CUwgm1GK3FpaD WA6TWqZOrEvz8Nfx3mvczZvvhfdsXHtTG7uSAjXDYR2DbEg87s983LYEKm73aJSbXCucb5obzS8 CK6I1vR7oR9hxiMXKhiX4sT+/gGsWmg4XGDk2aju4aXP2L1ywYHoqQXT2T2TBv28Q/ZcFL5JBe2 UYomLP8J94n5PHAnQnQIyllEsurNTWFsn18Tb/wc4CAsDSskt781EbAevDdoniVndJJe3l2PRBG S66LInsONQeBB0KI7h0qNj5Z0SJq+yQ4OPZTUzx8mLHXDhphfUdnrENUgolw3tcEo1SAxNwATv7 YFevQskhfKmjFfL7Jbjt0VNpZwh2aqudPwtJcpib/ZhPjxaXHDJbqmfFk/3NkqhZEp7CVrheLVL k2fBE3tztGCzY9Tt5fzXGakkJ7gVpRJXI6PqFMHzDZZuVr4Te9vQ6pxkFT4xYsBTiFphWj3awQp Jhlu85RE24XVhzw== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8792 Remove references to the Poky repository, replace by OpenEmbedded-Core in most cases. Signed-off-by: Antonin Godard --- documentation/contributor-guide/submit-changes.rst | 60 ++++++---------------- 1 file changed, 16 insertions(+), 44 deletions(-) diff --git a/documentation/contributor-guide/submit-changes.rst b/documentation/contributor-guide/submit-changes.rst index 07989d7b6..089fec02a 100644 --- a/documentation/contributor-guide/submit-changes.rst +++ b/documentation/contributor-guide/submit-changes.rst @@ -429,38 +429,8 @@ and then based on successful testing, merges them. In general, each component (e.g. layer) should have a ``README`` file that indicates where to send the changes and which process to follow. -The "poky" repository, which is the Yocto Project's reference build -environment, is a hybrid repository that contains several individual -pieces (e.g. BitBake, Metadata, documentation, and so forth) built using -the combo-layer tool. The upstream location used for submitting changes -varies by component: - -- *Core Metadata:* Send your patches to the - :oe_lists:`openembedded-core ` - mailing list. For example, a change to anything under the ``meta`` or - ``scripts`` directories should be sent to this mailing list. - -- *BitBake:* For changes to BitBake (i.e. anything under the - ``bitbake`` directory), send your patches to the - :oe_lists:`bitbake-devel ` - mailing list. - -- *meta-poky* and *meta-yocto-bsp* trees: These trees contain Metadata. Use the - :yocto_lists:`poky ` mailing list. - -- *Documentation*: For changes to the Yocto Project documentation, use the - :yocto_lists:`docs ` mailing list. - -For changes to other layers and tools hosted in the Yocto Project source -repositories (i.e. :yocto_git:`git.yoctoproject.org <>`), use the -:yocto_lists:`yocto-patches ` general mailing list. - -For changes to other layers hosted in the OpenEmbedded source -repositories (i.e. :oe_git:`git.openembedded.org <>`), use -the :oe_lists:`openembedded-devel ` -mailing list, unless specified otherwise in the layer's ``README`` file. - -If you intend to submit a new recipe that neither fits into the core Metadata, +If you intend to submit a new recipe that neither fits in +:term:`OpenEmbedded-Core (OE-Core)`, nor into :oe_git:`meta-openembedded `, you should look for a suitable layer in https://layers.openembedded.org. If similar recipes can be expected, you may consider :ref:`dev-manual/layers:creating your own layer`. @@ -620,7 +590,7 @@ have been followed: methods to find out: - *Maintenance File:* Examine the ``maintainers.inc`` file, which is - located in the :term:`Source Directory` at + located in :term:`OpenEmbedded-Core (OE-Core)` at ``meta/conf/distro/include``, to see who is responsible for code. - *Search by File:* Using :ref:`overview-manual/development-environment:git`, you can @@ -645,9 +615,8 @@ have been followed: The Yocto Project provides two scripts that conveniently let you generate and send pull requests to the Yocto Project. These scripts are ``create-pull-request`` and ``send-pull-request``. You can find - these scripts in the ``scripts`` directory within the - :term:`Source Directory` (e.g. - ``poky/scripts``). + these scripts in the ``scripts`` directory within + :term:`OpenEmbedded-Core (OE-Core)`. Using these scripts correctly formats the requests without introducing any whitespace or HTML formatting. The maintainer that @@ -660,7 +629,7 @@ have been followed: directory into which you pushed the change, and provides a subject line in the created patch files:: - $ poky/scripts/create-pull-request -u meta-intel-contrib -s "Updated Manual Section Reference in README" + $ ./scripts/create-pull-request -u meta-intel-contrib -s "Updated Manual Section Reference in README" Running this script forms ``*.patch`` files in a folder named ``pull-``\ `PID` in the current directory. One of the patch files is a @@ -673,7 +642,7 @@ have been followed: and email address. In this example, the email address is a mailing list:: - $ poky/scripts/send-pull-request -p ~/meta-intel/pull-10565 -t meta-intel@lists.yoctoproject.org + $ ./scripts/send-pull-request -p ~/meta-intel/pull-10565 -t meta-intel@lists.yoctoproject.org You need to follow the prompts as the script is interactive. @@ -682,8 +651,8 @@ have been followed: For help on using these scripts, simply provide the ``-h`` argument as follows:: - $ poky/scripts/create-pull-request -h - $ poky/scripts/send-pull-request -h + $ ./scripts/create-pull-request -h + $ ./scripts/send-pull-request -h Submitting Changes to Stable Release Branches ============================================= @@ -857,14 +826,17 @@ used testing branches for OpenEmbedded-Core are as follows: :oe_git:`openembedded-core ` repository and contains proposed changes to the core metadata. -- *poky "master-next" branch:* This branch is part of the - :yocto_git:`poky ` repository and combines proposed - changes to BitBake, the core metadata and the poky distro. +- *bitbake "master-next" branch:* This branch is part of the :oe_git:`bitbake + ` repository and contains changes to :term:`BitBake`. + +- *meta-yocto "master-next" branch:* This branch is part of the + :yocto_git:`meta-yocto ` repository and contains proposed + changes to meta-yocto. Similarly, stable branches maintained by the project may have corresponding ``-next`` branches which collect proposed changes. For example, ``&DISTRO_NAME_NO_CAP;-next`` and ``&DISTRO_NAME_NO_CAP_MINUS_ONE;-next`` -branches in both the "openembdedded-core" and "poky" repositories. +branches in both the "openembedded-core" and "meta-yocto" repositories. Other layers may have similar testing branches but there is no formal requirement or standard for these so please check the documentation for the From patchwork Thu Jan 29 15:22:58 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79991 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 A1CF6D61037 for ; Thu, 29 Jan 2026 15:24:18 +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.17089.1769700249915393089 for ; Thu, 29 Jan 2026 07:24:10 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=tTu/dGQo; 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 651FD1A2B0D for ; Thu, 29 Jan 2026 15:24:08 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 3AFC7606FD; Thu, 29 Jan 2026 15:24:08 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 86F75119A868E; Thu, 29 Jan 2026 16:24:07 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700247; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=KrGSLod6/pF3KhZZTNTuzimytOCaLoIcbvZ9NCgkBj4=; b=tTu/dGQo6Yam21y8CUQnwd6oE0+jPmRVaOqsU+/5RZYl9rjmFV/ssBzO0lYBl/aTQzdZQm ymnSMZ9m9KhX7tZyOylCPtuYaX2ZCFOs9T8h0RqS3YpzkcDPpgXtZd6ThiiAV5QNOCwTYf vnlu204CFElHLBtvPEqvHAofjyzOy/z21i9z3jiNl4YgeLaeni8FLrXFLhTY/iVg1ayBx+ 7FvBXuSpSHeYm4JxOBCL0OrfzOXN7z1BZTTP43o418+pH5lusIcx3+5VDVWMvbvmKgSKBG MYE5xl0b3oeqhvK7mh0UawBGfpQoJL64t8p5V7Ud6uWzdamSZRulnK9eTNc7aQ== From: Antonin Godard Date: Thu, 29 Jan 2026 16:22:58 +0100 Subject: [PATCH v3 07/57] dev-manual/building.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-7-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=4753; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=ryvQVG/eyTh6kzdj/GUta8S5C90K1sgHkpde0Vbck1U=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uKbFz9xjEiQ/STYaJ6oF2Aay4zRfJT/FENi VpCM3yhDBOJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7igAKCRDRgEFAKaOo NvtQEACymHY91ClrjXVD7qnEyiWrCQFmLiWe8qwWOkk1Nzr39ghAITpVQ6FoioYOoOUVTtl2a68 rGi8MNQmQYP0AeqQ7Rp3Mb1zhNfPPhNFqBf54g4hLM0KVrwJjddhKkZJ4TY2ssbz/8Zs8/lqnib x0BXQ00oLWPummKjdc/5MBwPEg3XmZ+iQz8zO5HUZGSJFm9y1ST7AyYgKrOGSDJ84W9TmWBM1kO erb8pIzHDd/4WGoA2L6l+t0/5zTTk9wodPa8LcpAa4I05tD79vSnxPcj0oaqH/wS5S3x+YRSeGC DAf61N2UNx+ubhSTAmwdPbsTs8P8eDNbddQvCQlOU4JQbGV8PPiLPyBmi10P36AdupvJ2iw036x rIYgtrRII2EL395Zfp/jW8xzdTITq0XBfmockLk4CnALyJ8UbaJA6uhAVRDrHsCYqdz/McjLLXx mmTrvkxHDKK4ANM1RByEiZA8IKg9YYEcA+7CnSgqrBFUYUmcj5A2fASORq/mgBS6bz7ENI1DMeA luwgVD2/4QeIdfVNFym9TnSUdzXg96kh/oAApCcuqfsCYFlMr0kUyuHGfet6phuAEddTR7al6Vq cBHeEXzqqWL09V2Kejyb0pHbrcgM1BUguC8h35RWyU6DZS8O0ttFUNrVfngCR0A7M2DO+QL2kHP Qe8pDA1vPiKC5hg== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8793 Remove references to the Poky repository, replace by OpenEmbedded-Core in most cases. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/building.rst | 40 +++++++--------------------------- documentation/ref-manual/fragments.rst | 2 ++ 2 files changed, 10 insertions(+), 32 deletions(-) diff --git a/documentation/dev-manual/building.rst b/documentation/dev-manual/building.rst index 60ad11f52..c153eb9de 100644 --- a/documentation/dev-manual/building.rst +++ b/documentation/dev-manual/building.rst @@ -51,32 +51,9 @@ The following figure and list overviews the build process: Yocto Project*: See the ":doc:`/dev-manual/start`" section for options on how to get a build host ready to use the Yocto Project. -#. *Initialize the Build Environment:* Initialize the build environment - by sourcing the build environment script (i.e. - :ref:`structure-core-script`):: - - $ source oe-init-build-env [build_dir] - - When you use the initialization script, the OpenEmbedded build system - uses ``build`` as the default :term:`Build Directory` in your current work - directory. You can use a `build_dir` argument with the script to - specify a different :term:`Build Directory`. - - .. note:: - - A common practice is to use a different :term:`Build Directory` for - different targets; for example, ``~/build/x86`` for a ``qemux86`` - target, and ``~/build/arm`` for a ``qemuarm`` target. In any - event, it's typically cleaner to locate the :term:`Build Directory` - somewhere outside of your source directory. - -#. *Make Sure Your* ``local.conf`` *File is Correct*: Ensure the - ``conf/local.conf`` configuration file, which is found in the - :term:`Build Directory`, is set up how you want it. This file defines many - aspects of the build environment including the target machine architecture - through the :term:`MACHINE` variable, the packaging format used during - the build (:term:`PACKAGE_CLASSES`), and a centralized tarball download - directory through the :term:`DL_DIR` variable. +#. *Make Sure Your Configuration is Correct*: Use :ref:`bitbake-config-build ` to + define the :term:`MACHINE` or :term:`DISTRO`, and open your + :ref:`structure-build-conf-site.conf` file to set site-specific settings. #. *Build the Image:* Build the image using the ``bitbake`` command:: @@ -88,8 +65,8 @@ The following figure and list overviews the build process: The target is the name of the recipe you want to build. Common targets are the images in ``meta/recipes-core/images``, - ``meta/recipes-sato/images``, and so forth all found in the - :term:`Source Directory`. Alternatively, the target + ``meta/recipes-sato/images``, and so forth all found in + :term:`OpenEmbedded-Core (OE-Core)`. Alternatively, the target can be the name of a recipe for a specific piece of software such as BusyBox. For more details about the images the OpenEmbedded build system supports, see the @@ -127,7 +104,7 @@ Follow these steps to create an :term:`Initramfs` image: #. *Create the Initramfs Image Recipe:* You can reference the ``core-image-minimal-initramfs.bb`` recipe found in the - ``meta/recipes-core`` directory of the :term:`Source Directory` + ``meta/recipes-core`` directory in :term:`OpenEmbedded-Core (OE-Core)` as an example from which to work. The ``core-image-minimal-initramfs`` recipe is based on the :ref:`initramfs-framework ` recipe described below. @@ -366,9 +343,8 @@ memory used for decompressing the kernel and for the ``__init__`` functions. To help you see where you currently are with kernel and root filesystem -sizes, you can use two tools found in the :term:`Source Directory` -in the -``scripts/tiny/`` directory: +sizes, you can use two tools found in :term:`OpenEmbedded-Core (OE-Core)` +in the ``scripts/tiny/`` directory: - ``ksize.py``: Reports component sizes for the kernel build objects. diff --git a/documentation/ref-manual/fragments.rst b/documentation/ref-manual/fragments.rst index 42fba41e9..9449f4648 100644 --- a/documentation/ref-manual/fragments.rst +++ b/documentation/ref-manual/fragments.rst @@ -22,6 +22,8 @@ System` core repositories. :doc:`/dev-manual/creating-fragments` section of the Yocto Project Development Tasks Manual. +.. _ref-bitbake-config-build-qf: + ``bitbake-config-build`` Quick Reference ======================================== From patchwork Thu Jan 29 15:22:59 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79992 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 B0FD4D6103B for ; Thu, 29 Jan 2026 15:24:18 +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.17187.1769700250644824682 for ; Thu, 29 Jan 2026 07:24:11 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=DLMOSOcv; 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 215E54E4231D for ; Thu, 29 Jan 2026 15:24:09 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id E69CE606FD; Thu, 29 Jan 2026 15:24:08 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 1FDEC119A8856; Thu, 29 Jan 2026 16:24:08 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700248; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=VpQz2X9a1/mJo9P8xhWGzblvjXHHwYgnSxuE76JQgm4=; b=DLMOSOcv+PcdkPemGT88hXXM8fsqZb3RQC+zVP400BWdRKaK0ljVDEqa8s/uzy9XzyH0y3 YlewTuJrfF+bmUdVknYKthycNtcxmiVa3SNcU4otLU7j1DuWNPZ49f6HLFjV90VYdJwsgF oFKLf0tQ202e2KVIrB0/EY5XCWMBhTARgMDX6oTRa+3wXodcxQKhQdtFtf98/CpoaA5BVn eoRNl9CcPSWSNndMOucdYS0gThflJ6HIIN1mg7KsaSSZ3ViNDrQDhdOXZ7ATvwgGC505zT KX+ridtV9kUAUKt81SwDo/0EQScMSkgie1/iBBkRbKvoXJ6YpjrtUDU6ZGsivQ== From: Antonin Godard Date: Thu, 29 Jan 2026 16:22:59 +0100 Subject: [PATCH v3 08/57] dev-manual/debugging.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-8-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=3114; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=Q1Jab2vkTEJhjQAE57aYSWn2KYo23aMy8ev/8mZyUAM=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uK8vy8UxiqgmntYuwyR/R3+urRi8H6s6HVO q0BDo7SqgCJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7igAKCRDRgEFAKaOo NoIaD/93UqrBRBz9wU7LwvDj/Dw02g6XOF+7qU1uA56EGAKA5rn5MvCPewvmnSz4tqeOnolKyp1 QQPu4l00zYkVAwrHGBTRtBlR/DkGc7McykkkRdzOaann0AiyY5bC2AhHwutrBtYDwdWoKPXOTRL 2GFWBHwR7Lukdg+PLwRCJkCRVM5gJrxz5nbD4v/vbq0GvvikHjwtfY345EYylEdKviLcg3JYxPz epH6qzda/mo6e7FVID13eS9JfTaHGNLRGfUb9189PX/dGaL1gmomdtHk/KzFsAUoFJpwhTB8fem 8edJ98RX4dLutwGYvkXhVTkAiNHUx1VRGCqH7k/GLr2RHtqBYUt4PvgwGw8BFmKRp5ffKRcnMkl vMdSfEjgmwMvnqNl/Ycs8P0BWPMvlcFFnmPH9l08o/yC1/hp4BOrBdBFrUwZIr5px7rVNYV24G1 LjJ5dadvo/B9v/1B5UoZ+IA1jjrZFZyIdpmQuHOj9ohhWnSlFnpwr3RDDGVOenEJhuS6kfPRsqb SIq0s8MdwqrpKw+6TofsdzxuHR1BhX2q++fx9qSN5CtZZxu6So3BNapt++KGreZqdHOr4xkfJFW Pcbhi/MwuGUOT+zscfasFwwbbh0YkBx7HVVwQSqR5+GMkySInJemqiL3gineEdNmfp8dDiVd7u1 FFaDwI7rnwf6qig== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8794 Remove references to the Poky repository, replace by OpenEmbedded-Core. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/debugging.rst | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/documentation/dev-manual/debugging.rst b/documentation/dev-manual/debugging.rst index 0202f1b32..21fb10537 100644 --- a/documentation/dev-manual/debugging.rst +++ b/documentation/dev-manual/debugging.rst @@ -439,7 +439,7 @@ the build system to run the task again. For an example of a commit that makes a cosmetic change to invalidate shared state, see this - :yocto_git:`commit `. + :oe_git:`commit `. Running Specific Tasks ====================== @@ -522,7 +522,7 @@ task dependency mechanisms. .. code-block:: none - WARNING: /home/ulf/poky/meta/recipes-sato/matchbox-desktop/matchbox-desktop_2.1.bb.do_compile is tainted from a forced run + WARNING: /home/ulf/openembedded-core/meta/recipes-sato/matchbox-desktop/matchbox-desktop_2.1.bb.do_compile is tainted from a forced run The purpose of the warning is to let you know that the work directory @@ -615,7 +615,7 @@ The same logging functions are also available in shell functions, under the names ``bbplain``, ``bbnote``, ``bbdebug``, ``bbwarn``, ``bberror``, and ``bbfatal``. The :ref:`ref-classes-logging` class implements these functions. See that class in the ``meta/classes`` -folder of the :term:`Source Directory` for information. +folder of :term:`OpenEmbedded-Core (OE-Core)` for information. Logging With Python ------------------- @@ -852,10 +852,10 @@ patch:: Refreshed patch patches/parallelmake.patch Once the patch file is created, you need to add it back to the originating -recipe folder. Here is an example assuming a top-level -:term:`Source Directory` named ``poky``:: +recipe folder. Here is an example assuming :term:`OpenEmbedded-Core (OE-Core)` +is named ``openembedded-core``:: - $ cp patches/parallelmake.patch poky/meta/recipes-connectivity/neard/neard + $ cp patches/parallelmake.patch openembedded-core/meta/recipes-connectivity/neard/neard The final thing you need to do to implement the fix in the build is to update the "neard" recipe (i.e. ``neard-0.14.bb``) so that the @@ -940,7 +940,9 @@ debug symbols from the server. To run a ``debuginfod`` server, you need to do the following: - Ensure that ``debuginfod`` is present in :term:`DISTRO_FEATURES` - (it already is in ``OpenEmbedded-core`` defaults and ``poky`` reference distribution). + (it already is in :term:`OpenEmbedded-Core (OE-Core)` defaults and + :term:`Poky` reference distribution). + If not, set in your distro config file or in ``local.conf``:: DISTRO_FEATURES:append = " debuginfod" From patchwork Thu Jan 29 15:23:00 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79993 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 BBF8FD6103E for ; Thu, 29 Jan 2026 15:24:18 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.17090.1769700251135190745 for ; Thu, 29 Jan 2026 07:24:11 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=NKBnm8q3; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id 7E5F2C22F4B for ; Thu, 29 Jan 2026 15:24:12 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 7D25E606FD; Thu, 29 Jan 2026 15:24:09 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id CCD88119A8857; Thu, 29 Jan 2026 16:24:08 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700249; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=RcoZAVkC2xd1vdNzm9mBNhC9lv+3H3WZEMwCWoDNULs=; b=NKBnm8q35tJGx7o40/WrffTieoZH64Ism5Lzd2Wa/FuREyl5tQhqCnLN39SSPANEFkhtrf kxnBbSG0FI4/WbGKqvjaNFf3Lk8u3FqMLLWA+VOLMMb0u7pqJ6lynEMuzVp4UoB8gaW6Uo uSugJnXeoWzl7jHpVfQqmTonxayZLlRHuGcWZ0K4CV0ILlKRN2cy1+3pivv03ETPywQbhk HgKBx1/mqsmSsNnhIfJN1kPoJ8d+d2NWWXb27/pk1AyWN1Z6nY3GVv/scNI4asptMEy+eZ 7FqC5XyU6EbkTuFTNd93tP4JZ6E/lNRub6ELsL7naA0hqu2zbPuNkx9VcsHE3A== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:00 +0100 Subject: [PATCH v3 09/57] dev-manual/error-reporting-tool.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-9-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1172; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=0eU4EKBkNs9mm4UTEc+aHxZz+sIAnPFWJKRuUrBg6N8=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uKbUFz/DTVEuA07cr7hd8rKn7CYcGxiJEqZ RyF1fS75tOJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7igAKCRDRgEFAKaOo NqEwEAC8KovWAhjXJU0Bh+03uNvtFGkHXJ6iNPAD3hA3lnG7lQ5TWMNocUI7tdiokGoSHYellyJ 9d+AtJVQ1BL40HiPdRZxU7Lq3zZzOIbkW98Oz+chsix3cCbd4y8fCJW8quy4myV1kBPcpGuxwPL uTw3WS24+5EkUTqq7stgLT3SSNMnw0UkFZNvzmPkgQWeswFI5XBdTFPOt5fqsrrGSTRVob/5HPM 2AYSv7NQ8FYCVGCqkWjX7vnwy6ZOfNRY8NkMSMdb8XinGbid343LJcROroueEEXayBb5KJhE1eP 2JYSOCUlozzkyWH39ayUzm0sl6N+bs6NxAujl2q3nCn5FaM0U9vb4dA4YFsOFrP9XvoYtqJDWCD 1Q7eort4j1WkFU3z3zy1E5GvTfdB2+AePJOGf8gXWwrkD4zukQXjjPdfneo0q5+o+l1dviK4oAe BaaY2L56ZcqcQnjF8g+Ij/qBUqstNfI6FFUlRr0tcuvoRuR28g0EvO0FqG8aN/JBi4mteqaJzUG 6EHRurU2zCI6l3JqEtW9zD+EFRNKPnr5Yw65L6simfbUOGBM+QnH/DGwxRpR0/2Yu/4jSTVaVj6 caSpYQB07GV6Qg3TCTI8wOyqYMUXvj9bgPScdM4YVlNhRSQSDhjdpzPUfA1jiVDn9emHBG2eQNe x6qL3nzF6tGARag== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8795 Remove the single poky repository reference in this document, after the poky repository was obsoleted. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/error-reporting-tool.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/documentation/dev-manual/error-reporting-tool.rst b/documentation/dev-manual/error-reporting-tool.rst index 84f3d9cd1e..30d1ce2b31 100644 --- a/documentation/dev-manual/error-reporting-tool.rst +++ b/documentation/dev-manual/error-reporting-tool.rst @@ -7,8 +7,7 @@ The error reporting tool allows you to submit errors encountered during builds to a central database. Outside of the build environment, you can use a web interface to browse errors, view statistics, and query for errors. The tool works using a client-server system where the client -portion is integrated with the installed Yocto Project -:term:`Source Directory` (e.g. ``poky``). +portion is integrated in :term:`OpenEmbedded-Core (OE-Core)`. The server receives the information collected and saves it in a database. From patchwork Thu Jan 29 15:23:01 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79996 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 C3691D358C7 for ; Thu, 29 Jan 2026 15:24:18 +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.17091.1769700251847020781 for ; Thu, 29 Jan 2026 07:24:12 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=Te87yZAo; 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 5AB121A2B0C; Thu, 29 Jan 2026 15:24:10 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 31FB3606FD; Thu, 29 Jan 2026 15:24:10 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 5F40C119A868D; Thu, 29 Jan 2026 16:24:09 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700249; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=VpYKcDTTcogeqaCVbM4jBAFNeloASAcPE4C0A6b/u0U=; b=Te87yZAoBu12aUKanXYNXWUPiRftf98NLtdDUvT3/ulymFsDpwclfQ/hEQjnsfTpb39yod 5tGNWTZR5PeEwIO3WfP16DQAUq7U8owastVnzV87NIQEjRDiZ/idkvPxk1r9tg8HX7RmYj kwS5V10xvAkwDgnuQB28f2Uljfg1sUZFtsNpv+uVlGoS6AC4Bu2ZSBoMOCcmIBUjfJj8aS tTYokJe9Jyz55Y0DItvAWTBjdNOndHgq1W2UCipHTQIofZLuRfmG1WZD5lxk6lnq4YBrKK pKTz9WvRXsZbr1ITqO40Rnc6N0PQXhk64jz8MtZF5itdgzea0ZAw84XEJrJQjA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:01 +0100 Subject: [PATCH v3 10/57] dev-manual/external-toolchain.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-10-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1144; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=xPKQji/L9AlWcx0v2k/WP7wvR48dGI0uTihbYfUj9tA=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uKkAr/5MXUuaeRksBZl33rWwlMqtZ4oEUxY WZwRWy4SEiJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7igAKCRDRgEFAKaOo Nv8xEACmFRqQj2Jy0qeg/b0IF8g9LUC32zvma9ygy6EkYxiRY0skVxEMXRvI/w54ohp5mC5vbaL 5q1Sdbgr8EHy8Jl4e7UwrbLHRi874mc1IsR/z8+3QkJdcR/afB7PxFlpnnqS7xKN4q4xPE5U/YN jfjsAAZGYwyTgj30B9/mk8RrxWxgUjxO+AsgduhrSgwVxqGlNNbJOxfKJCaMbDtotmYnYWjhRaK D3eATSFrxfjp25W/bEFe1uq0zIRnHwSCnZ4guxQS5Rrf3VoxGd5MEK1Ebo8wCQdMz3Nxv6MEUEg x+j+31zmiXhaR3WTzQIyKLLNGS1g2+F5gA3zNFm00bgC/g6UaYNwrIk0+rpAihoRgod+hfJAZxv L/BFQX743jW5qP1U/eMSpSRRG1Tl472pyJElrsL+KPK2V+SkXxDr2k97P0UqdoTa/AwZw4lhiKQ aK3nxi0Rby7P7cOtWVUqtF56zZhfqDlTz4bs/6tJsDFvO8j3w5CnSUhzf1USnsu8RsR2qrikPxZ ZQsRukdZatAFGqVEz2hGNcUUDQMfYCZhBumnOS+RFeDuSaoq+e52HCkLdvIyzmx7x0lcJXKd+Uw vIRBMXmJwUvPhMrXT9XoC8ghngH/KmhrtmllJrcJy13EJyn0vDaAcnJRXQGtdGANz4Ad+TrEYaQ IF1M9ECnURorXkQ== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8796 Remove the single poky repository reference in this document, after the poky repository was obsoleted. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/external-toolchain.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/dev-manual/external-toolchain.rst b/documentation/dev-manual/external-toolchain.rst index 238f8cf467..29459ea120 100644 --- a/documentation/dev-manual/external-toolchain.rst +++ b/documentation/dev-manual/external-toolchain.rst @@ -21,7 +21,7 @@ follows: The toolchain configuration is very flexible and customizable. It is primarily controlled with the :term:`TCMODE` variable. This variable controls which ``tcmode-*.inc`` file to include from the -``meta/conf/distro/include`` directory within the :term:`Source Directory`. +``meta/conf/distro/include`` directory within :term:`OpenEmbedded-Core (OE-Core)`. The default value of :term:`TCMODE` is "default", which tells the OpenEmbedded build system to use its internally built toolchain (i.e. From patchwork Thu Jan 29 15:23:02 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79997 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 D8E33D358D6 for ; Thu, 29 Jan 2026 15:24:18 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17188.1769700252950660784 for ; Thu, 29 Jan 2026 07:24:13 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=2b6lubcR; 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 6F0AE1A2B09; Thu, 29 Jan 2026 15:24:11 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 46743606FD; Thu, 29 Jan 2026 15:24:11 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 0873E119A868E; Thu, 29 Jan 2026 16:24:09 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700250; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=XyUJ6tzVSh5Qi9DwIKW9xkL57tSd2sm6bUF5hSTnACM=; b=2b6lubcR9xB24uZWyPybkhejnSOWM5W2VRUBSH1QNUYx4jhVQsVK1kI7SHKANGVlnS7jZ6 2t7T025yJqZvKCGIWzfrCjH9qYqhaFFDqEMM1JRU8LD9q39WXcBSAOVgOd9UCrg4BLYEEe zAgYsyW5cbIAXrHosHAI/XT2o9bIJxhLQYM+zFqRI/a10fY/DJrKvSFguC/C1BYx4/hZ30 EcFGdzfokUY5Sc2Hf6lkCqI9yyGP0XdDuhmfEYYIducHVN+kn05P2oanNey/gdlhZ/tbQC T7lP9IwVRHSRyUjJqu63Kuhp2+/3+h7BzCe4huAd2WGgqcY+c1BflcobFPg6ZA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:02 +0100 Subject: [PATCH v3 11/57] dev-manual/layers.rst: re-organize the document MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-11-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=20382; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=lh3xmZb4r12HR7D89r/yfXTY8lB43UsQCdKpB3ltHaE=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uKQcQlDcUShScaRsVtNLa00lehAXDcTd1F6 3bHjbSVc0uJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7igAKCRDRgEFAKaOo NuRoD/9tm/iychNhVmGIZD4r1Y9BSMv1cqm21+lB3TyaD2lVPjV0TvqkE4ZJC3elkIKnoP1lQdO CLgNaoD1W/36qxfCYybzZbM3xjhKcAQSWfTI/WKuAt9AF60SDu8Yi+26X3J9boMi614pFIB6uTx faYyP6z/jRQ31xKeRfjmLuFnyYPly8nJ3Sg7/JxgGQ/e4bpJAlG3IPz4XaTK1SZzcO17JnycvIX Z8O23JpppqPPM6Si6+WffF5xlg1orkgquJE5UUUQVHnh7JpjkFSsG6fHoiVGRWTbn5O7k+cb97o W6HMVdA4V25VR2iO+Mo7BKntM7IvJ3b9KWB4M3xspSSnCcnW0EQ+pXM0Y3xcSqnKEye5skV5fCV qcTD5LtHYWmkot+sdz3KxxbSc7oHn/NDw7GvEeeymCtpIjUwOzq5b7DcI8u2i/3/sKJiW6ZYgCe WBP41rrMRX+XeKnB0HUPBfjQMKBR7F/6XZcB+rGhb81MNNaMhHX7iJuwW10z4C+NzOrsr6cDbUN Y4g7i015jtt/aBqWx1TIF3Lkvz12i+oGHeopVFqK03GqVj4CNVlQNWibp6F/0RFKgcwJB7HkrjB U2ISThID3RLZ81clCgejIjggptzPOkJ0ZNeBPvYxfpcXb8IEWcy7+AmvoBhneli7aXB8i4Inkby CX5GpLKbIJroodA== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8797 The first section of the layers document shows how to manually create a layer step-by-step, and references bitbake-layers create-layer at the end. Change the approach of this section to show how to use the bitbake-layers create-layer command to create a layer, and then explain how a layer is organized and configured. This avoids repetition, and we should encourage users to use pre-built tools when they can do things in a less error-prone way. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/brief-yoctoprojectqs/index.rst | 2 +- documentation/bsp-guide/bsp.rst | 2 +- documentation/dev-manual/custom-distribution.rst | 2 +- documentation/dev-manual/layers.rst | 277 ++++++++------------- documentation/kernel-dev/common.rst | 6 +- .../transitioning-to-a-custom-environment.rst | 3 +- 6 files changed, 110 insertions(+), 182 deletions(-) diff --git a/documentation/brief-yoctoprojectqs/index.rst b/documentation/brief-yoctoprojectqs/index.rst index 84eb63c937..903dc242eb 100644 --- a/documentation/brief-yoctoprojectqs/index.rst +++ b/documentation/brief-yoctoprojectqs/index.rst @@ -452,7 +452,7 @@ The following commands run the tool to create a layer named For more information on layers and how to create them, see the -:ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script` +:ref:`dev-manual/layers:Creating Your Own Layer` section in the Yocto Project Development Tasks Manual. Where To Go Next diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst index 343b2753c0..4a89d691aa 100644 --- a/documentation/bsp-guide/bsp.rst +++ b/documentation/bsp-guide/bsp.rst @@ -1155,7 +1155,7 @@ Use these steps to create a BSP layer: ``create-layer`` subcommand to create a new general layer. For instructions on how to create a general layer using the ``bitbake-layers`` script, see the - ":ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script`" + ":ref:`dev-manual/layers:Creating Your Own Layer`" section in the Yocto Project Development Tasks Manual. - *Create a Layer Configuration File:* Every layer needs a layer diff --git a/documentation/dev-manual/custom-distribution.rst b/documentation/dev-manual/custom-distribution.rst index 0bc386d606..55854f00ea 100644 --- a/documentation/dev-manual/custom-distribution.rst +++ b/documentation/dev-manual/custom-distribution.rst @@ -27,7 +27,7 @@ layer. The following steps provide some more detail: just placing configurations in a ``local.conf`` configuration file makes it easier to reproduce the same build configuration when using multiple build machines. See the - ":ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script`" + ":ref:`dev-manual/layers:Creating Your Own Layer`" section for information on how to quickly set up a layer. - *Create the distribution configuration file:* The distribution diff --git a/documentation/dev-manual/layers.rst b/documentation/dev-manual/layers.rst index 667708e32b..5abd116be8 100644 --- a/documentation/dev-manual/layers.rst +++ b/documentation/dev-manual/layers.rst @@ -14,18 +14,6 @@ section in the Yocto Project Overview and Concepts Manual. Creating Your Own Layer ======================= -.. note:: - - It is very easy to create your own layers to use with the OpenEmbedded - build system, as the Yocto Project ships with tools that speed up creating - layers. This section describes the steps you perform by hand to create - layers so that you can better understand them. For information about the - layer-creation tools, see the - ":ref:`bsp-guide/bsp:creating a new bsp layer using the \`\`bitbake-layers\`\` script`" - section in the Yocto Project Board Support Package (BSP) Developer's - Guide and the ":ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script`" - section further down in this manual. - Follow these general steps to create your layer without using tools: #. *Check Existing Layers:* Before creating a new layer, you should be @@ -35,10 +23,22 @@ Follow these general steps to create your layer without using tools: the Yocto Project. You could find a layer that is identical or close to what you need. -#. *Create a Directory:* Create the directory for your layer. When you - create the layer, be sure to create the directory in an area not - associated with the Yocto Project :term:`Source Directory` - (e.g. the cloned ``poky`` repository). + .. note:: + + For information on BSP layers, see the ":ref:`bsp-guide/bsp:bsp layers`" + section in the Yocto Project Board Specific (BSP) Developer's Guide. + +#. *Create a new Layer:* Create the directory for your layer. The + ``bitbake-layers`` script with the ``create-layer`` subcommand simplifies + creating a new general layer. Place it next to the other layers in your + :term:`Source Directory`. + + In its simplest form, you can use the following command to create a + layer named "your_layer_name" in the current directory: + + .. code-block:: console + + $ bitbake-layers create-layer your_layer_name While not strictly required, prepend the name of the directory with the string "meta-". For example:: @@ -58,88 +58,96 @@ Follow these general steps to create your layer without using tools: "meta-" string are appended to several variables used in the configuration. -#. *Create a Layer Configuration File:* Inside your new layer folder, - you need to create a ``conf/layer.conf`` file. It is easiest to take - an existing layer configuration file and copy that to your layer's - ``conf`` directory and then modify the file as needed. - - The ``meta-yocto-bsp/conf/layer.conf`` file in the Yocto Project - :yocto_git:`Source Repositories ` - demonstrates the required syntax. For your layer, you need to replace - "yoctobsp" with a unique identifier for your layer (e.g. "machinexyz" - for a layer named "meta-machinexyz"):: - - # We have a conf and classes directory, add to BBPATH - BBPATH .= ":${LAYERDIR}" - - # We have recipes-* directories, add to BBFILES - BBFILES += "${LAYERDIR}/recipes-*/*/*.bb \ - ${LAYERDIR}/recipes-*/*/*.bbappend" - - BBFILE_COLLECTIONS += "yoctobsp" - BBFILE_PATTERN_yoctobsp = "^${LAYERDIR}/" - BBFILE_PRIORITY_yoctobsp = "5" - LAYERVERSION_yoctobsp = "4" - LAYERSERIES_COMPAT_yoctobsp = "walnascar" - - Here is an explanation of the layer configuration file: - - - :term:`BBPATH`: Adds the layer's - root directory to BitBake's search path. Through the use of the - :term:`BBPATH` variable, BitBake locates class files (``.bbclass``), - configuration files, and files that are included with ``include`` - and ``require`` statements. For these cases, BitBake uses the - first file that matches the name found in :term:`BBPATH`. This is - similar to the way the ``PATH`` variable is used for binaries. It - is recommended, therefore, that you use unique class and - configuration filenames in your custom layer. - - - :term:`BBFILES`: Defines the - location for all recipes in the layer. - - - :term:`BBFILE_COLLECTIONS`: - Establishes the current layer through a unique identifier that is - used throughout the OpenEmbedded build system to refer to the - layer. In this example, the identifier "yoctobsp" is the - representation for the container layer named "meta-yocto-bsp". - - - :term:`BBFILE_PATTERN`: - Expands immediately during parsing to provide the directory of the - layer. - - - :term:`BBFILE_PRIORITY`: - Establishes a priority to use for recipes in the layer when the - OpenEmbedded build finds recipes of the same name in different - layers. - - - :term:`LAYERVERSION`: - Establishes a version number for the layer. You can use this - version number to specify this exact version of the layer as a - dependency when using the - :term:`LAYERDEPENDS` - variable. - - - :term:`LAYERDEPENDS`: - Lists all layers on which this layer depends (if any). - - - :term:`LAYERSERIES_COMPAT`: - Lists the :yocto_home:`Yocto Project releases ` - for which the current version is compatible. This variable is a good - way to indicate if your particular layer is current. + As an example, the following command creates a layer named ``meta-scottrif`` + in your home directory: + .. code-block:: console - .. note:: + $ bitbake-layers create-layer meta-scottrif + NOTE: Starting bitbake server... + Add your new layer with 'bitbake-layers add-layer meta-scottrif' + + In order to use a layer with the :term:`OpenEmbedded Build System`, you + need to add the layer to your ``bblayers.conf`` configuration + file, as hinted by the previous command. See the + ":ref:`dev-manual/layers:adding a layer using the \`\`bitbake-layers\`\` + script`" section for more information. + + By default, the ``bitbake-layers create-layer`` command creates a layer + with the following: + + - A ``conf/layer.conf`` configuration file with default definitions. + + Here is an explanation of the typical content of the layer configuration file: + + - :term:`BBPATH`: Adds the layer's root directory to BitBake's search + path. Through the use of the :term:`BBPATH` variable, BitBake locates + class files (``.bbclass``), configuration files, and files that are + included with ``include`` and ``require`` statements. For these cases, + BitBake uses the first file that matches the name found in + :term:`BBPATH`. This is similar to the way the ``PATH`` variable is + used for binaries. It is recommended, therefore, that you use unique + class and configuration filenames in your custom layer. + + See the :ref:`bitbake:bitbake-user-manual/bitbake-user-manual-metadata:Locating Include + Files` section of the BitBake User Manual for more details on how + files are included with :term:`BitBake`. + + - :term:`BBFILES`: Defines the location for all recipes in the layer. + + - :term:`BBFILE_COLLECTIONS`: Establishes the current layer through a + unique identifier that is used throughout the :term:`OpenEmbedded Build + System` to refer to the layer. In this example, the identifier + "yoctobsp" is the representation for the container layer named + "meta-yocto-bsp". + + This name is used by other layers when specifying the layer + dependencies via the :term:`LAYERDEPENDS` variable. + + - :term:`BBFILE_PATTERN`: Expands immediately during parsing to provide + the directory of the layer. + + - :term:`BBFILE_PRIORITY`: Establishes a priority to use for recipes in + the layer when the :term:`OpenEmbedded Build System` finds recipes of + the same name in different layers. + + - :term:`LAYERVERSION`: Establishes a version number for the layer. You + can use this version number to specify this exact version of the layer + as a dependency when using the :term:`LAYERDEPENDS` variable. + + - :term:`LAYERDEPENDS`: Lists all layers on which this layer depends (if + any). It uses the layer names specified by the + :term:`BBFILE_COLLECTIONS` variable. + + - :term:`LAYERSERIES_COMPAT`: Lists the :yocto_home:`Yocto Project + release ` codenames (in lowercase) this layer is + compatible with. For example: "&DISTRO_NAME_NO_CAP;". + + This variable is a good way to indicate if a particular layer is + current. + + - A ``recipes-example`` subdirectory that itself contains a + subdirectory named ``example``, which contains an ``example.bb`` + recipe file. + + - A ``COPYING.MIT``, which is the license statement for the layer. The + script assumes you want to use the MIT license, which is typical for + most layers, for the contents of the layer itself. - A layer does not have to contain only recipes ``.bb`` or append files - ``.bbappend``. Generally, developers create layers using - ``bitbake-layers create-layer``. - See ":ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script`", - explaining how the ``layer.conf`` file is created from a template located in - ``meta/lib/bblayers/templates/layer.conf``. - In fact, none of the variables set in ``layer.conf`` are mandatory, - except when :term:`BBFILE_COLLECTIONS` is present. In this case - :term:`LAYERSERIES_COMPAT` and :term:`BBFILE_PATTERN` have to be - defined too. + - A ``README`` file, which is a file describing the contents of your + new layer. + + + If you want to set the priority of the layer to other than the default value + of "6", you can either use the ``--priority`` option or you can edit the + :term:`BBFILE_PRIORITY` value in the ``conf/layer.conf`` after the script + creates it. Furthermore, if you want to give the example recipe file some + name other than the default, you can use the ``--example-recipe-name`` + option. + + The easiest way to see how the ``bitbake-layers create-layer`` command + works is to experiment with the script. You can also read the usage + information by running ``bitbake-layers create-layer --help``. #. *Add Content:* Depending on the type of layer, add the content. If the layer adds support for a machine, add the machine configuration @@ -874,85 +882,6 @@ The following list describes the available commands: - ``show-machines``: Lists the machines available in the currently configured layers. -Creating a General Layer Using the ``bitbake-layers`` Script -============================================================ - -The ``bitbake-layers`` script with the ``create-layer`` subcommand -simplifies creating a new general layer. - -.. note:: - - - For information on BSP layers, see the ":ref:`bsp-guide/bsp:bsp layers`" - section in the Yocto - Project Board Specific (BSP) Developer's Guide. - - - In order to use a layer with the OpenEmbedded build system, you - need to add the layer to your ``bblayers.conf`` configuration - file. See the ":ref:`dev-manual/layers:adding a layer using the \`\`bitbake-layers\`\` script`" - section for more information. - -The default mode of the script's operation with this subcommand is to -create a layer with the following: - -- A layer priority of 6. - -- A ``conf`` subdirectory that contains a ``layer.conf`` file. - -- A ``recipes-example`` subdirectory that contains a further - subdirectory named ``example``, which contains an ``example.bb`` - recipe file. - -- A ``COPYING.MIT``, which is the license statement for the layer. The - script assumes you want to use the MIT license, which is typical for - most layers, for the contents of the layer itself. - -- A ``README`` file, which is a file describing the contents of your - new layer. - -In its simplest form, you can use the following command form to create a -layer. The command creates a layer whose name corresponds to -"your_layer_name" in the current directory:: - - $ bitbake-layers create-layer your_layer_name - -As an example, the following command creates a layer named ``meta-scottrif`` -in your home directory:: - - $ cd /usr/home - $ bitbake-layers create-layer meta-scottrif - NOTE: Starting bitbake server... - Add your new layer with 'bitbake-layers add-layer meta-scottrif' - -If you want to set the priority of the layer to other than the default -value of "6", you can either use the ``--priority`` option or you -can edit the -:term:`BBFILE_PRIORITY` value -in the ``conf/layer.conf`` after the script creates it. Furthermore, if -you want to give the example recipe file some name other than the -default, you can use the ``--example-recipe-name`` option. - -The easiest way to see how the ``bitbake-layers create-layer`` command -works is to experiment with the script. You can also read the usage -information by entering the following:: - - $ bitbake-layers create-layer --help - NOTE: Starting bitbake server... - usage: bitbake-layers create-layer [-h] [--priority PRIORITY] - [--example-recipe-name EXAMPLERECIPE] - layerdir - - Create a basic layer - - positional arguments: - layerdir Layer directory to create - - optional arguments: - -h, --help show this help message and exit - --priority PRIORITY, -p PRIORITY - Layer directory to create - --example-recipe-name EXAMPLERECIPE, -e EXAMPLERECIPE - Filename of the example recipe - Adding a Layer Using the ``bitbake-layers`` Script ================================================== diff --git a/documentation/kernel-dev/common.rst b/documentation/kernel-dev/common.rst index 1e098c158f..2142d31c09 100644 --- a/documentation/kernel-dev/common.rst +++ b/documentation/kernel-dev/common.rst @@ -95,7 +95,7 @@ section: Support (BSP) Developer's Guide, respectively. For information on how to use the ``bitbake-layers create-layer`` command to quickly set up a layer, see the - ":ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script`" + ":ref:`dev-manual/layers:Creating Your Own Layer`" section in the Yocto Project Development Tasks Manual. #. *Inform the BitBake Build Environment About Your Layer:* As directed @@ -190,7 +190,7 @@ section: Support (BSP) Developer's Guide, respectively. For information on how to use the ``bitbake-layers create-layer`` command to quickly set up a layer, see the - ":ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script`" + ":ref:`dev-manual/layers:Creating Your Own Layer`" section in the Yocto Project Development Tasks Manual. #. *Inform the BitBake Build Environment About Your Layer:* As directed @@ -276,7 +276,7 @@ section in the Yocto Project Development Tasks Manual. The Yocto Project comes with many tools that simplify tasks you need to perform. One such tool is the ``bitbake-layers create-layer`` command, which simplifies creating a new layer. See the - ":ref:`dev-manual/layers:creating a general layer using the \`\`bitbake-layers\`\` script`" + ":ref:`dev-manual/layers:Creating Your Own Layer`" section in the Yocto Project Development Tasks Manual for information on how to use this script to quick set up a new layer. diff --git a/documentation/transitioning-to-a-custom-environment.rst b/documentation/transitioning-to-a-custom-environment.rst index e292399f43..bc37345b98 100644 --- a/documentation/transitioning-to-a-custom-environment.rst +++ b/documentation/transitioning-to-a-custom-environment.rst @@ -56,8 +56,7 @@ Transitioning to a custom environment for systems development #. **Add a new layer for any custom recipes and metadata you create**. Use the ``bitbake-layers create-layer`` command. The ``bitbake-layers`` tool also provides a number of other useful layer-related commands. See - :ref:`dev-manual/layers:creating a general layer using the - \`\`bitbake-layers\`\` script` section. + :ref:`dev-manual/layers:Creating Your Own Layer` section. #. **Create your own layer for the BSP you're going to use**. It is not common that you would need to create an entire BSP from scratch From patchwork Thu Jan 29 15:23:03 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79987 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 67DFFD6102A for ; Thu, 29 Jan 2026 15:24:18 +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.17094.1769700253831982863 for ; Thu, 29 Jan 2026 07:24:14 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=EzLD8C3s; 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 54EA41A2B0C for ; Thu, 29 Jan 2026 15:24:12 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 2B436606FD for ; Thu, 29 Jan 2026 15:24:12 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 14B56119A885C; Thu, 29 Jan 2026 16:24:11 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700251; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=VC2PiJ4sl3DPiL4NOIC4fktEAfYszr+z05Qem5cmxCM=; b=EzLD8C3sVexmJp6JU99pejnUXFrDq/MDZDSyhvuOj6FKtx9JtniVr5HlZnRQeSx8UxJpC6 U/atkLkFNWLllGl4S2X9aQuXYr97FmbS2mKVuX6Xg/lulqZRnfqUCAzWt1C5b/bbvQ85me gvJ8fpo6QB5oX5F4ZpXH9u/Y2oBJ9EwEPbVK2qRsIMB15K8TULNDbU4oXeOBUypifOIjWE 6BJrba29yp4jZ6fHPuMjqhnwGiD3cSYrp92JgC99irqic3z4KsY5R1/jTW+2dyxzYZoKqd +V5ImnUxIn7iUzy2sQaYVVxcfQayL2O9ZKM7jXuH5dgh66tbMDfGWso/rogJbA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:03 +0100 Subject: [PATCH v3 12/57] dev-manual/layers.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-12-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=4285; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=qJUuIwl5mZABqNbcadxZkqPuh3/a81Pv/W9sCicjyjE=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uL7DyfddIjU8ZszYcxHTQNQk42K/yIy/Y6o 0yQlhGGu86JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7iwAKCRDRgEFAKaOo NmpiD/9EB3xSMigch1fPJMx/F5hjzRu60+mqMibREjKzwXroobHqzRdt3oOq1hlE3LahJHASw4v AjcK+4NSgF7ziOAkkiUr4DmTWbxqA60cIOAhF+BuGGT2QD+m9Yx9rFJY95TYoNToDOmXZrg3s0l sa7Egh1EJ7fOnaAwQhL3f25bP8ghp1av5mKcy/fTjqhwfeW3TE2C3u/NVQZZOzGC/VgHAWVW6q6 +rpfHN991K5tonXxrdQfTUcqGlhOwwKRRtTV5MOZHzhJYW52desy/5u4Xuq7xe7q0lwkW0hUqyF uzvBbcIk15TEu4ax0EfsolM0Y4qoAjKuaK5PuKWtXi0UcN26w9DEqihdbqvhEljVJa1AG4D27To 04nEp6r9PWyVxttQUmb/ngeVxgICrDp21dCmWOOpiyLnmx0qtCNCqZ+VMEIUoKf6om7GN2mW3h3 IOhtBPGAmHYxQySGZUQnX9tCToYuE8CB/NJdVIt+CDHtYih1sgukFTuaLADbAYd2iqlkS2Tu3vJ 8QFyjs+K6Yu9btwoSf0SzlBC2nB4BUsqJaEdTGCUn7FFsU/QWHWlur+mTu96nluKRByxrlpp2zg kk1x9aaCTaKUGZazVsZGcpu2xrtABH6aivEd/MTFBVBMJ7piwxlwSlZUl1UwoT0qw0tWy571Dt+ 7ZrSitsKlYo5bQQ== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8798 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/dev-manual/layers.rst | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/documentation/dev-manual/layers.rst b/documentation/dev-manual/layers.rst index 5abd116be..b7624cf0e 100644 --- a/documentation/dev-manual/layers.rst +++ b/documentation/dev-manual/layers.rst @@ -290,7 +290,7 @@ following list: repository that use the ``meta-layer_name`` format. - *Group Your Layers Locally:* Clone your repository alongside other - cloned ``meta`` directories from the :term:`Source Directory`. + layers in your :term:`Source Directory`. Making Sure Your Layer is Compatible With Yocto Project ======================================================= @@ -529,10 +529,10 @@ possible. Overlaying a File Using Your Layer ---------------------------------- -As an example, consider the main formfactor recipe and a corresponding -formfactor append file both from the :term:`Source Directory`. +As an example, consider the main ``formfactor`` recipe and a corresponding +``formfactor`` append file both from :term:`OpenEmbedded-Core (OE-Core)`. Here is the main -formfactor recipe, which is named ``formfactor_0.0.bb`` and located in +``formfactor`` recipe, which is named ``formfactor_0.0.bb`` and located in the "meta" layer at ``meta/recipes-bsp/formfactor``:: SUMMARY = "Device formfactor information" @@ -609,8 +609,8 @@ Installing Additional Files Using Your Layer -------------------------------------------- As another example, consider the main ``xserver-xf86-config`` recipe and a -corresponding ``xserver-xf86-config`` append file both from the :term:`Source -Directory`. Here is the main ``xserver-xf86-config`` recipe, which is named +corresponding ``xserver-xf86-config`` append file both from +:term:`OpenEmbedded-Core (OE-Core)`. Here is the main ``xserver-xf86-config`` recipe, which is named ``xserver-xf86-config_0.1.bb`` and located in the "meta" layer at ``meta/recipes-graphics/xorg-xserver``:: @@ -897,7 +897,9 @@ Add your layer by using the ``bitbake-layers add-layer`` command:: Here is an example that adds a layer named ``meta-scottrif`` to the configuration file. Following the command that adds the layer is another ``bitbake-layers`` command that -shows the layers that are in your ``bblayers.conf`` file:: +shows the layers that are in your ``bblayers.conf`` file: + +.. code-block:: console $ bitbake-layers add-layer meta-scottrif NOTE: Starting bitbake server... @@ -905,14 +907,13 @@ shows the layers that are in your ``bblayers.conf`` file:: Parsing of 1441 .bb files complete (0 cached, 1441 parsed). 2055 targets, 56 skipped, 0 masked, 0 errors. $ bitbake-layers show-layers NOTE: Starting bitbake server... - layer path priority - ========================================================================== - meta /home/scottrif/poky/meta 5 - meta-poky /home/scottrif/poky/meta-poky 5 - meta-yocto-bsp /home/scottrif/poky/meta-yocto-bsp 5 - workspace /home/scottrif/poky/build/workspace 99 - meta-scottrif /home/scottrif/poky/build/meta-scottrif 6 - + layer path priority + ============================================================================================== + meta /home/scottrif/bitbake-builds/layers/openembedded-core/meta 5 + meta-poky /home/scottrif/bitbake-builds/layers/meta-yocto/meta-poky 5 + meta-yocto-bsp /home/scottrif/bitbake-builds/layers/meta-yocto/meta-yocto-bsp 5 + workspace /home/scottrif/bitbake-builds/build/workspace 99 + meta-scottrif /home/scottrif/bitbake-builds/build/meta-scottrif 6 Adding the layer to this file enables the build system to locate the layer during the build. From patchwork Thu Jan 29 15:23:04 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79986 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 756EDD6102C for ; Thu, 29 Jan 2026 15:24:18 +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.17095.1769700254498619168 for ; Thu, 29 Jan 2026 07:24:14 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=MZ94tDAe; 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 0012E1A2B0D for ; Thu, 29 Jan 2026 15:24:12 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id C56FF606FD; Thu, 29 Jan 2026 15:24:12 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 1A7F4119A868D; Thu, 29 Jan 2026 16:24:12 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700252; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=H+nLSLEZ2vBAjEQ1gjOvryk+9enXap0cDufOE5mnwyo=; b=MZ94tDAewK7X08gP8UBJKBiIqNzqt3LL1q98XysklX6zgGDpUqEyp3nf5BcPUlXdZYT2G0 FZ1W/TUgiO2tO8UQux4BQNoGTvYTWePFI/AaaHKE1O2jpeAl6XlehC3oi8b+vA3+diE9cE yYHrMFmSzxy5HbweUJsZPhxNVdSvNQh7x3XArOWuJC9aaCempyc8KVj4HsQI1k5TaUMz4B Des5tVSobB1FiDmVrqSRIoAljjB2n43GX1wbeGwp0RST4AsqLDKewTS6P4QtX7oJCjuCCi 3iqHJHF24+jSVtGpBe/Paojx66vaHxevanoIejl/y38MvCVre3QW+hRASBPXHA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:04 +0100 Subject: [PATCH v3 13/57] dev-manual/libraries.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-13-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1639; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=JPaNl44+NYCzXwISX+B8zxF55Je4/P+9L5sCi/2m/Z8=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uLcho6fujNI8WM2iqvmUXmSaRY7BTPHhSqX m23xy88x2qJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7iwAKCRDRgEFAKaOo Ni8wD/9hhpzlRqmlnn2YndwYhq7IVfCo5GxWqteleFIDqixLdTBXXURM2rAvhegW2C7sFMSt+37 df6I9vfsA7uyhPVkEYomTvvkjmOtcCe3Ux+MBC486us1R9yzeWjcI9JcMcKnMzb3r1bgC6/zPgZ aMreUVHGtqgycRDRdxaGujvYEmmFFaFhF2dTNst6LoCmPQU7NdsivibxzeOx5CdlFpkFOzat/ND a7pFkWenibdVhQNmZS4uSsGCcmM83qFsbd7DHm/55JuYseVNoycJWvVPalvP7H/0LKm15Ya8tDY 7Tnz45pBWQSIHoi2uM5YfHGhUQRMjq+VzZ2b5c7jmTjmuW6hE9/zs521uR+m6U1hpYN7iuCEztP 63VIScye4Qp/z7nM4lhp/yOsOzcX6CeuHEuSusPrRDXzJ2PnnuPf9wKx4C0Bn4gUVaA7GKmkjMS q+oayuqJVt8R6Y8EA6FJFwuHXpODEyz8sPKnjI1ETDRUmx0uWfMk11SImDqzsrt+Hw3M70C+ll+ ru1uJ+aAHKgdBl2L9VvStLpcyD1xeoHJ0P6KNO5Dg/tjCanKfSzm++MDn4YX0ObQgOZs/0OK9i3 +x/pjYRMzbMMC862Lqr72x6OHum4bcQUx6BNe8Kx7mM9XkIrMcISXNeQfqFtvwFP4hKvV5TMwci G3e3dyzzHsh3vOQ== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8799 Remove references to the Poky repository, replace by OpenEmbedded-Core. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/libraries.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documentation/dev-manual/libraries.rst b/documentation/dev-manual/libraries.rst index a8c38128e..697ea48e4 100644 --- a/documentation/dev-manual/libraries.rst +++ b/documentation/dev-manual/libraries.rst @@ -68,8 +68,8 @@ libraries and other binaries to use a different set of libraries. The libraries could differ in architecture, compiler options, or other optimizations. -There are several examples in the ``meta-skeleton`` layer found in the -:term:`Source Directory`: +There are several examples in the ``meta-skeleton`` layer found in +:term:`OpenEmbedded-Core (OE-Core)`: - :oe_git:`conf/multilib-example.conf ` configuration file. @@ -90,8 +90,8 @@ meet your needs. In order to enable Multilib, you first need to ensure your recipe is extended to support multiple libraries. Many standard recipes are already extended and support multiple libraries. You can check in the -``meta/conf/multilib.conf`` configuration file in the -:term:`Source Directory` to see how this is +``meta/conf/multilib.conf`` configuration file in +:term:`OpenEmbedded-Core (OE-Core)` to see how this is done using the :term:`BBCLASSEXTEND` variable. Eventually, all recipes will be covered and this list will not be From patchwork Thu Jan 29 15:23:05 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79985 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 810DDD6102E for ; Thu, 29 Jan 2026 15:24:18 +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.17190.1769700255067400729 for ; Thu, 29 Jan 2026 07:24:15 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=DGAplW3W; 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 8B9CF4E4231D for ; Thu, 29 Jan 2026 15:24:13 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 60932606FD; Thu, 29 Jan 2026 15:24:13 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id AA31D119A8853; Thu, 29 Jan 2026 16:24:12 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700252; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=X8nddArgurHkE5hFd8tjN/qVOtCJ1lM90P18lGTfB1k=; b=DGAplW3WmYzEZIhc2Cy43BThOcvhOhegscpvFim7y7sZPcOHUFO2k4iOXV6a7vF0ndzFR6 ikdEWKY6INM6Kiun22KtnbUEyi1pOQ8IOI0Gka1ophOE8tNlTtKbCK27FGMGEY8fHwH3xQ SWZt1cpHabAq5KV7T5ehg15FE90k6Wrn8s4VvdKLIu+A/8yHA2AmCSnOicAH1RCwSD/XZ6 q4qfIgSdy7SSTdSQZkUA3txb1Wg0oyBJWzcmAlK/D1TRJjI7BscnfR3BMGVqpeEcQL1POI iFTVddVeyMKcAmaDxPmq0+p+tAeI/9ZgRYdVNyE+0NQ2BIhNqPW8D4vRV2oVeA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:05 +0100 Subject: [PATCH v3 14/57] dev-manual/new-recipe.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-14-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=3428; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=czdOcqgQKIdqxN6QdV4G36hZbh6bpldmxYwhlLsD/FM=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uLK0e6pUyA2n0M2lqxjB6MLvTocDWRTkm+7 TMPc/0UpgCJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7iwAKCRDRgEFAKaOo NoPcEAC0SydE8PYqc1Unn/25S27nhEQRDIu4YFVxINtzzh2BvgSnUPNL/4PU/qd3nkp41mL6Cvh QSJbWR7cyJqcJTRPBOWv5JgHEfj9npc9r79IVeIlsJSKvrGWQukZFZ1s5zVhJZaG2epAyM0o5D/ t6IVhGqxZ2oDzKIMgiDB4d+JckQOPPnK9QDHANeaKzfeJIKx6kRAXocN6hCYCL3ivTsutbxm6B4 XH+ceLUgVziUCTJ36cSAarcOBaHXyDOU0twuAClFztNVftMXM53q3m3t0ojGW7ADz+v7LQA+UEp ZLwMJ7P+uslVCj+FbFThQJNuuoOqbsOG64ydx2eaFehDRP2zeSMLIvhulF1t+3RaCqCcSANTXKm l+nybomEHkrdxBtF+jGpUzOMRAt/Hj6ZLQZovTEw+76hnEK4HTNWHUyF9+12cDMYl+zrHwz1WLE L7tfGS0E74UgDYwMuKNrzTR691+LyqyWl3LTR23Lkf5i7THAi0hsXHIIxyxdijINaxMie4ApVng 3k/LAqxJrzgRIcHlc7tMA2U20UGyn+vGTzhBOawMBKasm6KoybUYyJuXHcnS1YQoTh/4NFBK2Dw +C6eUc4wR+zpFGhX4UQ83jAaAuY9gAI9OVqHDGwyyBa/QTmrxcrrVV+7esNhmWG75uuR8D6eAb4 1bJaNbs/eUMyOtw== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8800 Remove references to the Poky repository, replace by OpenEmbedded-Core. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/new-recipe.rst | 25 +++++++++++++++++-------- 1 file changed, 17 insertions(+), 8 deletions(-) diff --git a/documentation/dev-manual/new-recipe.rst b/documentation/dev-manual/new-recipe.rst index ee0f6aaf6..5e9498afc 100644 --- a/documentation/dev-manual/new-recipe.rst +++ b/documentation/dev-manual/new-recipe.rst @@ -224,14 +224,23 @@ is to use the ``bitbake-getvar`` utility:: $ bitbake-getvar -r basename WORKDIR -As an example, assume a Source Directory -top-level folder named ``poky``, a default :term:`Build Directory` at -``poky/build``, and a ``qemux86-poky-linux`` machine target system. +As an example, assume a :term:`Source Directory` +top-level folder named ``bitbake-builds``, a default :term:`Build Directory` at +``bitbake-builds/build``, a ``cortexa57`` :term:`PACKAGE_ARCH`, ``poky`` +:term:`DISTRO` and ``linux`` as :term:`TARGET_OS`. + Furthermore, suppose your recipe is named ``foo_1.3.0.bb``. In this case, the work directory the build system uses to build the package would be as follows:: - poky/build/tmp/work/qemux86-poky-linux/foo/1.3.0-r0 + bitbake-builds/build/tmp/work/cortexa57-poky-linux/foo/1.3.0 + +.. note:: + + This covers the case when the :term:`PACKAGE_ARCH` variable is set to its + default value, :term:`TUNE_PKGARCH`. This variable is sometimes set to + :term:`MACHINE_ARCH`. See the documentation of the :term:`PACKAGE_ARCH` + variable for more information. Inside this directory you can find sub-directories such as ``image``, ``packages-split``, and ``temp``. After the build, you can examine these @@ -240,7 +249,7 @@ to determine how well the build went. .. note:: You can find log files for each task in the recipe's ``temp`` - directory (e.g. ``poky/build/tmp/work/qemux86-poky-linux/foo/1.3.0-r0/temp``). + directory (e.g. ``bitbake-builds/build/tmp/work/cortexa57-poky-linux/foo/1.3.0/temp``). Log files are named ``log.taskname`` (e.g. ``log.do_configure``, ``log.do_fetch``, and ``log.do_compile``). @@ -830,7 +839,7 @@ different ways: To enable a service using systemd, your recipe needs to inherit the :ref:`ref-classes-systemd` class. See the ``systemd.bbclass`` file - located in your :term:`Source Directory` section for more information. + located in :term:`OpenEmbedded-Core (OE-Core)` section for more information. Packaging ========= @@ -974,8 +983,8 @@ being able to provide the ``virtual/kernel`` item. Now comes the time to actually build an image and you need a kernel recipe, but which one? You can configure your build to call out the kernel recipe you want by using the :term:`PREFERRED_PROVIDER` variable. As -an example, consider the :yocto_git:`x86-base.inc -` include file, which is a +an example, consider the :oe_git:`x86-base.inc +` include file, which is a machine (i.e. :term:`MACHINE`) configuration file. This include file is the reason all x86-based machines use the ``linux-yocto`` kernel. Here are the relevant lines from the include file:: From patchwork Thu Jan 29 15:23:06 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79990 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 8AA8BD61030 for ; Thu, 29 Jan 2026 15:24:18 +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.17096.1769700256073533549 for ; Thu, 29 Jan 2026 07:24:16 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=2NNBkcsY; 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 86EF14E42322 for ; Thu, 29 Jan 2026 15:24:14 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 5EF7A606FD; Thu, 29 Jan 2026 15:24:14 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 44E2E119A868E; Thu, 29 Jan 2026 16:24:13 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700253; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=vfZ6kt6PjOUV28bdGPrbsqb6isRtnWlvlpyulIP/F1M=; b=2NNBkcsYwzOKnxdjo8+xUlYgsOPnhd7Iz4io7riz4LBSBePkIGwBQbtcHcncFfmYkzV++W BlL1IZNp/OJumgccsqWe8AZVreZ/+AOdEjvFiKiluUBWUocpOaXS5wb2fiY7CPQ1EpCg12 OXIB3sFyKClXvyNWBjylGKTgAYyvHcVnbmUuIUGIweRvLpYealIQfIxvj6B3w1pRroRv3M E4zlONx22WZbvW4ffawgnRB62bV17bHFukh6sq44yLPTCq5aGZN2CGayRl+4tykxik13D8 VfiyMbl46RU0xfmDyQAOWpfnLvM0AdRGEdHPQOJaKBANTRzSJ5nisk9ZACZ6wg== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:06 +0100 Subject: [PATCH v3 15/57] dev-manual/securing-images.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-15-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1727; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=dBRpBR2bZ8XAK6uuktW+HPfnjpxC9B0XfaYxfPzkRSc=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uLtoSyxBuG0k4PoWX85QxyNLUBeeYklJ2MW RMDC/EmvJ2JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7iwAKCRDRgEFAKaOo Nq8ID/0Wz2f8lYy8UEPLIDEZz62oF1AbFdVtdt0SuuorDvTRGvvfQyivMTJ9uW6k85+DBDx3kcy pdLUOd3s3I5q80Zb/hIpqqJYyLyqYfxJPIJoQLdyAeJlONguhdHpEqjYWhhgSGVosKzugMC8LHq 8+bBCH4nYV8YsqPed5C2g5d82p+z7bN2bPPJxZ0eOFkpxYNxRMN9vYgbQdYNS7E9jn+gxNCQ3Gt QFlgKQTEcbXOwrbSfTDFIRiw8EcR9jSikJmJutIAIyQTeXeIoG+UJ8zfRIjQOqzj0XCAq7VEyWw 1maWRLjQBzCN+/PgKby1CJW4TMEj+xd7kit93zANFr7IkKrfoDU/zt3fIo+m6OtwPrEKiXfHSjz PkB1O3tRJMUwI0X0eH5IddSv2BZb8StFtWF1xz1UQKHY3cciMQws+MUy9VB5y1z7OZezoN4F/Bg G1hmNBGe3HxS25CbTFHtlREBRw87OvG4xrSv8C3TnjTFmPNqvKhMURWwZliAtL7OILk8xfpWsdL 2yoJgitdEyRUEw1Mepgf00EdyHe+YTOccewfKcWIaskJvzpS5qV+95XuIt76cWoql9nQEama12l cLaEwp/7Ha8mzvWD9rF69h0gEFHULaTiPEIzYexLsAmJTfVda/AGUby7GcMFDn01VOHA+d/gzXd HMO0+2gnH1EvqUQ== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8801 Remove references to the Poky repository, replace by OpenEmbedded-Core. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/security-manual/securing-images.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/documentation/security-manual/securing-images.rst b/documentation/security-manual/securing-images.rst index cc6f95003..952808f3b 100644 --- a/documentation/security-manual/securing-images.rst +++ b/documentation/security-manual/securing-images.rst @@ -50,9 +50,10 @@ more secure: - Regularly scan and apply fixes for CVE security issues affecting all software components in the product, see ":ref:`security-manual/vulnerabilities:checking for vulnerabilities`". -- Regularly update your version of Poky and OE-Core from their upstream - developers, e.g. to apply updates and security fixes from stable - and :term:`LTS` branches. +- Regularly update your version of :term:`BitBake` and your layers (e.g. + :term:`OpenEmbedded-Core (OE-Core)`, :yocto_git:`meta-yocto `, + ...), e.g. to apply updates and security fixes from stable and :term:`LTS` + branches. - Ensure you remove or disable debugging functionality before producing the final image. For information on how to do this, see the @@ -72,7 +73,7 @@ Security Flags The Yocto Project has security flags that you can enable that help make your build output more secure. The security flags are in the ``meta/conf/distro/include/security_flags.inc`` file in your -:term:`Source Directory` (e.g. ``poky``). +:term:`OpenEmbedded-Core (OE-Core)`. .. note:: From patchwork Thu Jan 29 15:23:07 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79989 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 965F4D61031 for ; Thu, 29 Jan 2026 15:24:18 +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.17192.1769700256620781555 for ; Thu, 29 Jan 2026 07:24:16 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=zFSDv/rz; 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 19D824E42324; Thu, 29 Jan 2026 15:24:15 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id DEF34606FD; Thu, 29 Jan 2026 15:24:14 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 42D46119A885C; Thu, 29 Jan 2026 16:24:14 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700254; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=+KIRsq1o9ehnryYo0s19dvtHfW+cKglzZKCzGbR6OmI=; b=zFSDv/rzUVLSzRNbIKX+Kl6ZkolE/HaZpjqraUQpzPEP2IZ00mVlQE/58tO8q7FJrDK3jX EtKzSX9MNJNqR/RRe5YjMIiwPq7qwTpzbzrasBUNdx8vmGAHcq5wcZ6jctIYAlXLayCg+k jdn1Nub7nK2MWOTHY5LM92WNCr4njWtyTRkU+/CCC+yA2homtGgNnnCCb1l6t3CRMjdeP7 icBAFAnVO2tr9/lR6fbKUsbJRFWwWP71wFbvIWZvo7T939RMl+sRGn7lKtU8JeNXZTVnHw SH7AdfDX6zlWmpPIz4hJqqU7xaESL6Jr+92LRwMeyZNjFwwqrsE8lD2YOx0aOw== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:07 +0100 Subject: [PATCH v3 16/57] dev-manual/temporary-source-code.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-16-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1121; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=KU6p3i5kc7OoFw7iccMBphxTP/RQQ9j8k8kmC5PySoY=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uLVv/dFujbywthHd70P4Aup2BNiCYlV1Bti jvxPf6MLOOJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7iwAKCRDRgEFAKaOo NlquEACet91dYvhSmjMf7ahp7ApKtXfe/V7tmQAP4BKaMfPVpwMXNeSNXzzbGFLthLYEituewvK UJiXjbFPMmcbyVshLssO66hyPBroF3VPy9zB2gmbFTznchpJoBsVefJFxzxpBJlZerHG5pU2viK P7djD94CvinUmoip+6VJWUZ1i0y+l2ox0cIHmexa/KJMmhAduER5hYmLaTupsflrDiVa+T27ORU 0jQeTX/CrICEGyunFdwyIUllhPluTe7mosAp/AHz8RyrM2oMZtIgpxVP0j2ZVATuRLo7k7ELyT3 jnWkrf/1hP9vXiZbBXOFO2mb7+XLzRH972j+HdhlG96PjodpmZ9zdxyImAvMNMiqRTNvSWf7ZG4 AqnLg6FgHJnBteqw5BchMN6kP3ocF6NE4iLM/cT0nWfKJAM3xGDRhMmmww/FBUuII60I10q1mzX uvAiVWGKHxeGtH1XPJ2UXuJjmETgeALO9bbRVogyBdDBnEfJFgyYg6N+FIOsRG2cpBALQWduKgB bY/3bm1uyePmATSS887dY2W8LTyE1COL0lXLFpbaSxnfdDPkTPRRaRJCBykbnvlaWUi4S/Uw+DB IzOwIG0hsX9b/qdgZIVbprondk5EhnwHhXhx0KsZsZXFF9L7AmL4iO0qFg9XCyjchJqF2umqys6 hXkLYyOyPbbIERQ== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8802 Remove references to the Poky repository, replace by OpenEmbedded-Core. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/temporary-source-code.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/dev-manual/temporary-source-code.rst b/documentation/dev-manual/temporary-source-code.rst index 977edbc3f..aecd34099 100644 --- a/documentation/dev-manual/temporary-source-code.rst +++ b/documentation/dev-manual/temporary-source-code.rst @@ -15,8 +15,8 @@ your changes in the form of patches. During a build, the unpacked temporary source code used by recipes to build packages is available in the :term:`Build Directory` as defined by the :term:`S` variable. Below is the default value for the :term:`S` variable as -defined in the ``meta/conf/bitbake.conf`` configuration file in the -:term:`Source Directory`:: +defined in the ``meta/conf/bitbake.conf`` configuration file in +:term:`OpenEmbedded-Core (OE-Core)`:: S = "${UNPACKDIR}/${BP}" From patchwork Thu Jan 29 15:23:08 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79994 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 A46E5D61038 for ; Thu, 29 Jan 2026 15:24:18 +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.17194.1769700257415975913 for ; Thu, 29 Jan 2026 07:24:17 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=adfOackt; 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 CF93D4E4231D; Thu, 29 Jan 2026 15:24:15 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id A7465606FD; Thu, 29 Jan 2026 15:24:15 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id C706E119A868D; Thu, 29 Jan 2026 16:24:14 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700255; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=kP+D3YJ8WN+qLf/jP0L/uWEt9anDHVMCac7gvyUU8C8=; b=adfOackthHRJ008G6VBnuh5GJy91SFrcJk95FKZC7aK+uXfKM3tmjmaSUVnK5XIOCe6b4U Mmoseh2UY7R6D/FRH3pd0pq4jY9xhisGzY3JYGw1D/xx+GgaFIqhgDdnEfrMMTd3tPHewk kjCZf6s4yqBye/9NdKiFLPmw4f1anlefqfbmj4lK0KYivNWROr4ep4xbedfvww5CW8O0Yw 22vqJcPtsWLZjhbynpNDM+2YQQZBwV7OFts3fXEr6F3RgXiy6ljsQ8WEYmB+azHqSoiU71 blpCpWtX4m9mg8DD2und/OhPPg+TkSqq6r6zlvcWlvR5A81nsJwtZTc771NjFg== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:08 +0100 Subject: [PATCH v3 17/57] dev-manual/wayland.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-17-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1022; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=ArZdQ9IJBWORZ7l/hoZaNdZttPXDgevMN8FGCm7e6Lc=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uL/6BFtEAP5gNjyPZLuATXsHXrHPO/hpfWQ A1RlfZ9J96JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7iwAKCRDRgEFAKaOo NvwxD/49IqmLpAZsvZSCCEF+Sy6oS0DN38b4S9Uvl4JQe+Q96LpU3ESMF5Uoev0EDmrtrX9ZRy6 cU4xCP9dr++1ahkuvjvNkN5LCMY+1tPgZYNWjeaEBstYISWcrwj/zjcctGj2Rma9eYRFjXe1BKE s1AglwT5+gRzHcwW1F/2ymNZ567065NX44GEOB22qNtntYoVEyWtSLLTRg8GjcgZXvipK+DZykK MueZEzco4pmimbua248q8vrYns2tdleecgaHMJT6YdBl0Mv0IxKWxwzBk4YkwcIvUtvxoS8hBmb vLM1M+4h7z7VJ1KBJ6kxt7cotINA+HclFWLhBgscxjfi0SqBQX72NKtu2LsyN6OqCez08mVTHwl 2/rbzompWU9S3Al7MbljGvwxlU+qWw2aJQeYkxxoCtPx4geHddqWt9aj+koRVj4/seHultp/rkz /1ht5Kd4uOZZr+Ns5wCqkPxDp8Tw3b3rvpNJzDdQXZW+1xkUecG4lNaV6b2Yv4nhpr92u5OOCqb dcQAZzyKkdU6C5JLzgXQ2NnFUO6B2kexx8plhtO0sjG/Zov0Q89oRbbiifNcbpnVNYrivH6XvdZ GPr9sxzKJJyfzMeL+A6C2WIgiHNm/XfMwc6nZCqFdRJJc+6iS2xq8+Q+uIfqW4I8kgnjfWRTFLo 3dVWmK2b92HD/uA== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8803 Remove references to the Poky repository, replace by OpenEmbedded-Core. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/wayland.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/dev-manual/wayland.rst b/documentation/dev-manual/wayland.rst index 097be9cbde..18d1bfb0a6 100644 --- a/documentation/dev-manual/wayland.rst +++ b/documentation/dev-manual/wayland.rst @@ -14,7 +14,7 @@ might otherwise achieve. The Yocto Project provides the Wayland protocol libraries and the reference :wikipedia:`Weston ` compositor as part of its release. You can find the integrated packages -in the ``meta`` layer of the :term:`Source Directory`. +in the ``meta`` layer of :term:`OpenEmbedded-Core (OE-Core)`. Specifically, you can find the recipes that build both Wayland and Weston at ``meta/recipes-graphics/wayland``. From patchwork Thu Jan 29 15:23:09 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79995 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 B12C3D6103C for ; Thu, 29 Jan 2026 15:24:18 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17196.1769700257894529643 for ; Thu, 29 Jan 2026 07:24:18 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=FosmIKXe; 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 6579D1A2B0C for ; Thu, 29 Jan 2026 15:24:16 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 3CBD3606FD; Thu, 29 Jan 2026 15:24:16 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 8B4B0119A885E; Thu, 29 Jan 2026 16:24:15 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700255; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=19qBEwJxk89ZRVMrPmHizEc+7MxuLKke5SehpzMSZUc=; b=FosmIKXedJxIi3QpQHAYNJ5yjbKfroPaiHYO3BnR0wwGpv48vWmXArBoFsbXxic3ZFyT7s ItkOOfWwkXNy2Qe/jAo0neXGWXrUdj3kHjvkCt+pwMb5KSM23WDE/4xKexEg9A0W5mjPAJ JQyjHxRtpbsapByPb88q7d/GvQpE3mHDHJhGxanBX9X19UQo4niZHqcfI1m8K1JwHgjT3l JS5FKUTdMmgXmd+oItrzCChzmq+E9tBlk8nCo0teZh0bPely9JxsRHAfc2J6iDpNYuPFQ+ eadrjLHXELp7Fwg2kFjPsSot4e0qeelJ4onreZYvqchpmVDutYvG/hvkL1gZOg== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:09 +0100 Subject: [PATCH v3 18/57] dev-manual/wic.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-18-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=4399; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=0HXfjkZBpeoRpsEn1kLrGsCnWKSz7Xh9Z1x3TBL2RC0=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uLXdTk19Pttf5m6NOeUQB9TW3W6uE1rvBg5 8zr4MVGUd6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7iwAKCRDRgEFAKaOo Ns3xD/0a+jZNGWd/EESkgp2hq3TlCVw+7E2qB66C6p0FwGi08fjCbrWmbHaB6PXwabhB8I8Pqw3 LSVIKGhsusNan4peb5eE3t6aj6K5xn4JOQvML4b1gdc8kgFn8hHUnnj32sVQEG84LiCf56GZtmh UnWSXHf5CkJ4CbC8VAhy9yklHElIhUtBCfthjLPYpKdKX60Mbj05mUuxfP7mqU0fWXLMgL8Ttet Mypq8DeW0coGrarAEPARtGXS5R3JJrm66pjjhQqGzGJe4KjF5Mi03jrartNUFgQDNOrfy+CDNvy DvTfHsDt4skUjbX8F2nJHh1aPdP9KIOhYTkynQ12w7Ff9i9phOoTRpxkzOySE3C1SyYRfsuMbM5 lrztep0GZcPPWQPekc0ULz9EHWi4rtPpmnE9wCUFT0dnhafsT57vfwzTBXkCWaHZd/6pYzfNklR +smiRq930mCRwqMCaBzwDA5nsmYigbQVKqQAta8EfNHbaQb0PWjx3ZfOPbj/ybsebCpzF3qRjsO gF1T/JN9xLytXbrw7ZgkWkRKjDJxpHFkT/X3KKwyu+3D1JV++zOrW4mCoM0xBqJjf5fZJYgUjf0 GcyrWyTL5iqTgfC/ajQQOH1Ki4SUfTeys0/UmIi6fUt+6d61PfnYteuboGs67JEvYuqwF47cnNq fW+Bmoq5kkyR1GA== 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 ; Thu, 29 Jan 2026 15:24:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8804 Remove references to the Poky repository, replace by OpenEmbedded-Core. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/wic.rst | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/documentation/dev-manual/wic.rst b/documentation/dev-manual/wic.rst index 07170537b..60b08f834 100644 --- a/documentation/dev-manual/wic.rst +++ b/documentation/dev-manual/wic.rst @@ -276,8 +276,8 @@ existing file provided by the Wic installation. As shipped, kickstart files can be found in the :ref:`overview-manual/development-environment:yocto project source repositories` in the following two locations:: - poky/meta-yocto-bsp/wic - poky/scripts/lib/wic/canned-wks + meta-yocto/meta-yocto-bsp/wic + openembedded-core/scripts/lib/wic/canned-wks Use the following command to list the available kickstart files:: @@ -342,12 +342,12 @@ partition. Source plugins are subclasses defined in plugin files. As shipped, the Yocto Project provides several plugin files. You can see the source plugin files that ship with the Yocto Project -:yocto_git:`here `. +:oe_git:`here `. Each of these plugin files contains source plugins that are designed to populate a specific Wic image partition. Source plugins are subclasses of the ``SourcePlugin`` class, which is -defined in the ``poky/scripts/lib/wic/pluginbase.py`` file. For example, +defined in the ``openembedded-core/scripts/lib/wic/pluginbase.py`` file. For example, the ``BootimgEFIPlugin`` source plugin found in the ``bootimg_efi.py`` file is a subclass of the ``SourcePlugin`` class, which is found in the ``pluginbase.py`` file. @@ -527,8 +527,8 @@ This next example demonstrates that through modification of the As mentioned earlier, you can use the command ``wic list images`` to show the list of existing kickstart files. The directory in which the ``directdisk-gpt.wks`` file resides is -``scripts/lib/image/canned-wks/``, which is located in the -:term:`Source Directory` (e.g. ``poky``). +``scripts/lib/image/canned-wks/``, which is located in +:term:`OpenEmbedded-Core (OE-Core)`. Because available files reside in this directory, you can create and add your own custom files to the directory. Subsequent use of the ``wic list images`` command would then include your kickstart files. @@ -542,8 +542,8 @@ The example begins by making a copy of the ``directdisk-gpt.wks`` file in the ``scripts/lib/image/canned-wks`` directory and then by changing the lines that specify the target disk from which to boot:: - $ cp /home/stephano/yocto/poky/scripts/lib/wic/canned-wks/directdisk-gpt.wks \ - /home/stephano/yocto/poky/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks + $ cp /home/stephano/yocto/openembedded-core/scripts/lib/wic/canned-wks/directdisk-gpt.wks \ + /home/stephano/yocto/openembedded-core/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks Next, the example modifies the ``directdisksdb-gpt.wks`` file and changes all instances of "``--ondisk sda``" to "``--ondisk sdb``". The @@ -580,7 +580,7 @@ Computing (nuc) :term:`MACHINE` the NATIVE_SYSROOT: /home/stephano/yocto/build/tmp-glibc/work/i586-oe-linux/wic-tools/1.0-r0/recipe-sysroot-native INFO: The image(s) were created using OE kickstart file: - /home/stephano/yocto/poky/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks + /home/stephano/yocto/openembedded-core/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks Continuing with the example, you can now directly ``dd`` the image to a USB stick, or whatever media for which you built your image, and boot @@ -717,7 +717,7 @@ the existing kernel, and then inserts a new kernel: kernel:: $ wic cp poky_sdk/tmp/work/qemux86-poky-linux/linux-yocto/4.12.12+git999-r0/linux-yocto-4.12.12+git999/arch/x86/boot/bzImage \ - poky/build/tmp/deploy/images/qemux86/core-image-minimal-qemux86.wic:1/vmlinuz + build/tmp/deploy/images/qemux86/core-image-minimal-qemux86.wic:1/vmlinuz Once the new kernel is added back into the image, you can use the ``dd`` command or :ref:`bmaptool From patchwork Thu Jan 29 15:23:10 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80000 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 C4429D61028 for ; Thu, 29 Jan 2026 15:24:28 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17197.1769700258464698929 for ; Thu, 29 Jan 2026 07:24:18 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=o3GVUkOl; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id CE01FC22F48; Thu, 29 Jan 2026 15:24:19 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id CC420606FD; Thu, 29 Jan 2026 15:24:16 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 25A4E119A8857; Thu, 29 Jan 2026 16:24:16 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700256; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=HlQ2rwmyYjLQ6uaaJDl2PXLGbRZENxOXuA6YPqMRiL8=; b=o3GVUkOlVS044Ep4Wju07BIR5GY02dNMt18+x0HKn6kyVxpIkcjqMu+TQrMzKB3xG5pFlb IuMF+9eSXSH9rgZ4sMxsigKeAyv4zD789AZlusH5Rcj4RtthA/yBj+yjD6CQHpScmh+ERV NSZIqmtI6tLuFxTsD2xYmf8ri/SDRcjjHgUGZaNZnjXkTJ/WFCJSQQftbTbdvQ/7hJQFGZ iIrWMG7fwhzTFAWhKtcuG3tOwW0x8CtWNPNYFQnz8FXCCyh3fCpsusIPndJNe6UAYy8v/M IYOeDDSqHn791WrOVSbwLwthRM9R+gPcIrkKy1GHp/M5Bkuu49z12RuhzuBtzw== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:10 +0100 Subject: [PATCH v3 19/57] kernel-dev/common.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-19-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=15194; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=GJxNzZIeYBViKKwBjZtTEn7XC0ufcWIN7YPiKsLZSHM=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uMj5jHMXyKBlxbGFs5rqA4C7tc7xSjcHMK/ PP/cK2qWgGJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jAAKCRDRgEFAKaOo NrbrEADF6VqsJ2Kdyb5RXs68PsBWyZX+mBfrkgzNIsjvbxg52yJow2LLRdsoLJpFtqbLauUe6SK XoaR0iHNWvA57KefFV4FSwNawOOP0HYHTDs+SsT69u73M6/2niBl7VzB5nmw+I8yV4sYdHHzJj1 80Wl9lpMiIJ0FWzwIdvP0H8I8SUFjMZsI0ZLqBMZLhYQfJW7W2iy6cFMIjpz4VYDqdNCFsYlMB4 xtOF/cx76Tu4ZIPp1fk9kqqQhLpJMPKUyJny9h7NtyMwmeFteHmFwFWVXaR4KWut5IZbZk45xkZ GhOe4S70/E7QAtsyoMHhZ2rt1/Dt69TXSrgSdavBG3K2jlzOd+a62RH6RvvQi799DUrHCiYhB36 EdtG+pQ7SQWB8sRW/fw+VyfUH7TN4zkdJLVwQEq7YHmHqLNM6nOFc6aEglUmzYAP5paG7YGBN5R bD5XHcG/CUdhDkcWsyy1h6t2pVCfwYM4nMMDHtWIbPqNuZE9bPi58tVOYDIUuTedneArqF0VgYS 0Vm+bCX7eyov7r8cxxPvUEQmHktWIlCiQBazkAqtnJCci41kf9hbbXFx/l69YOG/cm6U2kUGHDl ZAxEBkdQdDpCVsuB7mDI1mc95/PhciqMMPVKfCvy/dXY9oE6HcTGHWp6NZ64mx5CTlE4au0PfjS BETLNYjQF0G3X7A== 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 ; Thu, 29 Jan 2026 15:24:28 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8805 Remove references to the Poky repository, replace by OpenEmbedded-Core. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/kernel-dev/common.rst | 116 +++++++++++++++--------------------- 1 file changed, 48 insertions(+), 68 deletions(-) diff --git a/documentation/kernel-dev/common.rst b/documentation/kernel-dev/common.rst index 2142d31c0..136524e63 100644 --- a/documentation/kernel-dev/common.rst +++ b/documentation/kernel-dev/common.rst @@ -44,25 +44,15 @@ image and ready to make modifications as described in the ":ref:`kernel-dev/common:using \`\`devtool\`\` to patch the kernel`" section: -#. *Initialize the BitBake Environment:* - you need to initialize the BitBake build environment by sourcing - the build environment script (i.e. :ref:`structure-core-script`):: - - $ cd poky - $ source oe-init-build-env - - .. note:: - - The previous commands assume the - :ref:`overview-manual/development-environment:yocto project source repositories` - (i.e. ``poky``) have been cloned using Git and the local repository is named - "poky". +#. *Initialize the Build Environment:* Follow the :doc:`/dev-manual/start` + section of the Yocto Project Development Tasks Manual in order to have a + ready-to-use shell that can execute ``devtool``. #. *Prepare Your local.conf File:* By default, the :term:`MACHINE` variable is set to "qemux86-64", which is fine if you are building for the QEMU emulator in 64-bit mode. However, if you are not, you need to set the :term:`MACHINE` variable appropriately in your ``conf/local.conf`` file - found in the :term:`Build Directory` (i.e. ``poky/build`` in this example). + found in the :term:`Build Directory` (i.e. ``bitbake-builds/build`` in this example). Also, since you are preparing to work on the kernel image, you need to set the :term:`MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS` variable to include @@ -79,10 +69,10 @@ section: patches created for the kernel image. You can use the ``bitbake-layers create-layer`` command as follows:: - $ cd poky/build - $ bitbake-layers create-layer ../../meta-mylayer + $ cd bitbake-builds/build + $ bitbake-layers create-layer ../layers/meta-mylayer NOTE: Starting bitbake server... - Add your new layer with 'bitbake-layers add-layer ../../meta-mylayer' + Add your new layer with 'bitbake-layers add-layer ../layers/meta-mylayer' $ .. note:: @@ -103,7 +93,7 @@ section: :term:`BBLAYERS` variable in the ``bblayers.conf`` file as follows:: - $ cd poky/build + $ cd bitbake-builds/build $ bitbake-layers add-layer ../../meta-mylayer NOTE: Starting bitbake server... $ @@ -157,7 +147,7 @@ section: set to "qemux86-64", which is fine if you are building for the QEMU emulator in 64-bit mode. However, if you are not, you need to set the :term:`MACHINE` variable appropriately in your ``conf/local.conf`` file found in the - :term:`Build Directory` (i.e. ``poky/build`` in this example). + :term:`Build Directory` (i.e. ``bitbake-builds/build`` in this example). Also, since you are preparing to work on the kernel image, you need to set the @@ -175,7 +165,7 @@ section: patches created for the kernel image. You can use the ``bitbake-layers create-layer`` command as follows:: - $ cd poky/build + $ cd bitbake-builds/build $ bitbake-layers create-layer ../../meta-mylayer NOTE: Starting bitbake server... Add your new layer with 'bitbake-layers add-layer ../../meta-mylayer' @@ -198,7 +188,7 @@ section: :term:`BBLAYERS` variable in the ``bblayers.conf`` file as follows:: - $ cd poky/build + $ cd bitbake-builds/build $ bitbake-layers add-layer ../../meta-mylayer NOTE: Starting bitbake server ... $ @@ -210,8 +200,7 @@ section: For simplicity, it is recommended that you create your copy of the kernel Git repository outside of the - :term:`Source Directory`, which is - usually named ``poky``. Also, be sure you are in the + :term:`Source Directory`. Also, be sure you are in the ``standard/base`` branch. The following commands show how to create a local copy of the @@ -237,8 +226,7 @@ section: #. *Create a Local Copy of the Kernel Cache Git Repository:* For simplicity, it is recommended that you create your copy of the kernel cache Git repository outside of the - :term:`Source Directory`, which is - usually named ``poky``. Also, for this example, be sure you are in + :term:`Source Directory`. Also, for this example, be sure you are in the ``yocto-4.12`` branch. The following commands show how to create a local copy of the @@ -334,8 +322,7 @@ Modifying an Existing Recipe In many cases, you can customize an existing linux-yocto recipe to meet the needs of your project. Each release of the Yocto Project provides a few Linux kernel recipes from which you can choose. These are located in -the :term:`Source Directory` in -``meta/recipes-kernel/linux``. +:term:`OpenEmbedded-Core (OE-Core)` in ``meta/recipes-kernel/linux``. Modifying an existing recipe can consist of the following: @@ -430,9 +417,8 @@ Although this particular example does not use it, the :term:`KERNEL_FEATURES` variable could be used to enable features specific to the kernel. The append file points to specific commits in the -:term:`Source Directory` Git repository and -the ``meta`` Git repository branches to identify the exact kernel needed -to build the BSP. +:term:`OpenEmbedded-Core (OE-Core)` Git repository branches to identify the +exact kernel needed to build the BSP. One thing missing in this particular BSP, which you will typically need when developing a BSP, is the kernel configuration file (``.config``) @@ -677,7 +663,7 @@ the ":ref:`kernel-dev/common:getting ready to develop using ``devtool```" Sectio ERROR: Taskhash mismatch 2c793438c2d9f8c3681fd5f7bc819efa versus be3a89ce7c47178880ba7bf6293d7404 for - /path/to/esdk/layers/poky/meta/recipes-kernel/linux/linux-yocto_4.10.bb.do_unpack + /path/to/esdk/layers/openembedded-core/meta/recipes-kernel/linux/linux-yocto_4.10.bb.do_unpack You can safely ignore these messages. The source code is correctly @@ -688,11 +674,11 @@ the ":ref:`kernel-dev/common:getting ready to develop using ``devtool```" Sectio #. *Change the working directory*: In the previous step, the output noted where you can find the source files (e.g. - ``poky_sdk/workspace/sources/linux-yocto``). Change to where the + ``build/workspace/sources/linux-yocto``). Change to where the kernel source code is before making your edits to the ``calibrate.c`` file:: - $ cd poky_sdk/workspace/sources/linux-yocto + $ cd build/workspace/sources/linux-yocto #. *Edit the source file*: Edit the ``init/calibrate.c`` file to have the following changes:: @@ -758,7 +744,7 @@ the ":ref:`kernel-dev/common:getting ready to develop using ``devtool```" Sectio your working directory to where you modified the ``calibrate.c`` file and use these Git commands to stage and commit your changes:: - $ cd poky_sdk/workspace/sources/linux-yocto + $ cd build/workspace/sources/linux-yocto $ git status $ git add init/calibrate.c $ git commit -m "calibrate: Add printk example" @@ -784,7 +770,7 @@ the ":ref:`kernel-dev/common:getting ready to develop using ``devtool```" Sectio command from your :term:`Build Directory` in the terminal set up to run BitBake:: - $ cd poky/build + $ cd bitbake-builds/build $ bitbake core-image-minimal Using Traditional Kernel Development to Patch the Kernel @@ -868,7 +854,7 @@ Section. :term:`SRCREV` statements similar to the following to your ``local.conf``:: - $ cd poky/build/conf + $ cd bitbake-builds/build/conf Add the following to the ``local.conf``:: @@ -888,14 +874,14 @@ Section. committed, and the ``local.conf`` file pointing to the kernel files, you can now use BitBake to build the image:: - $ cd poky/build + $ cd bitbake-builds/build $ bitbake core-image-minimal #. *Boot the image*: Boot the modified image in the QEMU emulator using this command. When prompted to login to the QEMU console, use "root" with no password:: - $ cd poky/build + $ cd bitbake-builds/build $ runqemu qemux86 #. *Look for Your Changes:* As QEMU booted, you might have seen your @@ -959,14 +945,14 @@ Section. To build ``core-image-minimal`` again and see the effects of your patch, you can essentially eliminate the temporary source files saved in - ``poky/build/tmp/work/...`` and residual effects of the build by entering + ``bitbake-builds/build/tmp/work/...`` and residual effects of the build by entering the following sequence of commands:: - $ cd poky/build - $ bitbake -c cleanall linux-yocto - $ bitbake core-image-minimal -c cleanall - $ bitbake core-image-minimal - $ runqemu qemux86 + $ cd bitbake-builds/build + $ bitbake -c cleanall linux-yocto + $ bitbake core-image-minimal -c cleanall + $ bitbake core-image-minimal + $ runqemu qemux86 Configuring the Kernel @@ -1013,10 +999,10 @@ environment, you must do the following: The following commands initialize the BitBake environment, run the :ref:`ref-tasks-kernel_configme` task, and launch ``menuconfig``. These commands assume the Source -Directory's top-level folder is ``poky``:: +Directory's top-level folder is ``work``:: - $ cd poky - $ source oe-init-build-env + $ cd work + $ source layers/openembedded-core/oe-init-build-env $ bitbake linux-yocto -c kernel_configme -f $ bitbake linux-yocto -c menuconfig @@ -1063,7 +1049,7 @@ the ``.config`` file would be: .. code-block:: none - poky/build/tmp/work/qemux86-poky-linux/linux-yocto/4.12.12+gitAUTOINC+eda4d18... + bitbake-builds/build/tmp/work/qemux86-poky-linux/linux-yocto/4.12.12+gitAUTOINC+eda4d18... ...967-r0/linux-qemux86-standard-build/.config .. note:: @@ -1279,32 +1265,32 @@ Here is sample output from the :ref:`ref-tasks-kernel_configcheck` task: ---------- CONFIG_X86_TSC ----------------- Config: CONFIG_X86_TSC - From: /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/bsp/common-pc/common-pc-cpu.cfg + From: /home/scottrif/bitbake-builds/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/bsp/common-pc/common-pc-cpu.cfg Requested value: CONFIG_X86_TSC=y Actual value: ---------- CONFIG_X86_BIGSMP ----------------- Config: CONFIG_X86_BIGSMP - From: /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/cfg/smp.cfg - /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/defconfig + From: /home/scottrif/bitbake-builds/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/cfg/smp.cfg + /home/scottrif/bitbake-builds/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/defconfig Requested value: # CONFIG_X86_BIGSMP is not set Actual value: ---------- CONFIG_NR_CPUS ----------------- Config: CONFIG_NR_CPUS - From: /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/cfg/smp.cfg - /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/bsp/common-pc/common-pc.cfg - /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/defconfig + From: /home/scottrif/bitbake-builds/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/cfg/smp.cfg + /home/scottrif/bitbake-builds/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/bsp/common-pc/common-pc.cfg + /home/scottrif/bitbake-builds/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/defconfig Requested value: CONFIG_NR_CPUS=8 Actual value: CONFIG_NR_CPUS=1 ---------- CONFIG_SCHED_SMT ----------------- Config: CONFIG_SCHED_SMT - From: /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/cfg/smp.cfg - /home/scottrif/poky/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/defconfig + From: /home/scottrif/bitbake-builds/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/cfg/smp.cfg + /home/scottrif/bitbake-builds/build/tmp/work-shared/qemux86/kernel-source/.kernel-meta/configs/standard/defconfig Requested value: CONFIG_SCHED_SMT=y Actual value: @@ -1459,11 +1445,9 @@ Maintaining format compatibility facilitates converging with linux-yocto on a future, mutually-supported kernel version. To help you use your own sources, the Yocto Project provides a -linux-yocto custom recipe that uses ``kernel.org`` sources and -the Yocto Project Linux kernel tools for managing kernel Metadata. -You can find this recipe in the ``poky`` Git repository: -:yocto_git:`meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb -`. +:oe_git:`linux-yocto custom recipe ` +that uses ``kernel.org`` sources and the Yocto Project Linux kernel tools for +managing kernel Metadata. Here are some basic steps you can use to work with your own sources: @@ -1597,13 +1581,9 @@ Incorporating Out-of-Tree Modules While it is always preferable to work with sources integrated into the Linux kernel sources, if you need an external kernel module, the -``hello-mod.bb`` recipe is available as a template from which you can -create your own out-of-tree Linux kernel module recipe. - -This template recipe is located in the ``poky`` Git repository of the -Yocto Project: -:yocto_git:`meta-skeleton/recipes-kernel/hello-mod/hello-mod_0.1.bb -`. +:oe_git:`hello-mod ` +recipe is available as a template from which you can create your own out-of-tree +Linux kernel module recipe. To get started, copy this recipe to your layer and give it a meaningful name (e.g. ``mymodule_1.0.bb``). In the same directory, create a new From patchwork Thu Jan 29 15:23:11 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79999 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 CC2A3D6102E for ; Thu, 29 Jan 2026 15:24:28 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.17099.1769700259156405244 for ; Thu, 29 Jan 2026 07:24:19 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=0svki5M6; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id 9A1B4C22F47; Thu, 29 Jan 2026 15:24:20 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 97827606FD; Thu, 29 Jan 2026 15:24:17 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id B57DC119A8859; Thu, 29 Jan 2026 16:24:16 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700257; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=+2xjNaC9b/ELtYqlQzSPG+Jc5NL5biO7pMHI15uRHP4=; b=0svki5M6zbPCxefXUkD815o6pq0ULDjMoCy7GtlNfMIXM7TcK1YRsWscfua46KO+9mK5MT n9PuzYGgR5G0wGnU62EEJE6oK/CosgvRNHotCjjVSdUW9Br+wtKAxyZEtVBKKzEm+DWCLx ktLGajtlrrraLlio0tW5EOV8F98SAMwUoG9smskx+3ymtfcTdGAnoJwRxY0TBnWBCZGms/ 7V49wYuX+637QQrzktjDHdmdsBVYFNjVvYLkSAjunOyyJV4MZcozbC0nwQrdLfsMpQmxEl jH12Uw7cUIVr3tEs46urvVRgWoYw4//hAEjI2tNjJbZV/xPb3zE85apkOCw0fQ== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:11 +0100 Subject: [PATCH v3 20/57] migration-guides/migration-1.4.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-20-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1133; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=b8WI5BuZdIqh8ndEv21J3B59uLjRO27TWlFHwLrS+Tw=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uMbHzyNnf8zOLxlsXNpz1babuc7EJUW97EU /ecYytrndeJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jAAKCRDRgEFAKaOo Nh0FEAC2gNE0wuviiszD4wpUb5mkc5aeCYlK4Om1QUUayykyKrpiRVFIAWO4hY6VStr0B96bcKy RONdtPkwp4N12zHJetWxN4D2AGnL6EpbpEu6eJq0FY/b8AJqZd7zy6CcWGGQ/AV888ZURT5/dis Gs3qjOGNWd/gwwu7p3WIvGNKWBaGorDoKlyDsAqtrQL7aQQI9gSBs8Eht8f0xWCRTQdTQdONyrc Rtf2yT0ZBymczpR8zUFp4qWzaUuJl+LoynzZG9XyHzdQaw6n/wwM0f2p2jjvDcwKsf4b/KvCZAU F35KT6UHQRwO7WWrGL2pmhGtrgve1GVVDE3HuBxtBnMjYKmmroE029rWugYC/n3/+xGeSPI6YJH 9AJDr7guRiloLnj+2/PJtfSY6d+pnxFviVhMYBPS9bW9vohPxA0PYkQa9CKGmiwl2NcEE0bgXKY b27O7NFP270fHiTtp+ZczXdJ1eyinxvMgf9txh6REN/prV/5e30aLoDXX99J0FUfQgc7dX5qmxn YCcDdfs3Zg4SpPsOirpxnax8pdw/+f2g7VZH0Sn8zrWtMb3UJtAqLaKEECNt4e7n9PuQJ8Zxrtl 7SYPSc90QU2BfqFhzmAYMZs6lzYydD459SMxCkkH4XAQFj0XAbMBVqLrUcYkWZIcnNtUEyhblvc GlKIkQpvaKqNifA== 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 ; Thu, 29 Jan 2026 15:24:28 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8806 Remove references to the Poky repository, replace by OpenEmbedded-Core. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/migration-guides/migration-1.4.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/migration-guides/migration-1.4.rst b/documentation/migration-guides/migration-1.4.rst index 6db2a035b8..5d8d0ffde8 100644 --- a/documentation/migration-guides/migration-1.4.rst +++ b/documentation/migration-guides/migration-1.4.rst @@ -82,7 +82,7 @@ Custom Interfaces File (netbase change) If you have created your own custom ``etc/network/interfaces`` file by creating an append file for the ``netbase`` recipe, you now need to create an append file for the ``init-ifupdown`` recipe instead, which -you can find in the :term:`Source Directory` at +you can find in :term:`OpenEmbedded-Core (OE-Core)` at ``meta/recipes-core/init-ifupdown``. For information on how to use append files, see the ":ref:`dev-manual/layers:appending other layers metadata with your layer`" From patchwork Thu Jan 29 15:23:12 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80008 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 1BCF7D358F7 for ; Thu, 29 Jan 2026 15:24:29 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.17100.1769700259543474988 for ; Thu, 29 Jan 2026 07:24:19 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=g4xfxJJp; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id 01189C22F4B for ; Thu, 29 Jan 2026 15:24:21 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 00473606FD for ; Thu, 29 Jan 2026 15:24:18 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 5CD5F119A8863; Thu, 29 Jan 2026 16:24:17 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700257; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=zw5z362SCS2MmxOGx0lZNJkIyC7inkCtimJ+kByb/hQ=; b=g4xfxJJpYqyetzahW8YSMkwA1xoy7n3SVIMm3Aj6Vxa2CFMW8zysYb5V2muhYtoGVTmHvN CkNLjaXdhMMHrXv2LunxaBZyCbFOAihTw41z5efE+SUgBCN/hykCqqknAe6PDqWpc98TPn 6/AGjcy7ZNsLa+NCQAnWy4P/goPhFLGzTd79H+bw8kD+rr93uekBPRoWAxN1PDLuh4rB1k WQTbRqXEL5YI/c2fkCLZEdWlQQlRyK72qGjjoZD+1DCcqjgG5M3SniSk6zTj5PnVWzdCfX uFOdBuVJXeAuFIUdWz8Zo8ckg1uMwWV66pvLZJfVFhvgwmKJCLQR1t5S3bVoWQ== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:12 +0100 Subject: [PATCH v3 21/57] overview-manual/concepts.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-21-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=6357; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=5/GzBQr3nvDQh0NwXKMW1M5/hzStC5XgGYpE4kRVnKA=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uMMf3obHQs1gYR8OjCd5ZpgfXhNCPjrU9BD nuWA3YXuH6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jAAKCRDRgEFAKaOo NlWyD/9d0XOXdtq8TlJANLSOwcQ9jdFL/PWJX4JJq6VbWW2G8B+TPkSm3nXwp49PlqBHk+v3l4e 75CqKDs1RSDcGcVztwsa/SK+d3Z5s/hS9puBDkqqrYe5QgGvNMAcvYutDALvIpKgQbXHJ2yrQ+Q aRe9wc53b7QZn0rRN8EnFyMmARkpuYWvAyjQuT/CYz5z/VPxuySOoLBOJfI5QO40VGXW5/jiw2H zSShFbjpaD/6dc08Dce+BoifGaQ1HIfmEzXMLrDQqE+o2oNPuKr0B4Ttn63oAKzuCQNSxIvdY32 feZEOWtv/skAVwtOXoWo0YsVfKtGptXss2KNH5SApyDv7qW65COtqI+p0t86dkehxg329mhjMVy 11i5U7g8NGxYe3fQ/9GeFsgt6Ct/CYwHc9IoSfc7Q7XwBy71dxX+cIbkfli0DsMqHyr7D8BpCuV 2kZ0hfemzTp1II9GaaiprV7t3Eir2x4xTWHtxLlWtkw/9cXjdoA0zZpPuY2RQfihthm464mzfg4 sRHjjjlrxzLO5wDl6jMoFwLSrYjbZULYNBH5q9iFzL2zZbzipiM2UJqXvnm+8UfB9lhvd6X4Nb7 fzCeaDBtxFSUpssgF2Pyygqc8k0RpRC7Wx+b3u9b/MPH8bZM4LkblbDYt4NOzLfzci5Jh/orenp BBUZnhj9mJkfVmA== 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 ; Thu, 29 Jan 2026 15:24:29 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8807 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard --- documentation/overview-manual/concepts.rst | 74 ++++++++---------------------- 1 file changed, 20 insertions(+), 54 deletions(-) diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst index 9ca188960..fc67295cf 100644 --- a/documentation/overview-manual/concepts.rst +++ b/documentation/overview-manual/concepts.rst @@ -211,62 +211,28 @@ figure `: BitBake needs some basic configuration files in order to complete a build. These files are ``*.conf`` files. The minimally necessary ones reside as example files in the ``build/conf`` directory of the -:term:`Source Directory`. For simplicity, -this section refers to the Source Directory as the "Poky Directory." +:term:`Build Directory`. -When you clone the :term:`Poky` Git repository -or you download and unpack a Yocto Project release, you can set up the -Source Directory to be named anything you want. For this discussion, the -cloned repository uses the default name ``poky``. +When you :ref:`initialize the build environment `, you can specify which directory will be the +:term:`Source Directory`. -.. note:: - - The Poky repository is primarily an aggregation of existing - repositories. It is not a canonical upstream source. - -The ``meta-poky`` layer inside Poky contains a ``conf`` directory that -has example configuration files. These example files are used as a basis -for creating actual configuration files when you source -:ref:`structure-core-script`, which is the -build environment script. - -Sourcing the build environment script creates a :term:`Build Directory` +Setting up the build environment creates a :term:`Build Directory` if one does not already exist. BitBake uses the :term:`Build Directory` for all its work during builds. The Build Directory has a ``conf`` directory that contains default versions of your ``local.conf`` and ``bblayers.conf`` -configuration files. These default configuration files are created only -if versions do not already exist in the :term:`Build Directory` at the time you -source the build environment setup script. - -Because the Poky repository is fundamentally an aggregation of existing -repositories, some users might be familiar with running the -:ref:`structure-core-script` script in the context of separate -:term:`OpenEmbedded-Core (OE-Core)` and BitBake -repositories rather than a single Poky repository. This discussion -assumes the script is executed from within a cloned or unpacked version -of Poky. - -Depending on where the script is sourced, different sub-scripts are -called to set up the :term:`Build Directory` (Yocto or OpenEmbedded). -Specifically, the script ``scripts/oe-setup-builddir`` inside the poky -directory sets up the :term:`Build Directory` and seeds the directory (if -necessary) with configuration files appropriate for the Yocto Project -development environment. - -.. note:: +configuration files. These default :term:`configuration files ` are created only if they do not already exist in the :term:`Build +Directory` at the time you source the build environment setup script. - The - ``scripts/oe-setup-builddir`` - script uses the - ``$TEMPLATECONF`` - variable to determine which sample configuration files to locate. +:term:`Configuration files ` provide many basic variables +that define a build environment. To show a list of possible variables to +configure from :term:`configuration files `, see the +:yocto_git:`local.conf.sample +` in the +``meta-poky`` layer: -The ``local.conf`` file provides many basic variables that define a -build environment. Here is a list of a few. To see the default -configurations in a ``local.conf`` file created by the build environment -script, see the -:yocto_git:`local.conf.sample ` -in the ``meta-poky`` layer: +Here is a non-exhaustive list: - *Target Machine Selection:* Controlled by the :term:`MACHINE` variable. @@ -371,18 +337,18 @@ figure `: configurations. This type of information is specific to a particular target architecture. A good example of a BSP layer from the :ref:`overview-manual/yp-intro:reference distribution (poky)` is the - :yocto_git:`meta-yocto-bsp ` + :yocto_git:`meta-yocto-bsp ` layer. - *Policy Configuration:* Distribution Layers (i.e. "Distro Layer" in the following figure) providing top-level or general policies for the images or SDKs being built for a particular distribution. For example, in the Poky Reference Distribution the distro layer is the - :yocto_git:`meta-poky ` + :yocto_git:`meta-poky ` layer. Within the distro layer is a ``conf/distro`` directory that contains distro configuration files (e.g. - :yocto_git:`poky.conf ` - that contain many policy configurations for the Poky distribution. + :yocto_git:`poky.conf ` + that contain many policy configurations for the :term:`Poky` distribution. The following figure shows an expanded representation of these three layers from the :ref:`general workflow figure @@ -840,7 +806,7 @@ This step in the build process consists of the following tasks: :term:`PACKAGECONFIG_CONFARGS` variables. For information on how this variable works within that class, see the :ref:`ref-classes-autotools` class - :yocto_git:`here `. + :oe_git:`here `. - *do_compile*: Once a configuration task has been satisfied, BitBake compiles the source using the From patchwork Thu Jan 29 15:23:13 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80009 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 2D99DD6B062 for ; Thu, 29 Jan 2026 15:24:29 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17198.1769700259996853148 for ; Thu, 29 Jan 2026 07:24:20 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=LD4HxvRF; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id 784A9C22F4C for ; Thu, 29 Jan 2026 15:24:21 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 77434606FD for ; Thu, 29 Jan 2026 15:24:18 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id D575D119A8860; Thu, 29 Jan 2026 16:24:17 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700258; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=lRJ1dKproiVYX5jbrtY4m4y/HA45997KLd+7u19TcGw=; b=LD4HxvRFBxbxeCTHti3TFqW/9AIPCHPkTwfC2oLhRbIG3KVfo1TIAv6vsRxD+JKTzwunOB VjPdAij1eelQNuIEfmxTwzOiy0KSzdWv9+24/x884bVi+Nn6CbQsUMfkCjOCv+rduTrxAh +a9eUZclXTslkUayK1khvkqF12avX8XYrB47NmkPUMhwCf2hPWLVnhvbgviZ40Qb9T/rew seEzOIFLnTvsBjTQwyZcyQSh3KkSUpsnF3/JGx0pUt7paTY/txTTLihSDQCwc3L131WiYe SIYCrMHAGT+iQ7de9J70eeD40g9KO8ch3zpVircril/OhBCdQ5Q5wO94ywVRIw== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:13 +0100 Subject: [PATCH v3 22/57] overview-manual/development-environment.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-22-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=11845; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=Uwf/Ve7ZsX7/9Z8x/I4w9QopCFlWlEBx+ra3Sc+uPt8=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uMujrw+xivNlkerzyJtSkoFItYpV/TKFNxn 9AA1mJjc0+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jAAKCRDRgEFAKaOo NoDOEADNNyW/a0sdT2NMPVblzIYTdBAtZLzqsEwsAJX92HINolcpQhXjABF1e8G6BI/PdtWICwU +RKwE6vLZetO0QjdAgpYeazWAGXadgBBVjEqSZ3hV9FJz+CYIwxm96oQQnpN/RPPAVBGLyPqv3C zbCp+IgK3y+MGbV3pRg9oz9XOVOwrKcwfyR/zZb2A9PcjqSW5lpeGJFIKPM3oTGz1Vm7e+++RSf 1e6rqQBxvAqM8bVSXAlXZ6YTjAI/JFw0LchpVIEWeAMT4bekdC3iDVr6bVIbgKRRyu7C5FbQY9n ZbzMqGscbS1yq3bdawlTm4l1RRp+VZQnFTCe21CO4LccApQP3ed5M7KLQoz2Qdbr8qdBffhNN+x TKHqya0WYyAvCic4D2ki6eqpGO1APfIF5vgoKeja/nNdR0lYIzEOl3cBMWEQXKueKuJtCenvI5U ZW6BdRKwy0JhkWYexNF6/SQFYsE3BQHK+Y4ipMmZHOC8QTHmRdnMjRkGQPyOE7vHOB4Y1waVTB6 tnNUFKyGWcw+2gnzcUBwzsDAarz+fkTkCaI10xC/9Xx/sOWgfT6lPP9vPo0P1h756If6LO1UaPt j83iwkA6DcUBc9bcU7zE2wYNHwv0eHhvmWI++j66/Pg8hLubBM11K6WoyUkEP2FsLD5mS8eDLMY bAZzVkrSnwuYHtg== 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 ; Thu, 29 Jan 2026 15:24:29 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8808 Remove references to the Poky repository, replace by OpenEmbedded-Core. Replace the poky examples for the Git section by yocto-docs. Signed-off-by: Antonin Godard --- .../overview-manual/development-environment.rst | 87 +++++++++++----------- 1 file changed, 43 insertions(+), 44 deletions(-) diff --git a/documentation/overview-manual/development-environment.rst b/documentation/overview-manual/development-environment.rst index ab9bd084c..7408a4c62 100644 --- a/documentation/overview-manual/development-environment.rst +++ b/documentation/overview-manual/development-environment.rst @@ -148,45 +148,43 @@ code browser is organized into categories by function such as IDE Plugins, Matchbox, Poky, Yocto Linux Kernel, and so forth. From the interface, you can click on any particular item in the "Name" column and see the URL at the bottom of the page that you need to clone a Git -repository for that particular item. Having a local Git repository of -the :term:`Source Directory`, which -is usually named "poky", allows you to make changes, contribute to the +repository for that particular item. Having a local Git clone of +these repositories allows you to make changes, contribute to the history, and ultimately enhance the Yocto Project's tools, Board Support Packages, and so forth. For any supported release of Yocto Project, you can also go to the -:yocto_home:`Yocto Project Website <>` and select the "DOWNLOADS" -item from the "SOFTWARE" menu and get a released tarball of the ``poky`` -repository, any supported BSP tarball, or Yocto Project tools. Unpacking +:yocto_home:`Yocto Project Website <>` and select the "Releases" +item from the "Development" menu and get a released tarball of the +repositories, any supported BSP tarball, or Yocto Project tools. Unpacking these tarballs gives you a snapshot of the released files. .. note:: - The recommended method for setting up the Yocto Project - :term:`Source Directory` and the files - for supported BSPs (e.g., ``meta-intel``) is to use - :ref:`overview-manual/development-environment:git` + is to use :ref:`overview-manual/development-environment:git` to create a local copy of the upstream repositories. - Be sure to always work in matching branches for both the selected - BSP repository and the Source Directory (i.e. ``poky``) - repository. For example, if you have checked out the "&DISTRO_NAME_NO_CAP;" - branch of ``poky`` and you are going to use ``meta-intel``, be + BSP repository, the :term:`OpenEmbedded-Core (OE-Core)` and + :term:`BitBake` repositories. For example, if you have checked out the "&DISTRO_NAME_NO_CAP;" + branch of :term:`OpenEmbedded-Core (OE-Core)` and you are going to use ``meta-intel``, be sure to checkout the "&DISTRO_NAME_NO_CAP;" branch of ``meta-intel``. In summary, here is where you can get the project files needed for development: -- :yocto_git:`Source Repositories: <>` This area contains Poky, Yocto - documentation, metadata layers, and Linux kernel. You can create local - copies of Git repositories for each of these areas. +- :yocto_git:`Source Repositories: <>` This area contains :term:`BitBake`, + :term:`OpenEmbedded-Core (OE-Core)`, Yocto documentation and other metadata + layers. You can create local copies of Git repositories for each of these + areas. .. image:: figures/source-repos.png :width: 100% -- :yocto_home:`DOWNLOADS page `: - The :yocto_home:`Yocto Project website <>` includes a "DOWNLOADS" page accessible - through the "SOFTWARE" menu that allows you to download any Yocto +- :yocto_home:`Releases page `: + The :yocto_home:`Yocto Project website <>` includes a "Releases" page accessible + through the "Development" menu that allows you to download any Yocto Project release, tool, and Board Support Package (BSP) in tarball form. The hyperlinks point to the tarballs under :yocto_dl:`/releases/yocto/`. @@ -230,11 +228,11 @@ and so forth. ":doc:`/contributor-guide/identify-component`" section of the Yocto Project and OpenEmbedded Contributor Guide. -The Yocto Project ``poky`` Git repository also has an upstream -contribution Git repository named ``poky-contrib``. You can see all the -branches in this repository using the web interface of the -:yocto_git:`Source Repositories <>` organized within the "Poky Support" -area. These branches hold changes (commits) to the project that have +The Yocto Project Git repositories may also have upstream +contribution Git repositories suffixed with ``-contrib``. You can see all the +branches of these repositories using the web interface of the +:yocto_git:`Source Repositories <>`. +These branches hold changes (commits) to the project that have been submitted or committed by the Yocto Project development team and by community members who contribute to the project. The maintainer determines if the changes are qualified to be moved from the "contrib" @@ -323,7 +321,7 @@ Book `__. software on which to develop. The Yocto Project has two scripts named ``create-pull-request`` and ``send-pull-request`` that ship with the release to facilitate this workflow. You can find these scripts in - the ``scripts`` folder of the :term:`Source Directory`. For information + the ``scripts`` folder of :term:`OpenEmbedded-Core (OE-Core)`. For information on how to use these scripts, see the ":ref:`contributor-guide/submit-changes:using scripts to push a change upstream and request a pull`" section in the Yocto Project and OpenEmbedded Contributor Guide. @@ -377,7 +375,7 @@ local experimentation on projects as you develop changes or new features. A Git repository represents all development efforts for a given project. -For example, the Git repository ``poky`` contains all changes and +For example, the Git repository :yocto_git:`yocto-docs ` contains all changes and developments for that repository over the course of its entire life. That means that all changes that make up all releases are captured. The repository maintains a complete history of changes. @@ -390,10 +388,10 @@ locally. It is important to understand that Git tracks content change and not files. Git uses "branches" to organize different development efforts. -For example, the ``poky`` repository has several branches that include +For example, the :yocto_git:`yocto-docs ` repository has several branches that include the current "&DISTRO_NAME_NO_CAP;" branch, the "master" branch, and many branches for past Yocto Project releases. You can see all the branches -by going to :yocto_git:`/poky/` and clicking on the +by going to :yocto_git:`yocto-docs ` and clicking on the ``[...]`` link beneath the "Branch" heading. Each of these branches represents a specific area of development. The @@ -409,15 +407,15 @@ development branch in the repository. To help illustrate, consider the following example Git commands:: $ cd ~ - $ git clone git://git.yoctoproject.org/poky -b &DISTRO_NAME_NO_CAP; + $ git clone git://git.yoctoproject.org/yocto-docs -b &DISTRO_NAME_NO_CAP; In the previous example after moving to the home directory, the ``git clone`` command creates a -local copy of the upstream ``poky`` Git repository and checks out a +local copy of the upstream ``yocto-docs`` Git repository and checks out a local branch named "&DISTRO_NAME_NO_CAP;", which tracks the upstream "origin/&DISTRO_NAME_NO_CAP;" branch. Changes you make while in this branch would ultimately affect the upstream "&DISTRO_NAME_NO_CAP;" branch -of the ``poky`` repository. +of the ``yocto-docs`` repository. It is important to understand that when you create and checkout a local working branch based on a branch name, your local environment matches @@ -432,13 +430,12 @@ Yocto Project Release. Git uses "tags" to mark specific changes in a repository branch structure. Typically, a tag is used to mark a special point such as the final change (or commit) before a project is released. You can see the -tags used with the ``poky`` Git repository by going to :yocto_git:`/poky/` +tags used with the ``yocto-docs`` Git repository by going to :yocto_git:`/yocto-docs/` and clicking on the ``[...]`` link beneath the "Tag" heading. -Some key tags for the ``poky`` repository are ``jethro-14.0.3``, -``morty-16.0.1``, ``pyro-17.0.0``, and -``&DISTRO_NAME_NO_CAP;-&DISTRO;``. These tags represent Yocto Project -releases. +Some key tags for the ``yocto-docs`` repository are ``kirkstone-4.0.30``, +``scarthgap-5.0.1``, and ``&DISTRO_NAME_NO_CAP;-&DISTRO;``. These tags represent +Yocto Project releases. When you create a local copy of the Git repository, you also have access to all the tags in the upstream repository. Similar to branches, you can @@ -449,19 +446,19 @@ The most common use is to checkout a working branch that matches a specific Yocto Project release. Here is an example:: $ cd ~ - $ git clone git://git.yoctoproject.org/poky - $ cd poky + $ git clone git://git.yoctoproject.org/yocto-docs + $ cd yocto-docs $ git fetch --tags - $ git checkout tags/rocko-18.0.0 -b my_rocko-18.0.0 + $ git checkout tags/&DISTRO_NAME_NO_CAP;-&DISTRO; -b my_&DISTRO_NAME_NO_CAP;-&DISTRO; In this example, the name of the top-level directory of your local Yocto Project repository is -``poky``. After moving to the ``poky`` directory, the ``git fetch`` +``yocto-docs``. After moving to the ``yocto-docs`` directory, the ``git fetch`` command makes all the upstream tags available locally in your repository. Finally, the ``git checkout`` command creates and checks out -a branch named "my-rocko-18.0.0" that is based on the upstream branch +a branch named "my_&DISTRO_NAME_NO_CAP;-&DISTRO;" that is based on the upstream branch whose "HEAD" matches the commit in the repository associated with the -"rocko-18.0.0" tag. The files in your repository now exactly match that +"&DISTRO_NAME_NO_CAP;-&DISTRO;" tag. The files in your repository now exactly match that particular Yocto Project release as it is tagged in the upstream Git repository. It is important to understand that when you create and checkout a local working branch based on a tag, your environment matches @@ -596,7 +593,8 @@ MIT license :wikipedia:`here `. When you build an image using the Yocto Project, the build process uses a known list of licenses to ensure compliance. You can find this list in -the :term:`Source Directory` at ``meta/files/common-licenses``. Once the +:term:`OpenEmbedded-Core (OE-Core)` at :oe_git:`meta/files/common-licenses +`. Once the build completes, the list of all licenses found and used during that build are kept in the :term:`Build Directory` at ``tmp/deploy/licenses``. @@ -617,8 +615,9 @@ Source Definition and the effort for reviewing and approving licenses that conform to the Open Source Definition (OSD). You can find a list of the combined SPDX and OSI licenses that the Yocto -Project uses in the ``meta/files/common-licenses`` directory in your -:term:`Source Directory`. +Project uses in the :oe_git:`meta/files/common-licenses +` directory in +:term:`OpenEmbedded-Core (OE-Core)`. For information that can help you maintain compliance with various open source licensing during the lifecycle of a product created using the From patchwork Thu Jan 29 15:23:14 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80012 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 44977D6B065 for ; Thu, 29 Jan 2026 15:24:29 +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.17199.1769700261377471922 for ; Thu, 29 Jan 2026 07:24:21 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=Lbe2xS+7; 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 CF33E4E4231D; Thu, 29 Jan 2026 15:24:19 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id A6950606FD; Thu, 29 Jan 2026 15:24:19 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 6A4CF119A8864; Thu, 29 Jan 2026 16:24:18 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700258; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=p0q60Zgi2Za6WpCV3SrI8Yn0tnU0wwhYq73/McZdq44=; b=Lbe2xS+7C+NrxJ2OI5cm4SEgxE1DX1pu7YoQh5Da++8q3d63gTFf91xqcFXxFt6yrHcT4F JWYI61oO5q8q4iFuFLiTCUIKP2oG9s6tOxK87t+oXmK8TtgnTsEXK3L8oVay1mSMtvapyw T3h0QymhsiBhfVTsVqazU0pYW8gM6iq5ENRvtHg19chQzr9W7rUh6ru6krNMrct4JS7BoT p54k39jA94HLSghONBcBJQ1SheG6hppgtLGe8nMbPNY+ppSGLk4KAXNmoqP0fNUVC0etyx MJS4L+jnzJAbaJTeH7obUaQCI2fhc6CKgwbTmorxhSrsPaiYFeNg8U1hXyS2ag== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:14 +0100 Subject: [PATCH v3 23/57] overview-manual/yp-intro.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-23-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=43627; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=tauxRzgQxvBp1LsRJXR4IQjrdU5CwnZRtaQPtAD264c=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uMhAxbB0AdUZZeYhxuGONz7mnjbVWRE+/3W 4ZTBAKnMvOJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jAAKCRDRgEFAKaOo NtyFEAChD0bFd8vmVGOFdkjkxVwz7WHUYZxLI/X5Q59eNpqkxKJUFqne5uDXNVcu/NKivhBYP7k heibw+Q27wEh+AmytSHTfG86aaGpXfh2dFDiyRixZ/8JYWbkaA8rl7Din+wqVitTfg6KQ2KhK5v ugbHpMzZWtcAK9QCZ34lvyUC5UGD/wN7UXS9RaadSUGdGnirJxKArKgE96B4EUDCaWGK6/l7EEY f0gBcvsutL1K1PY1VeZmaGfABGMl4Ho6JXN/sBF6qjIbtLEgnDX85C2fyPCSoSH16A0sros+vdz gVidyjTW8wuCQiqge98aSZwlZMV1BOmYgt7g3ZdxQtu8sXYc2oAwYkr51cFoo4vtc2GxpCAWnBg iloc8xg4xqhWEhVS/QEN7yj17WNROTiOA3p256qs9GJDZykt3nGRRcFzjNwKshEIqVcr7LNIqmT kWsTXELHLhCHo7yXaDO9qCbqzZTbS1j0d0G/Z0PzvRzn9IXP2JNjhlSPlACKH9MwiBTuSQVNzc3 rxRC0RVgAMRsNhlsOfyOHND4x9sf6eRBe+Vs0idnsDoqj+sBXNm2vW7CHoJKA8H/1SiYRl6pD3V yJ4OWTzWZJBISd19GE81kbHZuuVebNAsgCOFb741+ZN3FfzNOaafmj8Y7gKvWwTETyvbIKq+Mlj FXmka1uIFRbBNUA== 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 ; Thu, 29 Jan 2026 15:24:29 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8809 Remove references to the Poky repository. This document had a lot of reference to it, so a lot was removed. The "Reference Distribution (Poky)" section was removed as there already was a "Reference Embedded Distribution (Poky)" below. This section was simplified as now Poky is just a distro, not a repo. The historical section was also updated to mention the obsolete Poky repo. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/overview-manual/concepts.rst | 2 +- .../figures/poky-reference-distribution.png | Bin 23784 -> 0 bytes documentation/overview-manual/yp-intro.rst | 155 +++------------------ 3 files changed, 21 insertions(+), 136 deletions(-) diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst index fc67295cfa..2655b0d3a3 100644 --- a/documentation/overview-manual/concepts.rst +++ b/documentation/overview-manual/concepts.rst @@ -336,7 +336,7 @@ figure `: "BSP Layer" in the following figure) providing machine-specific configurations. This type of information is specific to a particular target architecture. A good example of a BSP layer from the - :ref:`overview-manual/yp-intro:reference distribution (poky)` is the + :ref:`overview-manual/yp-intro:reference embedded distribution (Poky)` is the :yocto_git:`meta-yocto-bsp ` layer. diff --git a/documentation/overview-manual/figures/poky-reference-distribution.png b/documentation/overview-manual/figures/poky-reference-distribution.png deleted file mode 100644 index 1be89ae68e36c6e37a4903d0688d5bd1ad36b87a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 23784 zcmeAS@N?(olHy`uVBq!ia0y~yV7kk|z-Yt4#K6EXdFd>91_lP^VkgfK4i1jn5B(o7 zFfd4#xJHx&=ckpFCl;kLr03=5rs@_a7p11=6=&p^yl38T$H1V#;OXKRQZeVv-O?D5 zpVI6f($mT#cLfSK23RfSIl^?*VM9Ruj2kPKCsp5jIrrYnh4b#-TbYnJx0AK&u7X;J zuBM{w?a#lPZ_S7m;Qm;-{~dpR`LpQV2K<{he^%7!Vrmg^;#kPm@aGz{1BYUZz^ax~ zPA3k<7AdYZ-U3b>idO;>Vw*rp+L&Gofz+CcL`+v`5pY_u@W3t>#TEf4Ue;@>Ae~tn z8}uAG6k7tE8_|t0NR{6u_5aDg?mz48ML>r9wcwa^arNG{Q#<>PG;i8j8@o)FO&7Nxg!^_@9`QDzfWv)Tx>Al};KK}hV z^ZGYmS%V9EcJ2-f?oT`C-2SKR+0pjhi=%dBn@;_!U+~r2?#ewi28Jp2v(nV}<-4>0 zw=c8N5Ibp?`sQ-li?$Ue8`VTg0=MS(KW3d$BK|JQw_3mAM5xKunATunkWr@oV~CfzXM4?8*asC9fXV=W6PnY`G&G{-deZw7b6q|b@_W6p?o za_Q@Fc5AU^7$%)A`Fwr$vMuvBe7>?+=F*vShvU|NdHc6^zyB+XuSv@`B&GkGU0ZyM zZQae<$FcKPt?XW%DtvEsaWwy3?cmKt+Y2{rFWQh5RM--bo%k>z|LKFQ%Ra6Dw@foz zx>0w|o?AC(YEEB%&(^T`!KBObE|2_63(T*JiKxZ*NPNA#v*(o94*A=xnO80yym#v0 zy;BRf)^eK$UA%Hi)W`QvhK7&z-tSE8KEHn7)Y6W5a#D9j(Q;3-w?+$?x#Qkiep#@l zZv8v{uAgh!8w8wI{0o`up3iA{zc%~W#GA8!>8d}M(_=80vm^5hlA&d0AS2i9DYElU&$$}-cMEI&x3aA5W*eWp`k(9J(Q`ustk*U|lp9x8^|rs>Zs$oli`%j3h%j0`<)|Gs%kZ{5UgSpJhC!9I6O zGaDmAPuf1^HYxXfpYyvVCLjB{;fbA1aW6B&wc`4ZhHEV{gmQ%W%UNTm+O1sbYxXv8 z(WfuR&lfW=+?aLh(Q;LduKC{|xhgVj(0S7vS^A=Bo!-vP1v$U3@-QfDxxL=nU~#Y3 zl$t+RR0@pq_AX-JiS1pjrjkC9v+q!*(binus}C~2?R}C|aBX$=d;2~5anp0`r~lJ) zU$R{7_eW(Xj@p*zJDct|-4Js#s=xd114r+*{p+L)j6S@mX1MVE{+I6AVv48EXg*+U z=xW^P7OHvRirHmGkM>31k2(oVefFe~!QtkHseFs`{&sj}XHGu$w)5^5^|0Q{g&!=c zQx~k7|7smG1B2Gu_IEdK9PS95u9wjl8S-uSk{kwx1W8dYZK{`AM$Yu5To<#4O_FUwIiwLQJfF1gA2wg&T*aJ!|~ZmnjXC^2_J z_`eTvF>Kq*jnx9H#h-49-EzCk@l)}fDj#2==Cw%Ey;!_e^(gh7*-@PEM|Is+yQRbJ>O`S5GG~ z#HxFr-Nh@z2rhMdg$}Ry{b}bnpN8~ox0@AxZ{9u5xBvBqo#F4k&ChqOVqmzrP0%=g!dUnn1(7J~6S(Zg#_cmW{+iHGQuddu) zPjha@#pFi{<-V-PTcd9O$?#hH>+daR(FH#;Zmhii=hm(T8eL2b3Z9F8^{`I;tEc(1 zH0aaoCF%b2#JOHun-;E_#{B*zgzBGsn5aJ-U3eZGhR(Bdt5DHy=BGq`%hN{KG@gs;?>rNni)KH zWxwS8uj=0r4y~#!tKYx($c)LyuWeZy?%vcRTl@QL&5J$nu3bx*ToqgQo7uysUDiM9dv1r|?)lFd9VX{3mf2rW>9wLXqU^=XFGfMD_kEX5eDO2i z`rh27xpzdmC-paj8Vw8E{Ac|Clq$Dk>z7x?`frx=Nx8hOu90e5d-qPr@8ECwm-gIz zE`5%l1>6+jo!|C< zgihIE{U>jm0E5Gf%021JOZ#^ycyxaGcyrznVQJ5+!CfLDXO3P!bZvL*>z4aTpIaCd z&UF8MtuDU%U0C0~X>yP2cSnb9mHa#9Xs2C_-244@`~G}Bv*q29>n@C}*^73xTIoJ} zF1`H6wE3&E84jN2Ro=UO*~i!0%|nZ-Z$|9C#yD^C`X{Gq|Ej8K{GPYu(|Z3`+wJzP zsZ$0w>}H&8Yva}XQGNGjjNla2b-z>>y5G=nPgU4z?Q*BLa&n2qnFl2=W-Xbu*x>!y zwuPVlX87;_^W)IxmgMJRR?||ao%}Bw=fCLD5!;7_mQD-|ZFS2-XR}3WT-|RPwA=Z} z-51k6#UD+7DHl`p$yEN-`~108cWMr={d``2e!Y-P#ctq2U79(H$kHY@f`3xbyV%Ii4qiUhl5^Ty*=zyua&bT5sa&{$wOEPkX!nmrIHZZ9eu- zte@kdtE(Gc#5vPkqcA@vC~(95wQ6#gzx(;lHhp@xYsSkmhLD?|&nCCs_c^1Ne=+~} zxe4E{7B8?kIq|gfwWCizxMuk|Mw{~#UsOm@^ZIDPv~1lxDbA)tYlN8tKR0uSdhF2? zhc4@U-FSP~iwVzkW-@XHJy~~2D}L+rN4@J`&y@_@tTvH5^m?fN^(9OH`)mnY{VH-s z_12=Do0N9*?|J*+n8(=@KB*;lHWYg_R&aaE8mY3sSNSjdN%a`#qCcNQqor=_{3zTJ zYIu3>4Wrub{f26~f72J4T89?JJye`0rD`62R$6}EqMVeA2lq@Vnw;SWZa90gPVqmJe~tD35v z8XoQ8oNuJ{%P%Xl`@o02iu0m!vhCZiCvM-&TqRxi=O#a>fy%*fgKzTl?_XvbXDEL;^evI zw;0UdZoT)cgZ*3O?O%WLD~{Zm(Y^f3`}J?Wyq-BF*C)zVhu`>S{NMX@j#@ch!7U;pmh{@T9WPnFy6Wv}`2d*<}H$+q@M-AgAK{Pp;=`V=Qu zP+URq{MGBaJMJH|H?Dhf>4oBQwwIc-cbnCU{@$}^`@&g^RF}4bY7s^TfmdaZ-L~{p z8E@I`_%zXZN`3N<+2*s8%s%tnGP>&(S(EMcs!Ax(?@n#v^~iaFYtl6!g6K$^Dd0KSF=ID|adFxmh((K+!Y?e#seiIeIy8Zh4 zh|-UH13FLChu&~L_mned^E&4k6Az&nChLvQY|hOJ2$b(EdLL6cC&p@Lybh;BVOM4D zXV!q==@V|rmfefF9_u`%zBso3q;yrxoa=tKYa?^M?5Hl+i`^|~nVRur%H8MgUOttN zk8FxpYxPa}^5*jCK#gEzFy-gkRbXZzsmF9snd~5 ztJmkLpEl8R)7Thed;jyonQvCICCuLTI_D5m!j^(ddNt7+AJ$Z!e8INd3F&nJ%B>zFwX5C!p`y-!oeo%eueW zEi;if-FS94UrC6%=fcU$9UtCyVtk>waqCw__0@BjOm9vu+X}8mv?lsYO1bh!O10GL z&EC!HcC#^jm~_o|!`*p@(xY`Pwwawc7FC-3C)@A%wNsyND{(M2Bxo6G%}ScUW7f=| z;KAk?D8iungj<7w!AnCRh=HMXdbobYm6s_c^~GWL4*pBd_n2;1GM6EQf4Y$1uYLRH z+<&lYRR(|1^3wEhzZ+Y5>a4xR46a0P`?yRXhWfI!&j_?lA~HC)urUe2(?_wZ2t{9V3>pdX>d7usE;$wAWk9 za7h-U=<|~sH{M+pcWSGkTafT-=a&uwA`AzE(k|tC8))xRk?>*C5}Wy`xTR>@I^MYN zT>?&9gEr0mmw)NE>Ih1HH~Ybx^k@=S4F9r^3$?fT!y&ai0H^zWBfE^C{`)2VyfIOy}%HB~&ae~F1E z<_DkF{N=}5`90~~K0W0xv2$IfFP0bSTrugn`=TK2{p$jM=EUyX>++()!<=u;E7OUQ zdK<52Y}t6nSvv4?(;-pel=-oH|5nU;B&;#t>YSnOjHJgCuW!xa-sHh-F8=A+TJso& zxU?LfRZp&0Er~nDQ)>S5`zoJCU#Sy&<{#a@P;#4!x=zfdHVN?sGgfvMHgN4?=yAf3R>9TiJp8S;7Z%3m9pjD9jBLk zzca1z|GQ0rj7@h-WB%Vg{hLMV)ykLVrb)t5=MKv%xs`BSc)#Ppm70yRzH7YA{Yz#} zIchBbZG}>@JUW7S9t@+xYw@FdO8Y_P^xXl#cidgpdf5ffm z`Ah6lWPVp3-LhSV$z|0w+yD0-EOn0&mR1NYu&+7szWg(T%PFzP*S20=`R{W0)v5)- z-%c)1t=)Si!|H17&cbKA%9fY=7s>42_I-|F?w=dSro~-rd!^+g#9$G6ewLSrKRU}rcUr`{U3-fhUR~KzkT$pEx1a9nZIAc&+m+m1^nb>#Ek89MuaWDY zS1lfzaG})qMd{kwWjXB+uHF^z`MN(jWx=}S1=>F&yT5p6zPJ$fYp>Sj1)KIR`o8&x z(Y!gT)-r){hh*c9bFO{$_3NT8;Vz+FKGp)3yQj|j^xSglr_<}&Yh{CPZPodsvsSUC zE+V*pi}d}&Hx?cZ|6lYQ2FZchi{|;*N{J;4|_xtWmy&GSjcl%+NbYsyUd$ZQ4 zQ+15qPDxg8I(~jQ9~1wP{bLQM6UV~-#m~&jKA!$zBlkkf!e8-EL6zH!_Ejzls-neV)R0PAWUlJ5Y%qG{X61tD$eRUfiE+%|AqV?)EwF zzP`i@g@?<ou@Z&=H* z(fia&JI}z0x3`DcY+t|H&N)PAd*-tCV1H@%|MR-nrExh-5PJF6GC%DDM>>1{@(0f4 zdO30zR`&1wI^n`+`5l@QWACci-NiPV9|sSX=zyg6?;} zmbbm$Rzh#g59K??)V;eJ8O*o;31i69Z##GXy7l#b%+6%iuE~4q3$Jhc$G5I7xB0u8 z$m#X6N33tnit+j=rz?4W*Kx_^DRnQin%`7mezd4bXP_s4Sn%bpd}U*VlMUphB0{>D>d&+@R+-Lhup z+a|2?sN%l+O(F67lQUlrE6-ZLuj19myzQ&&=X(k==&N6^`*-Sp-#d=?CE3?zr9Taj zJTF%MJLS<=S26c8k$$;ndD0SfRp(!(zMJ((cB$HG|C>en?_Tgd_r9!M#?mm0WA9}D zNBsGlt*w)vTg#nLym#@T>Hk!t+_rCGvX;M_*aK$mFpjDYY1r7Y&NQy9@9Urai~DrH z)d>l{{gHm>?qbgE-`Bib)yppQMe^bI7C|SD2fNR{J-sqIZ$8URnH>}TY@1A-zpM4l znqK~6R^)^AZ4;^+)h@5I+U9G-es0D#;g(nIpnmMCFO|i=AFO`zEp&Bti<~c?%;uHx z8v-4U@a~?Ya{S_FUJsAynZ6S~tpV#>r*?^dp?~}G`vO@8UH89~MyyWUogT|o7kB@{ z74_}@AOHI956qK4ak5dFcNfpL{hLbe1yAREYuXtVHCg&)`-SDd&z+mTr2EZvH|d(! zfeYAr876M`O!EJIC*Ow8?^($F=7*J6|DQK1-8$=I@p41HoIlwQc7LyZ_KnrDJV}^g zL5gWvl*28ql`MdzFQ@1LhnTWQx_-u|~UV&T2{ z&)a>?kG^u1diJe0a?bPmFMsB4)veiAdRS68>xqg!tyeqGD1 zcl z;@_UU{d2b*S;SJCd_O+6>B4vSBmVwpPBJniWN8U6`ePp4KF>CU;gy*#`-|u9vGseC zit;j_bZiI1R*u6)a!EaNxkt zBmWvY-a3CPOJ)>lZBL&T@-A@0*X5J{FEO}N$7Lg!w8XP%TJ-CKzZllfldIF#@vSOb z$#UT2#_fXtJ}9+FDcZz0U6_8<%slII%gQCI(q5(+eyd-bGsX2}W~vf{K~~l&HiZb? zw^trI)n%r6cCL7IiZjv8j$!vrj{j=2M7OqkP2SiT^*>MdM!nMM)jwkG1m3pKFi);I zY^m6CVR}<3r&Ij2)BcRht58`WY&jfC1ueh;ZiM7kAbLkaL$sN<~t=zNOm}mC4zsiB{Y+s1> z$C#~;IB4;bO{ZdK;*#&zOzPfFUZL`deX7hJZT)4#rthzfo<8`i zB=~m8ia)O>|61Fxzq(ld#cps2NUywHba|hg;@d4Nj$HpAdp0;T)h;{v!Tfbzrd!#( zlP_#y^o}xK@ua$Txr)tG27@crtg}}#F&OM-oB84~|GVd^>i!XoA2-Awec{~sQmOK_ zoRrS?@>LIR-AfS;KX~&0y;It&U)dE^+L_*oNP5>4K5=*OA9jnC3?JgwOK&r{mV5E8 z`}6tsH%$HiK6v2y+=#_wvQmkS+OA`NW#_hkm(Q8<;kvX_eA}jrZPE*mdM-2+l7AEu zl$*M{==zH@OD;TGa^cE~efxiBY+`gc{O8Ez3y+ovUiS5LI-212)DP@>CkUx(nq@co+Gr%vFD*)is@moo$s(=KK7)vDMZUEL$YEl|G&{Yr}n|nJS4= zKDFoL&VD|({(XSx$!d+Q0a^Nqr5PJ?j5ajgJ8C8P^j^0|S;Uv)4&QcOKEH#3;m(q? z^Xl4zSQ!rZ$Jw5#{`~lI;?|xRt@RPRTGwXEY%F-Zs;@h5-JF#C_s_58Ui;;~ROEt> zqfOtBfU3~QBmTB^F&B2vR^(pr=ionC*V?c)i;Rg3Yt(G(`En<3_7U$NW*L?jGnHr0iNK|Q4xakB(0cEpn)9b$$M$IaKJ`&t@36I{ zdHrIsUG{}V+2SWpBr_A%B|2)gG8?snx0{qUx!@#gt9ABMoVPoIrGe@qK?R=W~iX7Hy#d+Ox5 z-o~1##n+duPntjd`?`NWgiWO)rYl@|!0Da5JwE<7+n2kyTH2)^zJI9iqT?@7v}nnp z#`{a7?rVLYck}E7MuwbR-L%ZFbtRsM_C;MSUn#@`w=a&cF)Z+kyMM;?-6}D4>y_VDF^J4pp0a() zi{EY6rz^Bf5V_=FC3EA?M?{lhCywx|($PG-a`ElW*;kw(~bo17G7HbIY z>zCN3@xR}9q5TyvQ@36fe+k7FDfxGw?=m<0na$s}@hE@UiqK-|-9J)m+Z3fE8D`?uUn@6&wAeD6!QHR>^;S#P zx`SrY6boB6ZG3)yHTwsp@5iT}diJR3Q9bXQZ~1Ku3=Q8?UOwo1J!!sI>i@9Gp07oh zxRjO7wo$A2b%0U%7XPgx+jtd^&M)8Qm>XBLY;N8j{9&QBxEcS8E649tdA#_^?=)fh zDeKy-6KCoe9rOO0-`6=|E$=p8cTIwXNq>movpW$FUEne3Q%6tUK2`tutdpQ`!X_t^#jBFz41e(@#x@1i z1{{sttsK1B{&K#(W0ceNf7@SIERwEe%?TFg{&)L1>!MW|_Ypmj>eCMA7yVzijFVwU zKHvOcz74x`-8@l@w$3cS^yKCz1 zi{&LAFI%(S{`cfJOEwj+dH!Fv^iBVQXFLoHLCf2ptk|*ge5iU}SN(_kuhi0~yFH(N z`i%F(>i8+j##*qWXacUFD~4T;bb^dbIUNz_8b@6w#w)G%2u&- zmlR&uo^ko$6jy<1YiCbA@|4RZ=T=DE<+8cH5ez+Iez#ilxmo9Rr7NA9CUJ;~@SEs+Wy5gY5>CO6DT$lbI3>GdO?z7;D|^46Z6aP}zc1KxLWW`FNUfA5ig z)wtS6LVT&2K-#{=`BM}a8iYQviZC#!iiE_lIT}pW>WZG^Xmo>zsX;+fR8Vot$~^}X z!sZ-P@N5#Q{WDc$(?i=N!$Vrpj=vV-jLd=l+|DS$tzJ{@>J5r+dG|l9J*;*!X!)eL4-BU^mBj_|zFXPqdNSN)>hilB zvn!{3-LGJ7dNU)QkJT%T*{bl{|J{%F9Gfujm|IbE@zW(=_w5#uj8_p7JubWJQ2yf^ zAs6qrZP|M|;ba=Ox5*_JGwH~@DTbl*CeB))dNujQ3;Q$+akV8=y}vJ4V2fm0m=VIm znt7O~cDdiG@84s7D=<7rzt^>6`MsOI?drCxcCF?4WoLSBm&*)cX~RRc3t~?*mYGdn z_V4$iZQZLxPTHHTT^VJ*dD-5xv%i_;n-$&5?R&H?*v$9Ut}nT<`XUdOuX}Hic{;ms zk^8Gn;tUNh4sShCIIr>AGUhqC?qBBCsjXac@A5LcIZ>~^dk0xM{M(qxmbKSy{`v?f zt@lrAgiYT!rh8?6*Xpw0`?{!3cY4f;xeFfMUAdOLc9SM$uHJXeizWE% zRkyQ;uAiC0nx#8ia{9CVUDaQIxITI!_}iM-%0_oq@Vr1h!@9(uZ*v3Z{(kpXLZv=Q^=ymRS7v+5CYmAKJk|H@j%cTtsPD4hZ>0a_kxp%O4!Tfb`mrYAR!zvw z#1$ua9hPyuYv+IW;QfPl?|05HFRP1|owGebZ|cGJagu6TH2>q=%P#+JO=dZnvey~LWo zAX=)>?)UkB@gFpN4J1VEg;bhTv?j7JI8I`5?bJB5Aba}@gXE3HU*%VQ*V|GB_nZU0FRbK%rV{E(3$Y)-ShSJ&Enr zpO>(B^`Q$dgqPfWen9&79i8P1*0J?|KHtvfcKdlwn#^6{oYRW?<7AY6&Y1LcQFUSW zle`P>?_BMwU$OiD7OQ{DXQ{I=w5)o%WUlu0@OajR!X+P*j_#jg8z$4cO6ttY+jd1# z>+j7ok=y#%ih+UW@ADS{vnCp!b^d0@!oaXH@dO`F&#Gg0(l1`MGs$gSb$Z(F*)P7E zu9cf4F>T_F6}L|I%}fi`7L+>Yth~;{$D=tdge#1#_P*3ZeVcR5yz1R;zVn|f^kdpE zYwQ2YnP=}_6%YP-Xo|1mx;k$+-Wj*=XO}#f#9pbi;MBdhvn3uSS})mJ`eDV_lSii* zqy~4~ZkQ^}e)iqvGMD>D`?)gT$*cI>G+BA~gX!WuZMRJMrMA93*?P3t>K02xFae+;p``5JD>tlYd&iX!o{j@Io(2GnfX8fvL@_zS>@b+q} z+Ps#&?wQBFR<{SUFeqr8>Gl_9=sx;r+VoBah6>e~MV-?cg*Z0dldCw!o^ZoY;?J93 zE!Q{xJw9s!!vWt~(Vr8vg$f_{?SHmg;^r>1^cep=GyMaf?qu(uZc%a}j7=eAc3a-3 zQk%-6I~Sew1lZ!v@tNzL^E8|HU|~^e@0vV* zX|2cbVe{swbNBZ@x^eWrb!^1$XO5nq+MZ6Fwt2mZoKHu5LV3d1KJglcgY7b(cmDp@ zx69)8pBw8wTZ%ADt*=|yy>b82jr*5AowHZdi6Jg(QP_)}wfyVZ(*Er-*z>ff+mroU z$)5e69Mt3)8m9jWc)Hwp_hWh8oZ2MOSpB8`VQXxXjNgY{diQv9i157v#tNhU52@d@ zCf{^Ry5`AmscS9iU3ckp^{$%8ipwj*<7M`hZ#cX5g0K1MA2(+%vzL!4u327wGwtTi z@C97*M?@oTONGT>T5v6ELin?TuURdppL_nJWb2wY&Q&eDKiNL>-@H}!`|X>rUr%HI zn}2+(ZMiW2{X0oT8Fe|!0?L{g7;2-#k)1;kdWkgr!$Ol<1KmTo--SS0u_k@?NT4N(2b&Pv^ zN$$4iN3Lu>%5*kO`L4&^cYS$T@s;ada3{@Ti``>!P;9?Z(}bGdkHs=kA`A_aX6E0X zc8cM`n%Vrx&)#m=T^y$-uFr4b$H1_?;kubS#{r|Sg@%Dl2@+N>r|vl`%phQ8`%mDv zjQb2GFWuiI+rrf&mTYZa=qVkqtjeTwTY5^2wm^d-!|65a*LRCKHhopFKbCVdZj;@S zyDanfzuoG|bf@ae<_eZYOgG)%dAy&hy|?#`%+hlUIX=I?D^R(<;EF2ehS&e>7k}Pf zboI=x?U@JJ1fF?spRdfay35NYU_#KUTRyRG)*jp@eaEWw=hNglPV)_f%W6^|8|hw& zDN_9LA?5Cwz2ZTxUM?3`*PK67^u4{LdHS6-dw--#Uef)rU?$hWYuA?4J=xWNmLJbw>=*tg__WchJ*o^2`}3y%>dZeUw=M0;hE@L~_e2Le*)CjUpISS= z*VJ8k+wU6Oq@b?gt6NhP1?|Qw&j9V5P&0~C@ zf7uko#;~AENIpfl zFnPo3eb-Xdx zJJt8{_S=aai)OFXO}&jXB(0n z9$RymksEV}<7TMe&~- zrqsGDk6l~sdG6NF<@=(3hppc=vX+OJ zdZfSb+8%FQ-Zrn<(B9HJ$#BZqd5-ru_DY7 zYiq8_Z82Dy*?-FZe|K`QDiedl*4Ovu?!SI*e`oQ}WAhHHE&F)pW%b5ybBr&SKM~sB z{fjMX7MpJbgBRbW{tY?lS9VQLS#S2=dIS5jbF&j>A5xE$`qsF38h`M%IlB|C+(@05 zc65r@XUA-@(u&`=`%cZToAu3iHQ$d_e)s$&!{<*cc^C0nR%M#!`~!sy3|H?9EX!P& z+aAYvT6}Byg*@wfpa1qqGW%}5!c#hXCBt17Mvk}Z?8`ej*52#6ka7QX;@d^vzTJ|& zzCKpzqX+{-N7uXKpZ3-n9y|Z+;&jKX@{S#w*X{N?ck<+6=j%U?=x$!WXQ_m$5Yx#Y zPd=A`S1I1ibG~ho$l$#H@+x1M&;6Cg;Y&U;a@@<|efPcU-doYWt#>}YQEp!n@$^wf zN6~rR4^c%$6~`02Pu_QwH(k8zyLP!sY4yxkcB}j)g?{bP%G1(VczO%-#LdwwHS6c? zzfyPe>xT8oUc0Alxxe~<#%&>+&8}&Ct8ZLSj!!(bY`&Z58SDSul5#h)g6qn^osqqF zdi%F!`%Mp;EBe^Vnyf2$xpLvOt$XVJe41n*KBs%uqz|RXTKCOb>3*yCed3!7k1q2c zFX7VrRXL9byufB^bQg`0E zS>|>&t~XCCYOcJMyuI|I;#pVE*}KnOv#&_nz&UyT9;=E;uReVi{u=j=n>(`hJ#+KQ ztgF>Ce(k*9FCJ+jY5sA>zVfW73lqwSXVwo&`Ozu29r zLF50KFBcEFaH6Z^m)9%*+(M9n$hjcYn>YT_5L~ ziJq*nHrw(je!gK%aLrr@>_Jto(Ie9 z!ehk+_xIMP{W-DpqH~{x?EInwC4ZN?_Gvxk59{N<`%=_4_SbpOo6|G9mkNO+}CHJpGDd*vmQ`5ZfR|(wbb`zeS$h`lnf{MVbb+&Bv zuN^ynF4|cu!S%y8Y#*9o6$o*q-q|`P7-4`m?L2Gu$h-+2Semruo;l z9h%GczOmkZYHxa(aS8)Nbac08@$3{!!-}AjH4D^>*ZkR&S@T8t;g77)`LmU_TEE$| zbKUMXjsMSf$xSvdxf}7iSIyP(V`-#nL%-)&=AHVJh5ja4F*O)GUl-CWe@Qi7is1ma zw^X0}3Oz@UjrtRAt5^Iee^L_rU*aRnzKL4=s?NWAJnAk@ywMpQWN+Xh%6(4_pvzI}U_f4IB;a#H{E30?;Z=G!K8-z|<` zdBWjs+vk%p&Cah%Zd9koeqY7BZb5{fOswm_IYCdS@}yj~Z-CE37|Bn#9_ZRKFU2T+ z?yO&XGHWL7?p7>~DldE55_|SVMEl80YlYsHmHK^c-nHK+DR=_sPvNDlr{#HnUHec} z-;!1H?vCBEw+_-1Q<&xlsBP*0tfW_=ZTkDbjOB*Oc`Y|h(pP?2k@Y7c;TO-Wmin5|;`MGc2Un-8y*~Z~8Mbd8T?G0HAKo|1LR<>pmGw)K9CfBi7A`&eST?$E@LnyO2Oc6ER4h|c{#TA^(BRs*Q<{`TX*(VO=hTV5VQR@ z?vS_KPrkAK@K*b<)T{hw;A3IceEToy)t>s*#LPGD^;e4Z-*!-|WMP}p^bC2&Meumb@nxKqH ztgb)#4_EPR+${OfxZvrHYl=y+7jkr@**mhnYwoP&Imu$T$TNH81v^>ca^tJn{Q4=~ z3=NaxugP2a(tL=_-opdKcS9R5oZ`&GvZmeBg#l+BYN_hJpyQgbDKT~GD zG22O5H$DDl*217)HLdSg$=aH?MQwcYJ$m~7fYnBC7sZ^2p1u3avt8cjRR8~R5>GZ` zWLRakKQ`vpN~OpTkLHB!X0v3J$!@$(F_o(Cy3EVcd7&k%0@Sa4f;``25U7w$d(vS%AJ-?3l4*RBKyPd@ur z*<^NaiSqjwVQL>VK^@4Vx|;cKSw$`%x?f$co|<|o_xX__^4PCiMrVYZ z-dlJ1m13vy5wmGldk>lA1#NoV@%c^Cyp@;tOY`g~*XN6yIEh^$>2-f}+A3$2FgLby zn$NZs+}gPC{;|c>xzNtxm_(6-fevG?cz46LyM&M`_0|5;qOw@ zveMgU8dZhG(-{tZIbq)v{pD_X%7(o~el2%)Sl?n>n=QY_AU;uHeooecluZeFekXMo zozC+1ZDLS=&%nKM^4cKj=hL*M{`0@{e)_GDOI7HH$IJ_M2{(D)6~;b_zA!7PH`*gl z$MC`F=P@dBpWfE_zF~81GP!xep+z9;f>e5JQ0u~%kJ1lw`g%OSskzH;ahmbwa+AVB z9$o9|zfXQ|5BhyGTB~FC;@k^T9s-=&`+U`fPINPd2%K=gT_Zb*^=VGb_K%CtvkCtY zaC))Wdzhzm#H>gwo46;cB}Dy`0OI8RJkvg zDc)9zSJt`M=_|NpGw`Z(cwLxUh3Z2`M-cS1F7s}66cz*8F#OAfKRS}k7KF<4h ze{mAmk)$+xy>DS&2VL!Vzcf5LzkJVpKQ*48tCxS}vcD5=oj7Byuer8({r7+MZ!50_ z{0ll%@i6}d`>D6tdsyxid3m`iQ5Y6x4A;~A~SAZkEp$Q$L`+i&|0TO zf5YTwy;`7p#_o5vM@HC*sj~an-uHiznYP!gYSY)>C*&4)o6nmYaQ(CYqmSE6GmGaZ zub8iSU&7%-(cu}KYf_(UKlR*|9sxZ1G^&rdyl zKAp9<(9`u`-FBWF8P+*}K4>n^O3L5rvA`ne&OuJunA?g0|{cEP2V_%kebJkp~$$o1B zmBc6sY~`VzempI*Y&K4)vMX}l(UsD&5<(x zm9#I@NKyYX;OTgt%a&LYf*APCO|3!I`LQupX&BSYy z;~swsmwWl*PQs-5`~4T~dGb8<+2gaTrcDgUzqv5;+*^~Yo}q@Duf12cuD&bSzt`5( zqyK-+{E$y?XZ{P2&DY*;zOC}a{@vnP8&^DX-~ToGbNqp4|9Ri)&MNqJbVp~|pCfZG z-dfxz(LL||r29t3#s6DOH~lYt`Aj&g=YMr(RcFE6%XP=(U3Ajnn$q zEPjM&tqq^@U1#T-r!2)Mx9jB|Fd}86(tP=nh1Y7H9X6^wn*Pf>PuTcLgzugW8pZ!v zW|^dYIhqjL6u=vFy5{@OefwS=I9c=i`WKD=iyFhzOn$1VFA#Cz>b5_6A$Mn5>j4>m z(|W~8^NYNX-4o+-Q2*YS^GP@4=Z98T08aHX-p^b1m!_y9AzD9}=~`=xyd+28BtH?ff&hrfY_; z*>I(mrDWqVvjb-D?_BqrnlMq1@0VDv)r?IXhc=aNp0p#T(Q>zI`@3ge3<=LJ_Zhyv zxLIuLGvnv!7oUipPO+#C<6o(ldFDm&pb;qKW^MGLR z>0^HvmKChutm!;s&(jAkqWd@Bjr+bT*`#pB>|jTy?H4t_opZVMdy&Ydr^|fb+FrGI zzFN6;u1w5*TdQcMs z9DZZdo|=SN(;ThlMiicT@4obF*maSwTyIoMbJv6(y*5YA(c$Q+@HdAQBy-pp9VYa2 ztyb1l+;5cWs38!fP`fwfsDf&^gW39s37>o%+lp&1&A6z3z&MEGVzRmUHjyW``b#Xf zsxe&tD{<9yRzR2x3of4b;-ic zMj;NPe7TCCxSJu<4}J@ucCPxB(ZaoIf!?P-eQL~%o+i2Z&y4t15f;AFePLD`rt5i2 zhRkU`mg#ynqSkyezr#nPJh?dO&yLIeHXbwG@m|mMn0Tkl(Zcq1A8uRR+_tjxyVc&T zr1iV+n52DaeehGL<;emqzsKP%zskN{QRKKFeaXM}{?|Vt-Q`bZt;5wBoW;)G3%z(` z$?D!&t*d8ha(7HS+v6P^fApzM-ND&5k61Y!3N2%{7cn*jeHNQL+mOK{xcccKkv@hi zS$2B`r`^9-_VRu9Q75s9|EFCxj1fWYpQq!_$1jmfJ$dX**YQ86*sgXRy&bmr6PH^wJe$wp)-`%r-YZDN)Owx?dt80z3<+>ygcLL^v3y*6lJl&AnwD=u+{p-M*Ic*cJX%||tn~GKJ55IEb!QVLP)%w-@!&@$dyI1cI z|0BbWd4|uz{=Q3VdwoLmomS+5S70$PfH!T=F!yXf%;VR-&U4XTZAqsW-iJXOIF5w4 zyi|KS&RlKb>Z(q4~dPz#&Z@>LttUm_N-+0XJ*V)q2DK8dP z-P|O(=YCZZhiL(5aovQRDSEzX>vK}_pj~Vw>8skZ`P~9R9QMcYEdb^WD{-3vv02ZD~kSo zyjXbF@9g{CpJuy$@9Yx(-g5lug{!KM{0+ZYuf1h*!s(@UKi@)qZqQa1A$JYw>VJEx z81#$kV>Dww$c4_^@_qZcb$exPm~Qdd|M;@8q$Yd2&zh zz%|Q)7uTKyExZxT{peHi`g602eyH}RO)xpD^kwdW-=MX&Cfinav(~@<%rx=%>$!@8 zzfSAV{}@)cb5;C{I}y+8efWBihFBjhc|ZB?+}Yov@{5l!|Ng(d{P{z}yT6%_+o!7; zM^2oep{TN=<_w<8@gU=-QHc5TcSc-m%duG<(B*@*SFT8u5Wk$ zSZOv%Als}n$GG^Nyod5+!I%0kYd+T5{+ng|{P$m;dFuJkd!DPDd-uiZ{d)J@d%JFZ zzc6Lm1>d;f#w)&_1o^m_83V*lP56_1fbakvQm-N(lkaK-OSZr2xhMMzV zt9_=kmAq+rRhxJ^VjrwMnLEf{c?UGg}UacW^AKf|X>#*ga%Rs1Nr%&l+s!Q{u&`VVnePx;QO z%8B0fbdsyfc^{umQ%-*Wvak9=&7n{Bf7Ty}x!@zWY|WFB)$`^~OIsoEAYIJ+(7U7R zMxSI({Vw~hSZSpomk^`R$RH>fed+vO=`G(b90{=6P&(gpHCyYB?vA_7-|zI)KI5Bf zvLW_(Alv5fjQOs`x1U#6-M5|5^!r)$kNCR{O!v}0th~Sb+#S2KyMCCxyZG?Z6TiFK zQ$ByGU9%{Ap7Y$==$`1>=NE1AzWKB7i8!<0@<6=X<+pn8TlpjRWVn?2Z-2CN%BOFC z7RSCiX0~!#kk0C}c6YvX>27d#$=JB2tv$%k?beZ#(%1fc-msb7(XhHWa&ow`*434- z-o0^T5a|yVPr3K(b+Oylv%i(T7cww3XuS|(U|7Jli-mzn!vB4J$A!z^xI_)S40?PX+CCja8i%NYVTdF}E3 zwdGrWr1|O{VbSH6X2r#1KU94BYSGSJ5^c8eH*YpCm{GY)N^7dIbu|}*>gprAk6c}H z^-H<-x~p}6OqKWEP-5p-Z+0}6SR(QN8Y9C$qniD6_3)ectccY~&pZErzusSDzl!~5 z*xE<0-e@k^@D%Pr5(j z(#oAP_uTQltz2zYEx_O~u~43!jxja>i3G*Uo#M7%AKdzBJ!#Fkd4~L*UsLr9QaU=k>Nq&rxT@}re;|Ilkd&{ zn)}awtM>jI<=;AW<$H1hR~Mh%kSVQq`^)U-`=x(WMR=^QI{5e3Ig80frRR?u`^}&C z+wu3a{NB4W=M@&jeLq$!b@g4`_J6lG_oclkU!U!5YrFaR>C#o@{JfQ)=aydAN$Tyb z`g^iZ_*a?q)vcBP-wF4r+)}y!%e*8z=gMo|UA~exl3kV`tKC&optJPBcMF*x*RGlO z>%YCf#{chud9ijH1>zf3uk0@`EamstGNH{`Bw_gOqejC ze$V#0@Fz>A&0Dv1*V*5h5BCLom!IeQQFmrr%kFiHQs)18vY54h@6OL}F8%eEdMo+s z=QWpDmFK6PW+neC|J1ei{q{RXe>W>I|36v$sh;Ms?XI@v z_d+oS2Gz4iZ!%jn?u=R}ib$wtQ^=G;b=2 zy7)B4-nyp0SW;z&yZd8~-?4h}_8X#a`S5-<%ebWQ=%>{2Bhym8dwtSxoyW@H&{-|A z+oflno1mbfM6X-8xZp(-ao_DP&6@p>oH?IvR=)eQTlAlmcP3w|laVc5^LUHy-@m@$ zX62R7X6S0CRXv}$`Fzx!c`x>V`hD!@whJbL7j-SeVqILer$v`;jK42c?b5R>`fvuD z@Aj8`_Z}xC?Dk*Q`B(4S>G({x&D~|$!kfF*7J2>)fA?I6fx+w6;tKiWjB7&{bM)uV z&--f|?6Su5;>C^TrJJXFhb1iwb@?(!TCfWQ=D*ryzi-V42b9YC z=@t)!Y;q3mRnUu8V)A`8Tb8T4|82CljO=naeV(=llNiW86}xt!mAk>9tgx1 z$$$B>L;haKaMIrlKYX8d%oqxwUSa2 z->MgpM%4@q3*^>K7dbR-L(Q=z@j6POZF$k#-Y?fLbE*Fy`u&oU=jrzPVvWD&)=s`~ zQhwjBs14ye=EuLUGhP&&tE99jeO|QL>h!&SPi+tX-Lrdpee%_h(z~AA%jKN=>Ei-( zC$HAuKll77y0Wvx_WiQ0_BSlbkKe1b{&w#6mKD*wo0qJUeDz%N-S_R16P?+ve&PAf zFK1d?e&-wK;rSZE@19?OzIA=l`(2SqJ9pK+nQ-A!Wm};^XT;?CSr(h-mG6kZDPHAk zH7Vol=8nbAebaV*&thP>Bfe{ifaLN2#YXNfQu{u5%~-Ccq_;1(ecNgkrSNb0r~b;h zpV@Wv`l~Osdkb4U*@`?JcC--tBudjRF(NXQXKd8KJeaxxQFM@)e`=`__ zH#)U#_TGXMJ666w|1LI4CG+YXWAogTx9x8i#i~45yD|9qUJJXd0O7?;*2Zp8`*%(= zZtb&mQubd@C)(D!s^sPSgw2cns-2#^$p5&@{C|Hx%-mwX&U%OW%+JYJKIQ*^r?2$r zZvNBh+1K~~oin}T>7Rc$-q@eh6Wy0^dWt^VBt0RBE z|FyLZ|4nfGr`VonNKb$?~1N3(!am+NRXw) ziD2Q?(UJZWv#0rZ-;=g1{U`go@_JGIp9KHCwO$zonP*=-eXOb!w6b!;ZVB5{l^sj& z*6yl5>)`Ke(!b!>zD-KDZx1cKFU&nlMN#$lEMFHb^DpJ%hQC;@YU=;i@9yX@{p-}& zzQ$apZiN>g*yS%KIqkUqHtcrlCAP(oFdCqR01>SYsu=Dj|uH(D=vnOxOcaQ0tUH_Y3-8bju z%FeKLe@~cxuC|NS&HTHjHF){jdj+Rd*Mx6gweI`o)OX*#ll

&kwrt|Hh|^?}q;A z|2Em0{r+YUw~y6-(bV@=zg`FW|B`+b=J)?$M#AroO*_3UtV;U%OZ%@fFzoQ3weEH6 zes9T%tNY`9&b|>4eD%ihoky(wqO|YK*Csgr{`Q5-$g*0hqa$LIj<9dgtU8Wbi26jI_+uG@onBaV7QS zHmhnDh6D4zG?aR}>^-%3-yO^6cS6(onU-$l(^K^;Io fk~)B0|C#J21=sCy5{Y17U|{fc^>bP0l+XkKwQa?z diff --git a/documentation/overview-manual/yp-intro.rst b/documentation/overview-manual/yp-intro.rst index fe80e18796..85e78dc574 100644 --- a/documentation/overview-manual/yp-intro.rst +++ b/documentation/overview-manual/yp-intro.rst @@ -264,10 +264,9 @@ with the string ``meta-``. ``meta-``, but it is a commonly accepted standard in the Yocto Project community. -For example, if you were to examine the :yocto_git:`tree view ` -of the ``poky`` repository, you will see several layers: ``meta``, -``meta-skeleton``, ``meta-selftest``, ``meta-poky``, and -``meta-yocto-bsp``. Each of these repositories represents a distinct +For example, if you were to examine the :oe_git:`tree view ` +of the ``openembedded-core`` repository, you will see several layers: ``meta``, +``meta-skeleton``, and ``meta-selftest``. Each of these repositories represents a distinct layer. For procedures on how to create layers, see the @@ -385,7 +384,8 @@ Yocto Project: - *AutoBuilder:* AutoBuilder is a project that automates build tests and quality assurance (QA). By using the public AutoBuilder, anyone - can determine the status of the current development branch of Poky. + can determine the status of the current development branch of the core + repositories (:term:`OpenEmbedded-Core (OE-Core)` and :term:`BitBake`). .. note:: @@ -437,12 +437,12 @@ Here are components associated with the :term:`OpenEmbedded Build System`: You can learn more about BitBake in the :doc:`BitBake User Manual `. -- *OpenEmbedded-Core:* OpenEmbedded-Core (OE-Core) is a common layer of +- *OpenEmbedded-Core:* :term:`OpenEmbedded-Core (OE-Core)` is a common layer of metadata (i.e. recipes, classes, and associated files) used by OpenEmbedded-derived systems, which includes the Yocto Project. The Yocto Project and the OpenEmbedded Project both maintain the - OpenEmbedded-Core. You can find the OE-Core metadata in the Yocto - Project :yocto_git:`Source Repositories `. + OpenEmbedded-Core. You can find the OE-Core metadata in the OpenEmbedded + :oe_git:`Source Repositories `. Historically, the Yocto Project integrated the OE-Core metadata throughout the Yocto Project source repository reference system @@ -455,34 +455,10 @@ Here are components associated with the :term:`OpenEmbedded Build System`: Project objective of achieving a smaller number of fully featured tools as compared to many different ones. - Sharing a core set of metadata results in Poky as an integration - layer on top of OE-Core. You can see that in this - :ref:`figure `. - The Yocto Project combines various components such as BitBake, OE-Core, - script "glue", and documentation for its build system. - -Reference Distribution (Poky) ------------------------------ - -Poky is the Yocto Project reference distribution. It contains the -:term:`OpenEmbedded Build System` -(BitBake and OE-Core) as well as a set of metadata to get you started -building your own distribution. See the figure in -":ref:`overview-manual/yp-intro:what is the yocto project?`" -section for an illustration that shows Poky and its relationship with -other parts of the Yocto Project. - -To use the Yocto Project tools and components, you can download -(``clone``) Poky and use it to bootstrap your own distribution. - -.. note:: - - Poky does not contain binary files. It is a working example of how to - build your own custom Linux distribution from source. - -You can read more about Poky in the -":ref:`overview-manual/yp-intro:reference embedded distribution (poky)`" -section. + Nowadays, the :term:`Poky` **repository** is no longer updated as + :doc:`bitbake-setup ` + became the preferred way of setting up the repositories in order to build the + :term:`Poky` distro. Packages for Finished Targets ----------------------------- @@ -631,103 +607,18 @@ Reference Embedded Distribution (Poky) ====================================== "Poky", which is pronounced *Pock*-ee, is the name of the Yocto -Project's reference distribution or Reference OS Kit. Poky contains the -:term:`OpenEmbedded Build System` (:term:`BitBake` and -:term:`OpenEmbedded-Core (OE-Core)`) as well as a set of -:term:`Metadata` to get you started building your own distro. In other -words, Poky is a base specification of the functionality needed for a -typical embedded system as well as the components from the Yocto Project -that allow you to build a distribution into a usable binary image. - -Poky is a combined repository of BitBake, OpenEmbedded-Core (which is -found in ``meta``), ``meta-poky``, ``meta-yocto-bsp``, and documentation -provided all together and known to work well together. You can view -these items that make up the Poky repository in the -:yocto_git:`Source Repositories `. - -.. note:: - - If you are interested in all the contents of the - poky - Git repository, see the ":ref:`ref-manual/structure:top-level core components`" - section in the Yocto Project Reference Manual. - -The following figure illustrates what generally comprises Poky: - -.. image:: figures/poky-reference-distribution.png - :width: 100% +Project's reference distribution or Reference OS Kit. This reference +distribution is represented by a :term:`DISTRO` configuration file found in +:yocto_git:`meta-poky `. -- BitBake is a task executor and scheduler that is the heart of the - OpenEmbedded build system. - -- ``meta-poky``, which is Poky-specific metadata. - -- ``meta-yocto-bsp``, which are Yocto Project-specific Board Support - Packages (BSPs). - -- OpenEmbedded-Core (OE-Core) metadata, which includes shared - configurations, global variable definitions, shared classes, - packaging, and recipes. Classes define the encapsulation and - inheritance of build logic. Recipes are the logical units of software - and images to be built. - -- Documentation, which contains the Yocto Project source files used to - make the set of user manuals. - -.. note:: +.. warning:: While Poky is a "complete" distribution specification and is tested and put through QA, you cannot use it as a product "out of the box" in its current form. -To use the Yocto Project tools, you can use Git to clone (download) the -Poky repository then use your local copy of the reference distribution -to bootstrap your own distribution. - -.. note:: - - Poky does not contain binary files. It is a working example of how to - build your own custom Linux distribution from source. - -Poky has a regular, well established, six-month release cycle under its -own version. Major releases occur at the same time major releases (point -releases) occur for the Yocto Project, which are typically in the Spring -and Fall. For more information on the Yocto Project release schedule and -cadence, see the ":doc:`/ref-manual/release-process`" chapter in the -Yocto Project Reference Manual. - -Much has been said about Poky being a "default configuration". A default -configuration provides a starting image footprint. You can use Poky out -of the box to create an image ranging from a shell-accessible minimal -image all the way up to a Linux Standard Base-compliant image that uses -a GNOME Mobile and Embedded (GMAE) based reference user interface called -Sato. - -One of the most powerful properties of Poky is that every aspect of a -build is controlled by the metadata. You can use metadata to augment -these base image types by adding metadata :ref:`layers -` that extend -functionality. -These layers can provide, for example, an additional software stack for -an image type, add a board support package (BSP) for additional -hardware, or even create a new image type. - -Metadata is loosely grouped into configuration files or package recipes. -A recipe is a collection of non-executable metadata used by BitBake to -set variables or define additional build-time tasks. A recipe contains -fields such as the recipe description, the recipe version, the license -of the package and the upstream source repository. A recipe might also -indicate that the build process uses autotools, make, distutils or any -other build process, in which case the basic functionality can be -defined by the classes it inherits from the OE-Core layer's class -definitions in ``./meta/classes``. Within a recipe you can also define -additional tasks as well as task prerequisites. Recipe syntax through -BitBake also supports both ``:prepend`` and ``:append`` operators as a -method of extending task functionality. These operators inject code into -the beginning or end of a task. For information on these BitBake -operators, see the -":ref:`bitbake-user-manual/bitbake-user-manual-metadata:appending and prepending (override style syntax)`" -section in the BitBake User's Manual. +Poky has a regular, well established, six-month release cycle detailed in the +:doc:`/ref-manual/release-process` of the Yocto Project Reference Manual. The OpenEmbedded Build System Workflow ====================================== @@ -869,21 +760,15 @@ helpful for getting started: - *Poky:* Poky is a reference embedded distribution and a reference test configuration. Poky provides the following: - - A base-level functional distro used to illustrate how to customize - a distribution. + - A base-level functional distro (:term:`DISTRO`) used to illustrate how to + customize a distribution. - A means by which to test the Yocto Project components (i.e. Poky is used to validate the Yocto Project). - - A vehicle through which you can download the Yocto Project. - Poky is not a product level distro. Rather, it is a good starting point for customization. - .. note:: - - Poky is an integration layer on top of OE-Core. - - *Recipe:* The most common form of metadata. A recipe contains a list of settings and tasks (i.e. instructions) for building packages that are then used to build the binary image. A recipe describes where you From patchwork Thu Jan 29 15:23:15 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80007 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 48B94D6B067 for ; Thu, 29 Jan 2026 15:24:29 +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.17200.1769700262249523716 for ; Thu, 29 Jan 2026 07:24:22 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=uoYjzpbV; 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 B3A264E42322; Thu, 29 Jan 2026 15:24:20 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 8BC4E606FD; Thu, 29 Jan 2026 15:24:20 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 6C0D9119A886E; Thu, 29 Jan 2026 16:24:19 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700260; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=NJRoEhvXUcXqe4SBxQDow6KNXUmkJjx3x5ek92NyWic=; b=uoYjzpbV/dtPUbKKMF8ehzKPT6lF2+hnVSyRfn8kkAdVmgQ1ePn8XFg0KOgspzPqa1tPD5 SDbyoMjI33ppziVsfHicbwvbLyThHxNYMwTNdE6eqEZ7Ojz7bUKmxHFZeZ0KSixZq6GCKa +F4TkYqghsAntJTMTZ630cOX2zDciYxEtF+h7holVDscHE91j+kgfSBGWllB5eyTCZky6C zmc76oU7MVOCn+zU0Gg5po2NFfbczmjcl77b1SpzVZbwkofI9WEsvMnAK9m4EyhE1d8/O3 mFEySLOzMvQ5KF/DNycqUs/Cs8PU+LP2F9DXA+ab2rI4iX9vzfCd+I+VQUdyDQ== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:15 +0100 Subject: [PATCH v3 24/57] ref-manual/classes.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-24-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=6248; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=nY8TXckqhUv8F6yLaHugu/ItnyI/YLncG19SeUfwYW4=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uM9JBzGuz4gLzE7dphLd4kU+eKSiuPWrkAZ op4vzlqoPuJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jAAKCRDRgEFAKaOo NkcSD/9EZ5HtYWA9fTee8TDB6+7qlv0mrMspVr2AlBx5XRrBl9h5l+hbVQ4339t4jZyOktM5L7e FaqKzGqdZtc+qPNP6Aa8ssMK4itVSIOVWTmGw57gtwNIEOKxpGEYYf8fnowmhuVZwqkaGswmrDW nBOJtsCZSNd6WVrmCifBMOhCAXHCdDazBY5RSDg27vPfmyv0Tw9XN1NDzmFsGK1Sb1Z//TbsGYN jIUCkldVq8PsajntDP1Ueec9Gh/pHXK9Wr0mav8sybOKpsRnOT2lIOuYCtIjXTpDSdlA5G5W1sG nxOeJk3uffw6GH4G9bDfseor1DfdOzjsi/OxsEVvb81I/9tzeZMdUZLrrDO2Q7MH54BLIaT5S/+ sUH/BTBgQfPSauurD7h2XAr31bzz+RoCCduCklsXIyR4ta71lAMjKnRHsNOI72mVj8MS7GzIs+F +pK/f1uf5ZF8jmx+YLUVcmgDKrS01TR3j5/SCDAeX8fToPHWyHEftkymjjnnERDibyVFUYIgkTq EC8Vpg/5np66It6kZb1nYNAKHWDGyiuffiEuvqrD/Cdr9re2jQ5S4OkmyW5dbm/VH/Dr/IP7nMB zIxpF8HNtZomoFWvRzTS9xR4PypSVWQzb5WFDX+8E44AZEOkOlViIzfD5V2ap4o8Xy1QzFWZGFf c3MFxii19Vgrf4w== 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 ; Thu, 29 Jan 2026 15:24:29 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8810 Remove references to the Poky repository, replace by OpenEmbedded-Core. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/ref-manual/classes.rst | 34 ++++++++++++++++++---------------- 1 file changed, 18 insertions(+), 16 deletions(-) diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index 2e219a59c..ef05372f0 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst @@ -9,12 +9,13 @@ amongst multiple recipe (``.bb``) files. To use a class file, you simply make sure the recipe inherits the class. In most cases, when a recipe inherits a class it is enough to enable its features. There are cases, however, where in the recipe you might need to set variables or override -some default behavior. +some default behavior. A class can also be inherited globally (in every recipe) +with the :term:`INHERIT` variable. Any :term:`Metadata` usually found in a recipe can also be placed in a class file. Class files are identified by the extension -``.bbclass`` and are usually placed in one of a set of subdirectories -beneath the ``meta*/`` directory found in the :term:`Source Directory`: +``.bbclass`` and are usually placed in one of the following subdirectories +of a :term:`layer`: - ``classes-recipe/`` - classes intended to be inherited by recipes individually @@ -28,9 +29,9 @@ in :term:`BBPATH` using the same method by which ``.conf`` files are searched. This chapter discusses only the most useful and important classes. Other -classes do exist within the ``meta/classes*`` directories in the Source -Directory. You can reference the ``.bbclass`` files directly for more -information. +classes do exist within the ``meta/classes*`` directories of +:term:`OpenEmbedded-Core (OE-Core)`. You can refer to the ``.bbclass`` files +directly for more information. .. _ref-classes-allarch: @@ -338,8 +339,8 @@ The :ref:`ref-classes-cargo_c` class can be inherited by a recipe to generate a Rust library that can be called by C/C++ code. The recipe which inherits this class has to only replace ``inherit cargo`` by ``inherit cargo_c``. -See the :yocto_git:`rust-c-lib-example_git.bb -` +See the :oe_git:`rust-c-lib-example_git.bb +` example recipe. .. _ref-classes-cargo_common: @@ -602,8 +603,9 @@ inherited globally from a configuration file:: INHERIT += "cve-check" -To filter out obsolete CVE database entries which are known not to impact software from Poky and OE-Core, -add following line to the build configuration file:: +To filter out obsolete CVE database entries which are known not to impact +software from :term:`OpenEmbedded-Core (OE-Core)`, add the following line to the +build configuration file:: include cve-extra-exclusions.inc @@ -827,7 +829,7 @@ See these variables for more information: :term:`PV`, For more information on the :ref:`ref-classes-externalsrc` class, see the comments in -``meta/classes/externalsrc.bbclass`` in the :term:`Source Directory`. +``meta/classes/externalsrc.bbclass`` in :term:`OpenEmbedded-Core (OE-Core)`. For information on how to use the :ref:`ref-classes-externalsrc` class, see the ":ref:`dev-manual/building:building software from an external source`" section in the Yocto Project Development Tasks Manual. @@ -1009,7 +1011,7 @@ this class is controlled by the mandatory :term:`GO_IMPORT` variable, and by the optional :term:`GO_INSTALL` and :term:`GO_INSTALL_FILTEROUT` ones. To build a Go program with the Yocto Project, you can use the -:yocto_git:`go-helloworld_0.1.bb ` +:oe_git:`go-helloworld_0.1.bb ` recipe as an example. .. _ref-classes-go-mod: @@ -3471,10 +3473,10 @@ is one reason we don't use static linking for our :ref:`ref-classes-native` binaries. With this class enabled, a tarball containing a pre-built C library is -downloaded at the start of the build. In the Poky reference distribution this is +downloaded at the start of the build. In :term:`OpenEmbedded-Core (OE-Core)` this is enabled by default through :oe_git:`meta/conf/distro/include/yocto-uninative.inc `. Other distributions that do -not derive from Poky can also "``require conf/distro/include/yocto-uninative.inc``" +not derive from :term:`Poky` can also "``require conf/distro/include/yocto-uninative.inc``" to use this. Alternatively if you prefer, you can build the uninative-tarball recipe yourself, publish the resulting tarball (e.g. via HTTP) and set :term:`UNINATIVE_URL` and :term:`UNINATIVE_CHECKSUM` appropriately. For an @@ -3516,7 +3518,7 @@ To use this class, you need to define a number of variables: These variables list alternative commands needed by a package, provide pathnames for links, default links for targets, and so forth. For details on how to use this class, see the comments in the -:yocto_git:`update-alternatives.bbclass ` +:oe_git:`update-alternatives.bbclass ` file. .. note:: @@ -3549,7 +3551,7 @@ that contain system services that should be run under their own user or group, you can use these classes to enable creation of the user or group. The :oe_git:`meta-skeleton/recipes-skeleton/useradd/useradd-example.bb ` -recipe in the :term:`Source Directory` provides a simple +recipe in :term:`OpenEmbedded-Core (OE-Core)` provides a simple example that shows how to add three users and groups to two packages. The :ref:`useradd_base ` class provides basic functionality for user or From patchwork Thu Jan 29 15:23:16 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80006 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 54032D6B066 for ; Thu, 29 Jan 2026 15:24:29 +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.17201.1769700262812687351 for ; Thu, 29 Jan 2026 07:24:23 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=wzTBGtpH; 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 492DC4E42324; Thu, 29 Jan 2026 15:24:21 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 1A8F4606FD; Thu, 29 Jan 2026 15:24:21 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 6EDD7119A8865; Thu, 29 Jan 2026 16:24:20 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700260; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=nwZAw1fI/cU7zhrCsIvB3YieEQIhPoU9tsyVTd7R/Bs=; b=wzTBGtpHuHEhb1lt9XjAHIsOd56CUXr63Y4d5Lxajuem8gaTMYRu/yGu0PDuAI8PYCsgKo hBHmsaNr7EudK8WTGBOSlQPx3UnE7CP/ptVkJGi7/DWpaqIK7zNMuwC8Nv7S9+mNB3M1f0 Hol4yB20u9a6JyEuPAiZlV6HsUBhaSWf+KsWjvjRsuuMRaJ9aK7KKRisUrJBI0fcodMczA tE0ItRPvq1e/SEySqy30ketpiUfs+awSvLQHZHPVl4MQfk62E8nGZ93Einxnygim+Pp6n/ rs5efV5I2lizMeS8ti7dlrTXHoc8yoU1qfV5j7HreKvkuR3sXlBwvEZUpbdGVQ== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:16 +0100 Subject: [PATCH v3 25/57] ref-manual/images.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-25-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1037; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=yhKBxzRJ4I7sjT2yEEavNGBnCJ11sdwGukEhWYN31Xc=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uNcIzdP250vMF22Df21VHyvIXAgg7etb49H FwRcCPAyVOJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jQAKCRDRgEFAKaOo Nh2HD/9bfUUWTsy8juv3KoG11BrZVqYJ9/3z0AVhqmvjFmFRA6qo0N64QNnP8KKFJoJgKBjQc5P PdX06mUNUFIlcGBWXARlVCGZzMGI14A08DjngFL/AbO2W54PX6Q/e70aGN0T+AqnuJU3jMa0mmN PNA0ZvmzZfwolZ5b7LmKtLuXifFKSDsKypaw8yppqNJQoGmE8SSFYCL+pDlEJkfY+JwU/eKCoIo y1vcKWb99iW5ciG+hwxPVUKPteDcTzV4XscS3FOzezeXyr1KOW7nHtY2O22YKIJWvhSji0ZxLEr W+pdzu7Hvw/8+2HOIW1GzkuGy4JBEutQamBenmquC2NdmhHS9KXNDjXaODk3y+e+e7TKN5GDJJu J92dzsk7xtg/TGgoQjqjdOD5+6OrThIW17rva0nAOz0NP0n7P53jeg2AxYWtgu1HkPUUDphxxTn NON0fScWJDtSHi0ZpVyf+4P0l2QTRa3TmgUo7SLTSyX6tsDiNdC9dJlUWpTuavaPw13lXZBqbtB r+Ad3xYi9n5d+PUYJcOXs3ucjLd5iEI7sIrl0axtwfgUqsXBGksqLlv9bK3Us/wtISEZMJrwLQr CrfWes3miZO/aU15dWF0YMG7XRAWsCd5jDRfxu7oUH9TZVbw6xGo/kAHmHrPnInJRcKcVajODJs +PhTjn+HacQJrKg== 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 ; Thu, 29 Jan 2026 15:24:29 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8811 Remove references to the Poky repository, replace by OpenEmbedded-Core. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/ref-manual/images.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/documentation/ref-manual/images.rst b/documentation/ref-manual/images.rst index c9d898926..94e412de3 100644 --- a/documentation/ref-manual/images.rst +++ b/documentation/ref-manual/images.rst @@ -26,9 +26,8 @@ image you want. INCOMPATIBLE_LICENSE:pn-your-image-name = "GPL-3.0* LGPL-3.0*" -From within the ``poky`` Git repository, you can use the following -command to display the list of directories within the :term:`Source Directory` -that contain image recipe files:: +From within the :term:`OpenEmbedded-Core (OE-Core)` Git repository, you can use the following +command to display the list of directories that contain image recipe files:: $ ls meta*/recipes*/images/*.bb From patchwork Thu Jan 29 15:23:17 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80010 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 62ACAD6B068 for ; Thu, 29 Jan 2026 15:24:29 +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.17202.1769700263441572566 for ; Thu, 29 Jan 2026 07:24:23 -0800 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@bootlin.com header.s=dkim header.b=e4bxEAzD; 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 DDDA04E42325 for ; Thu, 29 Jan 2026 15:24:21 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id B3CE3606FD for ; Thu, 29 Jan 2026 15:24:21 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id E8DF4119A886D; Thu, 29 Jan 2026 16:24:20 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700261; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=TFvQLQs+MC8uMNVx/wBlAujV+BfiJckgBuxWIBoWOus=; b=e4bxEAzDnWYMaRewX3LEI/iL4V1xTaCeHOvCBGXjUPjx0+wjH5q4Z71JZxIoDwaqseXC6p MovTGf4/dm01oZbDANpW+1zSaSLS/SIETrMi0Zd2R3+6Aq+l2OR4nlmSTh3MPws3XPa+LM AEuN5Tbum06CNvps76bEA3Sjx7h6gafrzcgo8XI/hukf9TSqwQnK/ohIE8+1S9LQnSPMW7 IQt+66OzyiB2wbWujdhyfaiuHlFKMW7uJsJHrXdLEur87g7A33koeBiL2Ae1bbsIjNIb0f IA7b9zPt+7TTiEHORAa7EddqzdwmVZAwxK+KkPfuzSC8HUGEiq8i1Oxl43rPJQ== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:17 +0100 Subject: [PATCH v3 26/57] ref-manual/structure.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-26-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=16077; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=CRBdkl2WAy920g5OtRoJP9/E9+MeRbI8Dj9NcW/ZpVE=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uN1NwiDgSiQL7Di2e7fHtQDks5Cis1huZJx sUVRFLuofCJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jQAKCRDRgEFAKaOo NqmHD/0Rc3pabcwxd5xF1r4ESxA6oXc9o2nfgr2cG7Vp4r2oosVkymW3et9MqHLP4WTxm5MS08/ JqCBBfdHEyFP1aALqhFL0JngUl+R5Jckb9pPePXNB7RtzFcJze7oatiwaac1lauO+5rsZnsSuNc ykyGhH/ggmtzo4QVV1jtyRon8iYrUgXvMXXEzj/kXVkZTBc39TGaPLrkGzAhcHclOayWvOaaUy5 N4zZVbeCTT5uF62stgOCpjfZtxDGsu61Lb7zDTRuQv/I/Dc+MxkeTDnhlmswuDpQi+n3ItdXz+T NBAByS1GADspRLdvAt4zTg4TZ5j8UfKIjKzlHPwh99UImY/1Hs2GtyhrEmN6wnavzIHThtL0wU0 140Fl5C1DS1nBGLw2NSGSnxkXTGp2Pwi3Iuf76L/GThT7/BowADEkqPRlKLxkuha0ABSg0mPm3l 13jFN/gyYRb54BYq+jYAfaTIj25Xu2xDEVPTWUtu0nM1xNT8JaL9iHZia6u/nQ2RS72KKWg+k1J NfosxnImwziq1b0hxxnM6UxhhyhehqKJ/DEZoB6iFf61EiJIKhbV6tjUvfbrDpb7HrcX/yzvJSk U8vUKcE+GLKjL2J7M5NTU5cFwkyvLeY9Ms1hDwNVtSKIYJ0DQZxce/TkZZLA2KSDzwFU+LGQa2L +0APy5U2UKKZXLA== 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 ; Thu, 29 Jan 2026 15:24:29 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8812 Remove references to the Poky repository, replace by OpenEmbedded-Core in most cases. Add a introductory directory layout at the top that is reflected in the following section. This document no longer uses Poky as its source directory, so all paths are explicitly mentioned, to highlight the separation between core components. This lead to some re-organization of some sections. Signed-off-by: Antonin Godard --- documentation/bsp-guide/bsp.rst | 4 +- documentation/ref-manual/structure.rst | 165 ++++++++++++++++++++------------- documentation/ref-manual/terms.rst | 2 +- 3 files changed, 104 insertions(+), 67 deletions(-) diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst index 4a89d691a..a3b57d29f 100644 --- a/documentation/bsp-guide/bsp.rst +++ b/documentation/bsp-guide/bsp.rst @@ -81,7 +81,7 @@ directory of that Layer. This directory is what you add to the ``conf/bblayers.conf`` file found in your :term:`Build Directory`, which is established after you run the OpenEmbedded build environment setup -script (i.e. :ref:`ref-manual/structure:``oe-init-build-env```). +script (i.e. :ref:`structure-core-script`). Adding the root directory allows the :term:`OpenEmbedded Build System` to recognize the BSP layer and from it build an image. Here is an example:: @@ -221,7 +221,7 @@ section. Checking connectivity... done. #. *Initialize the Build Environment:* While in the :term:`Source Directory`, - run the :ref:`ref-manual/structure:``oe-init-build-env``` environment setup + run the :ref:`structure-core-script` environment setup script located in :term:`OpenEmbedded-Core (OE-Core)` to define the OpenEmbedded build environment on your build host. :: diff --git a/documentation/ref-manual/structure.rst b/documentation/ref-manual/structure.rst index d567cade0..06cd2b770 100644 --- a/documentation/ref-manual/structure.rst +++ b/documentation/ref-manual/structure.rst @@ -16,6 +16,19 @@ and directories. names that contain spaces. Be sure that the Source Directory you use does not contain these types of names. +For the following sections, we assume the core components of the :term:`Source +Directory` are organized as follows: + +.. code-block:: text + + ├── build/ + │   └── ... + └── layers/ + ├── bitbake/ + ├── meta-yocto/ + ├── openembedded-core/ + └── yocto-docs/ + .. _structure-core: Top-Level Core Components @@ -67,8 +80,10 @@ about the contents of the :term:`Build Directory`. .. _handbook: -``documentation/`` ------------------- +``layers/yocto-docs/`` +---------------------- + +The Yocto documentation repository is hosted at :yocto_git:`/yocto-docs`. This directory holds the source for the Yocto Project documentation as well as templates and tools that allow you to generate PDF and HTML @@ -76,37 +91,28 @@ versions of the manuals. Each manual is contained in its own sub-folder; for example, the files for this reference manual reside in the ``ref-manual/`` directory. +This directory is not mandatory for building with :term:`BitBake`. + +``layers/openembedded-core/`` +----------------------------- + +The :term:`OpenEmbedded-Core (OE-Core)` repository is hosted at +:oe_git:`/openembedded-core`. + .. _structure-core-meta: ``meta/`` ---------- +~~~~~~~~~ -This directory contains the minimal, underlying OpenEmbedded-Core -metadata. The directory holds recipes, common classes, and machine +This directory contains the minimal, underlying :term:`OpenEmbedded-Core +(OE-Core)` metadata. The directory holds recipes, common classes, and machine configuration for strictly emulated targets (``qemux86``, ``qemuarm``, and so forth.) -.. _structure-core-meta-poky: - -``meta-poky/`` --------------- - -Designed above the ``meta/`` content, this directory adds just enough -metadata to define the Poky reference distribution. - -.. _structure-core-meta-yocto-bsp: - -``meta-yocto-bsp/`` -------------------- - -This directory contains the Yocto Project reference hardware Board -Support Packages (BSPs). For more information on BSPs, see the -:doc:`/bsp-guide/index`. - .. _structure-meta-selftest: ``meta-selftest/`` ------------------- +~~~~~~~~~~~~~~~~~~ This directory adds additional recipes and append files used by the OpenEmbedded selftests to verify the behavior of the build system. You @@ -116,14 +122,14 @@ want to run the selftests. .. _structure-meta-skeleton: ``meta-skeleton/`` ------------------- +~~~~~~~~~~~~~~~~~~ This directory contains template recipes for BSP and kernel development. .. _structure-core-scripts: ``scripts/`` ------------- +~~~~~~~~~~~~ This directory contains various integration scripts that implement extra functionality in the Yocto Project environment (e.g. QEMU scripts). The @@ -137,7 +143,7 @@ back to the Yocto Project, such as ``create-pull-request`` and .. _structure-core-script: ``oe-init-build-env`` ---------------------- +~~~~~~~~~~~~~~~~~~~~~ This script sets up the OpenEmbedded build environment. Running this script with the ``source`` command in a shell makes changes to ``PATH`` @@ -166,16 +172,27 @@ targets to build. Here is an example:: You can also run generated QEMU images with a command like 'runqemu qemux86-64' +.. note:: + + When using :doc:`bitbake-setup `, + this script is indirectly sourced when sourcing the ``init-build-env`` + located in the :term:`bitbake:Setup`'s build directory. However, compared to + ``oe-init-build-env``, the bitbake-setup ``init-build-env`` does not take any + argument, as it is already located in a :term:`Build Directory`. + + See :doc:`bitbake:bitbake-user-manual/bitbake-user-manual-environment-setup` + for more information. + The default output of the ``oe-init-build-env`` script is from the -``conf-summary.txt`` and ``conf-notes.txt`` files, which are found in the ``meta-poky`` directory -within the :term:`Source Directory`. If you design a -custom distribution, you can include your own versions of these -configuration files where you can provide a brief summary and detailed usage -notes, such as a list of the targets defined by your distribution. -See the -":ref:`dev-manual/custom-template-configuration-directory:creating a custom template configuration directory`" -section in the Yocto Project Development Tasks Manual for more -information. +``conf-summary.txt`` and ``conf-notes.txt`` files, which are found in the +``meta/conf/templates/default`` directory of :term:`OpenEmbedded-Core +(OE-Core)`. If you design a custom distribution, you can include your own +versions of these configuration files where you can provide a brief summary and +detailed usage notes, such as a list of the targets defined by your +distribution. See the +":ref:`dev-manual/custom-template-configuration-directory:creating a custom +template configuration directory`" section in the Yocto Project Development +Tasks Manual for more information. By default, running this script without a :term:`Build Directory` argument creates the ``build/`` directory in your current working directory. If @@ -188,8 +205,8 @@ your choice. For example, the following command creates a $ source oe-init-build-env ~/mybuilds The OpenEmbedded build system uses the template configuration files, which -are found by default in the ``meta-poky/conf/templates/default`` directory in the Source -Directory. See the +are found by default in the ``meta/conf/templates/default`` directory in +:term:`OpenEmbedded-Core (OE-Core)`. See the ":ref:`dev-manual/custom-template-configuration-directory:creating a custom template configuration directory`" section in the Yocto Project Development Tasks Manual for more information. @@ -198,17 +215,35 @@ information. The OpenEmbedded build system does not support file or directory names that contain spaces. If you attempt to run the ``oe-init-build-env`` - script from a Source Directory that contains spaces in either the + script from a :term:`Source Directory` that contains spaces in either the filenames or directory names, the script returns an error indicating - no such file or directory. Be sure to use a Source Directory free of + no such file or directory. Be sure to use a :term:`Source Directory` free of names containing spaces. -.. _structure-basic-top-level: +``layers/meta-yocto/`` +---------------------- + +The ``meta-yocto`` repository is hosted at :yocto_git:`/meta-yocto`. -``LICENSE, README, and README.hardware`` ----------------------------------------- +.. _structure-core-meta-poky: + +``meta-poky/`` +~~~~~~~~~~~~~~ + +Dependent on the :term:`OpenEmbedded-Core (OE-Core)` metadata, this directory +adds just enough metadata to define the Poky reference distribution. + +Namely, it contains the distro :term:`configuration file` for Poky: +``conf/distro/poky.conf``. + +.. _structure-core-meta-yocto-bsp: -These files are standard top-level files. +``meta-yocto-bsp/`` +~~~~~~~~~~~~~~~~~~~ + +This directory contains the Yocto Project reference hardware Board +Support Packages (BSPs). For more information on BSPs, see the +:doc:`/bsp-guide/index`. .. _structure-build: @@ -257,7 +292,7 @@ This directory should not be shared between builds. you need to share the :ref:`overview-manual/concepts:Hash Equivalence` database, don't share this file and instead refer to the :doc:`/dev-manual/hashequivserver` document of the Yocto Project Development - Tasks Manual to setup Hash Equivalence server. + Tasks Manual to setup a Hash Equivalence server. .. _structure-build-conf-local.conf: @@ -275,14 +310,14 @@ file, it is recommended to put them into a distro :term:`configuration file`, or to create layer :term:`configuration fragments ` from changes made here. -The :term:`OpenEmbedded Build System` can create it from a ``local.conf.sample`` -file when you ``source`` the top-level build environment setup script -:ref:`structure-core-script`. +The :term:`OpenEmbedded Build System` can create the ``local.conf`` file from a +``local.conf.sample`` file when you ``source`` the top-level build environment +setup script :ref:`structure-core-script`. The source ``local.conf.sample`` file used depends on the -:term:`TEMPLATECONF` script variable, which defaults to ``meta-poky/conf/templates/default`` +:term:`TEMPLATECONF` script variable, which defaults to ``layers/meta-yocto/meta-poky/conf/templates/default`` when you are building from the Yocto Project development environment, -and to ``meta/conf/templates/default`` when you are building from the OpenEmbedded-Core +and to ``layers/openembedded-core/meta/conf/templates/default`` when you are building from the OpenEmbedded-Core environment. Because the script variable points to the source of the ``local.conf.sample`` file, this implies that you can configure your build environment from any layer by setting the variable in the @@ -298,9 +333,9 @@ file, it uses ``sed`` to substitute final .. note:: You can see how the :term:`TEMPLATECONF` variable is used by looking at the - ``scripts/oe-setup-builddir`` script in the :term:`Source Directory`. - You can find the Yocto Project version of the ``local.conf.sample`` file in - the ``meta-poky/conf/templates/default`` directory. + ``layers/openembedded-core/scripts/oe-setup-builddir`` script in :term:`OpenEmbedded-Core (OE-Core)`. + You can find the :term:`Poky` version of the ``local.conf.sample`` file in + the ``layers/meta-yocto/meta-poky/conf/templates/default`` directory. .. _structure-build-conf-bblayers.conf: @@ -319,9 +354,9 @@ when you ``source`` the top-level build environment setup script (i.e. As with the :ref:`structure-build-conf-local.conf` file, the source ``bblayers.conf.sample`` file used depends on the :term:`TEMPLATECONF` script variable, which -defaults to ``meta-poky/conf/templates/default`` when you are building from the Yocto -Project development environment, and to ``meta/conf/templates/default`` when you are -building from the OpenEmbedded-Core environment. Because the script +defaults to ``meta-poky/conf/templates/default`` when you are building using the +:term:`Poky` reference distro, and to ``meta/conf/templates/default`` when you are +building from the OpenEmbedded-Core environment (default). Because the script variable points to the source of the ``bblayers.conf.sample`` file, this implies that you can base your build from any layer by setting the variable in the top-level build environment setup script as follows:: @@ -329,13 +364,13 @@ variable in the top-level build environment setup script as follows:: TEMPLATECONF=your_layer/conf/templates/your_template_name Once the build process gets the sample file, it uses ``sed`` to substitute final -``${``\ :term:`OEROOT`\ ``}`` values for all ``##OEROOT##`` values. +``${``\ :term:`OEROOT`\ ``}`` values for all ``##OEROOT##`` occurrences. .. note:: You can see how the :term:`TEMPLATECONF` variable is defined by the ``scripts/oe-setup-builddir`` - script in the :term:`Source Directory`. You can find the Yocto Project - version of the ``bblayers.conf.sample`` file in the ``meta-poky/conf/templates/default`` + script in :term:`OpenEmbedded-Core (OE-Core)`. You can find the :term:`Poky` + version of the ``bblayers.conf.sample`` file in the ``layers/meta-yocto/meta-poky/conf/templates/default`` directory. .. _structure-build-conf-site.conf: @@ -351,8 +386,9 @@ You could for example edit this file to limit the number of threads used by want to access downloaded files (:term:`DL_DIR`). This file can be shared for multiple build directories. For example, -``bitbake-setup`` makes the :ref:`structure-build-conf-site.conf` file a -symbolic link to a common ``site.conf`` file:: +:doc:`bitbake-setup ` +makes the :ref:`structure-build-conf-site.conf` file a symbolic link to a common +``site.conf`` file:: ├── poky-master-poky-distro_poky-machine_qemux86-64/ │   └── build/ @@ -757,11 +793,12 @@ space if they were to be shared with the standard :term:`Sysroot` mechanism. .. _structure-meta: -The Metadata --- ``meta/`` -========================== +The OpenEmbedded-Core (OE-Core) Metadata --- ``meta/`` +====================================================== -As mentioned previously, :term:`Metadata` is the core of the -Yocto Project. Metadata has several important subdivisions: +As mentioned previously, the :term:`OpenEmbedded-Core (OE-Core)` +:term:`metadata` is the core of the Yocto Project. This metadata has several +important subdivisions: .. _structure-meta-classes: diff --git a/documentation/ref-manual/terms.rst b/documentation/ref-manual/terms.rst index 22f2c4f79..cbe7c88e6 100644 --- a/documentation/ref-manual/terms.rst +++ b/documentation/ref-manual/terms.rst @@ -63,7 +63,7 @@ universal, the list includes them just in case: This term refers to the area used by the OpenEmbedded build system for builds. The area is created when you ``source`` the setup environment script that is found in the Source Directory - (i.e. :ref:`ref-manual/structure:``oe-init-build-env```, or + (i.e. :ref:`structure-core-script`, or ``init-build-env`` when using :doc:`bitbake-setup `). The :term:`TOPDIR` variable points to the :term:`Build Directory`. From patchwork Thu Jan 29 15:23:18 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79998 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 D8533D61031 for ; Thu, 29 Jan 2026 15:24:28 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.17103.1769700263883458089 for ; Thu, 29 Jan 2026 07:24:24 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=sitDawYV; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id 3E4C4C22F47; Thu, 29 Jan 2026 15:24:25 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 3F95B606FD; Thu, 29 Jan 2026 15:24:22 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id A2358119A8866; Thu, 29 Jan 2026 16:24:21 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700261; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=gen7EeYXcilSpgYmTb6X4TomYS9sEn6doy0kRbHqf+0=; b=sitDawYVqmtUMA+BIGRJ57SuRC0o3ZuQTibU1FxujqDVav5zmJi3aZBTBMOlr3M1pJ+YHA rVt9Pyri8GWmRD8l4QFH0pjP5fG9F1z0bmnjA7OEzW88k84oZdR3GKwXgS/HS2d44d8KLT IV0Up2Vt72LrqFwjgZ51VOhb44JsUVk0f7C9Ls9AiXlPjLaiWaWqTkeVuHmSDC6CwEyFtg GEdBBj3r7Eu13yyIekY64WBVJQx9Qg9/Ezo99e6SG+mSMoPnPMvCz1heXVHY+RoC6bGfuG /KSyZydMz4fKW9bZk+75SH0Xp7UtonTC8YE/5II/PycIeN5x8+xFxTWuoWF9mQ== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:18 +0100 Subject: [PATCH v3 27/57] ref-manual/tasks.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-27-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1816; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=qzmUkb+8vZsVUXeMt/+kgXll/EqB55yZ399IFQSunTA=; b=kA0DAAoB0YBBQCmjqDYByyZiAGl7e42gNnTnWMWkspAtyqez8xYEPjSGLil/h86cKe4B+YBtp IkCMwQAAQoAHRYhBIZIclGI3UAbuaDT/9GAQUApo6g2BQJpe3uNAAoJENGAQUApo6g2UXIP/0iy /Szo+c5iZipxG7hwEBpSzJGKsnuMKQN6lHSphYzUF+ngczGCgKp9R1F9zVXtdIFVFfEKwkXWtMf 4cJA1nNtAuZuq1BcE8ODhfm1i4bMksqtczY0h8uSZlVuN+fUf/NL7gDpZlFg7h0+5+Qgwcgaxh+ c1mTySz11UdlOa/Jwd2BfoFKbrJW51sUNnV/srKc0YKr4JLfZ1FLL7IE2yeTgIfEb9ZOLX2peGH Zj//rBYE3XBqWYiHmoJNTcufAg/HqjuaIdG7/buEibxIWq41rsoj7upg0CcTNhFnaqhfPF29wpb xCs25NNubvAYzl3/sK0kz5YBbQ6MsAV6rQjiAoPmXVZQtIwOyOS3NqZOC2Dw5Qv139S/hKwcDlZ PH0kNsEGDk51oT6afQlwetsgbAV8RMOSXgPUrtWsNm4Kz9rQknMhv/njE8oiivsitlYEwvo87EP 2sArggbZVy/kwPBXZTHNsqdkkoW5o95whDshy//P7XUDtQ2XHYjSGE59MlRMPMGL9al5zlzEo2x x41Wbx5Pf8RAjqXNSegdCpRfEfpdITu49NRJr1daqqg1I/nmHYrrH8q7ne7tt15t58Pia4Mz527 eZjt4rb4W7W0l1bhdJx0Xh7XhvaF3/3qxh6q/hEWfUuE/+6QHxDmTkDf93gsupchdt1vyoGt0r/ glTsD 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 ; Thu, 29 Jan 2026 15:24:28 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8813 Remove references to the Poky repository, replace by OpenEmbedded-Core. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/ref-manual/tasks.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/documentation/ref-manual/tasks.rst b/documentation/ref-manual/tasks.rst index 8651f219f..e6301e708 100644 --- a/documentation/ref-manual/tasks.rst +++ b/documentation/ref-manual/tasks.rst @@ -191,7 +191,7 @@ that either directly or indirectly depend on the installed files (e.g. - The ``tar`` command with the ``--no-same-owner`` option. See the ``bin_package.bbclass`` file in the ``meta/classes-recipe`` - subdirectory of the :term:`Source Directory` for an example. + subdirectory of :term:`OpenEmbedded-Core (OE-Core)` for an example. .. _ref-tasks-install_ptest_base: @@ -288,14 +288,14 @@ to locate and apply patch files to the source code. Patch files, by default, are ``*.patch`` and ``*.diff`` files created and kept in a subdirectory of the directory holding the recipe file. For example, consider the -:yocto_git:`bluez5 ` -recipe from the OE-Core layer (i.e. ``poky/meta``):: +:oe_git:`bluez5 ` +recipe from the :term:`OpenEmbedded-Core (OE-Core)` layer:: - poky/meta/recipes-connectivity/bluez5 + meta/recipes-connectivity/bluez5 This recipe has two patch files located here:: - poky/meta/recipes-connectivity/bluez5/bluez5 + meta/recipes-connectivity/bluez5/bluez5 In the ``bluez5`` recipe, the :term:`SRC_URI` statements point to the source and patch files needed to build the package. From patchwork Thu Jan 29 15:23:19 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80011 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 EC774D61037 for ; Thu, 29 Jan 2026 15:24:28 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17204.1769700264582706617 for ; Thu, 29 Jan 2026 07:24:25 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=XdT4UDEq; 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 167B91A2B09 for ; Thu, 29 Jan 2026 15:24:23 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id E0D99606FD; Thu, 29 Jan 2026 15:24:22 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 28A49119A8856; Thu, 29 Jan 2026 16:24:22 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700262; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=ZMPCFBHHUs6Q7PTAR6lJ8d4em/mxw3VgtxuaqGJx3E4=; b=XdT4UDEqk4ZaDTUZ2ceBttc+mnV2WxuChGDQIUQ23329RENNksMfmRgD5nJm0mAJw/NKEA VlGhvhD4/nyiO8maQJHxQjEr6phZMlSdlionkJ3IUasmexK6Py5k0axd3W7RwEaVbaDBFE jG/pnkJQqykP5zOx86XrutzzfnREHOFJX+00IRSTt0mgXGwBVKmcDRz+GxHYCsT0jAiMq9 NoPqKFH0N4gzQ+4gpg4/VXycAMcOOAQDKXs8NXqU4gJPdovwfvsAjzdH8+eZOdeoelrHeW t/DsQw0yWmWTHIa2SZ5XD61EG637Yx5bjQgMBREtSPKVEq+sxdeEzq3qmGS+OA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:19 +0100 Subject: [PATCH v3 28/57] ref-manual/variables.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-28-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=24802; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=QwzjcGxuAgxAwGP/xXb3pH9YK6v8R3aiYZy9hz1EMyg=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uNshQnHmsEshpG6fjXWGa7gHboFuVr4CN4c 17y2LQ5go+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jQAKCRDRgEFAKaOo Nqz3D/9p4r/2ESJqAsfAYYXI6ogjzkKMa4ZdvJIeGPiCLPG+6wrH/pV+WMq4EnFrO4lRDtYowUj ZsTlItol4xLfW4tMniuQWx9+ExJJ1ZL1nJAJtFy+GbXs1js3X2QJhvnAdGsWBM9weZ+wjSXp/SX wED0/ibkLZbERzOZUk/kX1c9fxmIKwZzK6FCRMoXVzOS6eSz3oNj90pcay0kB/BocX1hY2PTRqq 8BrbubegryxGs9tkoWpIXGtZ4Pb7y2zvfq1XsXoGl1mQaMDmFmyftcALQRBp72Dk8ilDxHrH0bY K5pARfCRP4d+mkua0VNif6VguzczNoR08SNSmB6yWKQp+gDcS0z5+85ab7RYueA5Vx8cj5Rb7g2 BXafKB68fi//0mmqVqKmf69UIFCNNGnoiM5AojFxPUZ2UUoBwDZ8jsxsi1yi4TnHlkT6DDvkW7q AH9biSE8WI6yvwfjJNq1SrrWX12aiugzHeb5W9wWWvXVMTykN1FGxaamA+CrUQBxUU5hKzp9sbZ 0p28D37Wvz568LH+K1BHEC+8WnlklY+qy3GBhRqH9F2Gi9VCobfSuTrV3bfzJxy5e6bkvFbZY1G 74VPnQHEUmRjZwZ7ZPNXKaWAiKUq+3YAAAUmoE7XkNz9gO90d02lab+tX29HEcFIMK22el6ltIi ogqbbBFYiJG3x+g== 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 ; Thu, 29 Jan 2026 15:24:28 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8814 Remove references to the Poky repository, replace by OpenEmbedded-Core in most cases. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/ref-manual/variables.rst | 149 ++++++++++++++++----------------- 1 file changed, 73 insertions(+), 76 deletions(-) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 4d8a35473..8eece1bb7 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -168,7 +168,8 @@ system and gives an overview of their function and contents. ARCHIVER_MODE[srpm] = "1" # Uses RPM package files. For information on how the variable works, see the - ``meta/classes/archiver.bbclass`` file in the :term:`Source Directory`. + ``meta/classes/archiver.bbclass`` file in :term:`OpenEmbedded-Core + (OE-Core)`. :term:`AS` Minimal command and arguments needed to run the :manpage:`assembler @@ -343,7 +344,7 @@ system and gives an overview of their function and contents. on Multilib. The :term:`BASE_LIB` variable is defined in the machine include files in - the :term:`Source Directory`. If Multilib is not + :term:`OpenEmbedded-Core (OE-Core)`. If Multilib is not being used, the value defaults to "lib". :term:`BASE_WORKDIR` @@ -889,10 +890,10 @@ system and gives an overview of their function and contents. Here is an example:: BBLAYERS = " \ - /home/scottrif/poky/meta \ - /home/scottrif/poky/meta-poky \ - /home/scottrif/poky/meta-yocto-bsp \ - /home/scottrif/poky/meta-mykernel \ + /home/scottrif/bitbake-builds/layers/meta \ + /home/scottrif/bitbake-builds/layers/meta-poky \ + /home/scottrif/bitbake-builds/layers/meta-yocto-bsp \ + /home/scottrif/bitbake-builds/layers/meta-mykernel \ " This example enables four layers, one of which is a custom, @@ -1007,8 +1008,8 @@ system and gives an overview of their function and contents. and `glob `__. For more information on how this variable works, see - ``meta/classes-recipe/binconfig.bbclass`` in the :term:`Source Directory`. - You can also find general + ``meta/classes-recipe/binconfig.bbclass`` in :term:`OpenEmbedded-Core + (OE-Core)`. You can also find general information on the class in the ":ref:`ref-classes-binconfig`" section. @@ -1617,8 +1618,8 @@ system and gives an overview of their function and contents. Bluetooth but you do not ever intend to use it. :term:`COMMERCIAL_AUDIO_PLUGINS` - This variable is specific to the :yocto_git:`GStreamer recipes - `. + This variable is specific to the :oe_git:`GStreamer recipes + `. It allows to build the GStreamer `"ugly" `__ and `"bad" `__ audio plugins. @@ -1627,8 +1628,8 @@ system and gives an overview of their function and contents. section for usage details. :term:`COMMERCIAL_VIDEO_PLUGINS` - This variable is specific to the :yocto_git:`GStreamer recipes - `. + This variable is specific to the :oe_git:`GStreamer recipes + `. It allows to build the GStreamer `"ugly" `__ and `"bad" `__ video plugins. @@ -1637,8 +1638,8 @@ system and gives an overview of their function and contents. section for usage details. :term:`COMMON_LICENSE_DIR` - Points to ``meta/files/common-licenses`` in the - :term:`Source Directory`, which is where generic license + Points to ``meta/files/common-licenses`` in + :term:`OpenEmbedded-Core (OE-Core)`, which is where generic license files reside. :term:`COMPATIBLE_HOST` @@ -1763,8 +1764,8 @@ system and gives an overview of their function and contents. good practice to use appropriate path variables. For example, ``${sysconfdir}`` rather than ``/etc`` or ``${bindir}`` rather than ``/usr/bin``. You can find a list of these variables at - the top of the ``meta/conf/bitbake.conf`` file in the - :term:`Source Directory`. + the top of the ``meta/conf/bitbake.conf`` file in + :term:`OpenEmbedded-Core (OE-Core)`. :term:`CONFIG_INITRAMFS_SOURCE` Identifies the initial RAM filesystem (:term:`Initramfs`) source files. The @@ -1934,15 +1935,8 @@ system and gives an overview of their function and contents. supported. :term:`COREBASE` - Specifies the parent directory of the OpenEmbedded-Core Metadata - layer (i.e. ``meta``). - - It is an important distinction that :term:`COREBASE` points to the parent - of this layer and not the layer itself. Consider an example where you - have cloned the Poky Git repository and retained the ``poky`` name - for your local copy of the repository. In this case, :term:`COREBASE` - points to the ``poky`` folder because it is the parent directory of - the ``poky/meta`` layer. + Specifies the parent directory of the :term:`OpenEmbedded-Core (OE-Core)` + metadata layer (i.e. ``meta``). :term:`COREBASE_FILES` Lists files from the :term:`COREBASE` directory that @@ -2431,8 +2425,8 @@ system and gives an overview of their function and contents. file whose root name is the same as the variable's argument and whose filename extension is ``.conf``. For example, the distribution configuration file for the Poky distribution is named ``poky.conf`` - and resides in the ``meta-poky/conf/distro`` directory of the - :term:`Source Directory`. + and resides in the ``meta-poky/conf/distro`` directory of + :yocto_git:`meta-poky `. Within that ``poky.conf`` file, the :term:`DISTRO` variable is set as follows:: @@ -2448,7 +2442,8 @@ system and gives an overview of their function and contents. If the :term:`DISTRO` variable is blank, a set of default configurations are used, which are specified within - ``meta/conf/distro/defaultsetup.conf`` also in the Source Directory. + ``meta/conf/distro/defaultsetup.conf`` also in :term:`OpenEmbedded-Core + (OE-Core)`. :term:`DISTRO_CODENAME` Specifies a codename for the distribution being built. @@ -2567,7 +2562,7 @@ system and gives an overview of their function and contents. argument and whose filename extension is ``.conf``. For example, the distribution configuration file for the Poky distribution is named ``poky.conf`` and resides in the ``meta-poky/conf/distro`` directory - of the :term:`Source Directory`. + of :yocto_git:`meta-poky `. Within that ``poky.conf`` file, the :term:`DISTRO_NAME` variable is set as follows:: @@ -2582,7 +2577,8 @@ system and gives an overview of their function and contents. If the :term:`DISTRO_NAME` variable is blank, a set of default configurations are used, which are specified within - ``meta/conf/distro/defaultsetup.conf`` also in the Source Directory. + ``meta/conf/distro/defaultsetup.conf`` also in :term:`OpenEmbedded-Core + (OE-Core)`. :term:`DISTRO_VERSION` The version of the distribution. @@ -2600,7 +2596,7 @@ system and gives an overview of their function and contents. :term:`OVERRIDES`. Here is an example from :yocto_git:`meta-poky/conf/distro/poky-tiny.conf - `:: + `:: DISTROOVERRIDES = "poky:poky-tiny" @@ -3162,7 +3158,7 @@ system and gives an overview of their function and contents. use ``${sysconfdir}`` rather than ``/etc``, or ``${bindir}`` rather than ``/usr/bin``. You can find a list of these variables at the top of the ``meta/conf/bitbake.conf`` file in - the :term:`Source Directory`. You will also + :term:`OpenEmbedded-Core (OE-Core)`. You will also find the default values of the various ``FILES:*`` variables in this file. @@ -3279,8 +3275,8 @@ system and gives an overview of their function and contents. :term:`SRC_URI` statements. The default value for the :term:`FILESPATH` variable is defined in the - :ref:`ref-classes-base` class found in ``meta/classes-global`` in the - :term:`Source Directory`:: + :ref:`ref-classes-base` class found in ``meta/classes-global`` in + :term:`OpenEmbedded-Core (OE-Core)`:: FILESPATH = "${@base_set_filespath(["${FILE_DIRNAME}/${BP}", \ "${FILE_DIRNAME}/${BPN}", "${FILE_DIRNAME}/files"], d)}" @@ -3335,7 +3331,7 @@ system and gives an overview of their function and contents. By default, the OpenEmbedded build system uses the ``fs-perms.txt``, ``fs-perms-volatile-log.txt`` and ``fs-perms-volatile-tmp.txt`` which are - located in the ``meta/files`` folder in the :term:`Source Directory`. If + located in the ``meta/files`` folder in :term:`OpenEmbedded-Core (OE-Core)`. If you create your own permission setting table files, you should place those in your layer. @@ -3638,7 +3634,7 @@ system and gives an overview of their function and contents. Other Go programs importing this package will use this path. Here is an example setting from the - :yocto_git:`go-helloworld_0.1.bb ` + :oe_git:`go-helloworld_0.1.bb ` recipe:: GO_IMPORT = "golang.org/x/example" @@ -4500,7 +4496,8 @@ system and gives an overview of their function and contents. - wic.zst For more information about these types of images, see - ``meta/classes-recipe/image_types*.bbclass`` in the :term:`Source Directory`. + ``meta/classes-recipe/image_types*.bbclass`` in :term:`OpenEmbedded-Core + (OE-Core)`. :term:`IMAGE_VERSION_SUFFIX` Version suffix that is part of the default :term:`IMAGE_NAME` and @@ -4718,7 +4715,7 @@ system and gives an overview of their function and contents. With ``sysvinit``, the init manager is set to :wikipedia:`SysVinit `, the traditional UNIX init - system. This is the default choice in the Poky distribution, together with + system. This is the default choice in the :term:`Poky` distribution, together with the Udev device manager (see the ":ref:`device-manager`" section). With ``systemd``, the init manager becomes :wikipedia:`systemd `, @@ -4732,7 +4729,7 @@ system and gives an overview of their function and contents. More concretely, this is used to include ``conf/distro/include/init-manager-${INIT_MANAGER}.inc`` into the global configuration. You can have a look at the - :yocto_git:`meta/conf/distro/include/init-manager-*.inc ` + :oe_git:`meta/conf/distro/include/init-manager-*.inc ` files for more information, and also the ":ref:`init-manager`" section in the Yocto Project Development Tasks Manual. @@ -4751,8 +4748,8 @@ system and gives an overview of their function and contents. :term:`IMAGE_FSTYPES` variable. The default value of this variable, which is set in the - ``meta/conf/bitbake.conf`` configuration file in the - :term:`Source Directory`, is "cpio.gz". The Linux kernel's + ``meta/conf/bitbake.conf`` configuration file in + :term:`OpenEmbedded-Core (OE-Core)`, is "cpio.gz". The Linux kernel's :term:`Initramfs` mechanism, as opposed to the initial RAM filesystem :wikipedia:`initrd ` mechanism, expects an optionally compressed cpio archive. @@ -4774,14 +4771,14 @@ system and gives an overview of their function and contents. .. note:: See the ``meta/recipes-core/images/core-image-minimal-initramfs.bb`` - recipe in the :term:`Source Directory` + recipe in :term:`OpenEmbedded-Core (OE-Core)` for an example :term:`Initramfs` recipe. To select this sample recipe as the one built to provide the :term:`Initramfs` image, set :term:`INITRAMFS_IMAGE` to "core-image-minimal-initramfs". You can also find more information by referencing the - ``meta-poky/conf/templates/default/local.conf.sample.extended`` - configuration file in the Source Directory, the :ref:`ref-classes-image` + ``conf/templates/default/local.conf.sample.extended`` + configuration file in :yocto_git:`meta-poky `, the :ref:`ref-classes-image` class, and the :ref:`ref-classes-kernel` class to see how to use the :term:`INITRAMFS_IMAGE` variable. @@ -4841,7 +4838,7 @@ system and gives an overview of their function and contents. configuration file. You cannot set the variable in a recipe file. See the - :yocto_git:`local.conf.sample.extended ` + :yocto_git:`local.conf.sample.extended ` file for additional information. Also, for information on creating an :term:`Initramfs`, see the ":ref:`dev-manual/building:building an initial ram filesystem (Initramfs) image`" section in the Yocto Project Development Tasks Manual. @@ -5855,7 +5852,7 @@ system and gives an overview of their function and contents. name, through which machine-specific configurations are set. Thus, when :term:`MACHINE` is set to "qemux86", the corresponding ``qemux86.conf`` machine configuration file can be found in - the :term:`Source Directory` in + :term:`OpenEmbedded-Core (OE-Core)` in ``meta/conf/machine``. The list of machines supported by the Yocto Project as shipped @@ -6369,8 +6366,8 @@ system and gives an overview of their function and contents. ``sysroots/`` directory so that all builds that use the script will use the correct directories for the cross compiling layout. - See the ``meta/classes-recipe/binconfig.bbclass`` in the - :term:`Source Directory` for details on how this class + See the ``meta/classes-recipe/binconfig.bbclass`` in + :term:`OpenEmbedded-Core (OE-Core)` for details on how this class applies these additional sed command arguments. :term:`OE_FRAGMENTS` @@ -6449,7 +6446,7 @@ system and gives an overview of their function and contents. :term:`OEQA_REPRODUCIBLE_TEST_PACKAGE` Set the package manager(s) for build reproducibility testing. - See :yocto_git:`reproducible.py ` + See :oe_git:`reproducible.py ` and :doc:`/test-manual/reproducible-builds`. :term:`OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS` @@ -6719,7 +6716,7 @@ system and gives an overview of their function and contents. ``*-dbg`` package as with the ``.debug`` value, while source is placed in a separate ``*-src`` package, which can be installed independently. This is the default setting for this variable, - as defined in Poky's ``bitbake.conf`` file. + as defined in :term:`OE-Core `'s ``bitbake.conf`` file. - "``debug-without-src``": The same behavior as with the ``.debug`` setting, but no source is packaged at all. @@ -7677,8 +7674,8 @@ system and gives an overview of their function and contents. The network based :term:`PR` service host and port. The ``conf/templates/default/local.conf.sample.extended`` configuration - file in the :term:`Source Directory` shows how the :term:`PRSERV_HOST` - variable is set:: + file in :yocto_git:`meta-poky ` shows how the + :term:`PRSERV_HOST` variable is set:: PRSERV_HOST = "localhost:0" @@ -8324,11 +8321,11 @@ system and gives an overview of their function and contents. to find the unpacked source. As an example, assume a :term:`Source Directory` - top-level folder named ``poky`` and a default :term:`Build Directory` at - ``poky/build``. In this case, the work directory the build system + top-level folder named ``bitbake-builds`` and a default :term:`Build Directory` at + ``bitbake-builds/build``. In this case, the work directory the build system uses to keep the unpacked recipe for ``db`` is the following:: - poky/build/tmp/work/qemux86-poky-linux/db/5.1.19-r3/sources/db-5.1.19 + bitbake-builds/build/tmp/work/qemux86-poky-linux/db/5.1.19-r3/sources/db-5.1.19 The unpacked source code resides in the ``db-5.1.19`` folder. @@ -8580,7 +8577,7 @@ system and gives an overview of their function and contents. SDK_TITLE ??= "${@d.getVar('DISTRO_NAME') or d.getVar('DISTRO')} SDK" - For the default distribution "poky", + For the :term:`poky` reference distribution, :term:`SDK_TITLE` is set to "Poky (Yocto Project Reference Distro)". For information on how to change this default title, see the @@ -8626,7 +8623,7 @@ system and gives an overview of their function and contents. SDKEXTPATH ??= "~/${@d.getVar('DISTRO')}_sdk" For the - default distribution "poky", the :term:`SDKEXTPATH` is set to "poky_sdk". + :term:`Poky` reference distro, the :term:`SDKEXTPATH` is set to "poky_sdk". For information on how to change this default directory, see the ":ref:`sdk-manual/appendix-customizing:changing the default sdk installation directory`" @@ -9300,8 +9297,8 @@ system and gives an overview of their function and contents. .. note:: The :term:`SRCPV` variable used to be defined in the - ``meta/conf/bitbake.conf`` configuration file in the :term:`Source - Directory` as follows:: + ``meta/conf/bitbake.conf`` configuration file in + :term:`OpenEmbedded-Core (OE-Core)` as follows:: SRCPV = "${@bb.fetch2.get_srcrev(d)}" @@ -10006,8 +10003,8 @@ system and gives an overview of their function and contents. compatible with the kernel compilation. The :term:`TARGET_CC_KERNEL_ARCH` variable allows the kernel (and associated modules) to use a different configuration. See the - ``meta/conf/machine/include/arm/feature-arm-thumb.inc`` file in the - :term:`Source Directory` for an example. + ``meta/conf/machine/include/arm/feature-arm-thumb.inc`` file in + :term:`OpenEmbedded-Core (OE-Core)` for an example. :term:`TARGET_CFLAGS` Specifies the flags to pass to the C compiler when building for the @@ -10408,10 +10405,10 @@ system and gives an overview of their function and contents. ``tmp`` within the :term:`Build Directory`. If you want to establish this directory in a location other than the - default, you can uncomment and edit the following statement in the - ``conf/local.conf`` file in the :term:`Source Directory`:: + default, you can set it to another value in your + :ref:`structure-build-conf-site.conf` configuration file:: - #TMPDIR = "${TOPDIR}/tmp" + TMPDIR = "/another/location" An example use for this scenario is to set :term:`TMPDIR` to a local disk, which does not use NFS, while having the :term:`Build Directory` use NFS. @@ -10542,8 +10539,8 @@ system and gives an overview of their function and contents. definitions can be a single static definition, or can be dynamically adjusted. You can see details for a given CPU family by looking at the architecture's ``README`` file. For example, the - ``meta/conf/machine/include/mips/README`` file in the - :term:`Source Directory` provides information for + ``meta/conf/machine/include/mips/README`` file in + :term:`OpenEmbedded-Core (OE-Core)` provides information for :term:`TUNE_ARCH` specific to the ``mips`` architecture. :term:`TUNE_ARCH` is tied closely to @@ -10645,7 +10642,7 @@ system and gives an overview of their function and contents. that conflict with feature. Known tuning conflicts are specified in the machine include files in - the :term:`Source Directory`. Here is an example from + :term:`OpenEmbedded-Core (OE-Core)`. Here is an example from the ``meta/conf/machine/include/mips/arch-mips.inc`` include file that lists the "o32" and "n64" features as conflicting with the "n32" feature:: @@ -10661,7 +10658,7 @@ system and gives an overview of their function and contents. TUNEVALID[bigendian] = "Enable big-endian mode." - See the machine include files in the :term:`Source Directory` + See the machine include files in :term:`OpenEmbedded-Core (OE-Core)` for these features. :term:`UBOOT_BINARY` @@ -11350,8 +11347,8 @@ system and gives an overview of their function and contents. USER_CLASSES ?= "buildstats" For more information, see - ``meta-poky/conf/templates/default/local.conf.sample`` in the - :term:`Source Directory`. + ``conf/templates/default/local.conf.sample`` in + :yocto_git:`meta-poky `. :term:`USERADD_DEPENDS` Specifies a list of recipes that create users / groups (via @@ -11500,13 +11497,13 @@ system and gives an overview of their function and contents. VIRTUAL-RUNTIME_base-utils = "packagegroup-core-base-utils" Here are two examples using this virtual runtime package. The - first one is in :yocto_git:`initramfs-framework_1.0.bb - `:: + first one is in :oe_git:`initramfs-framework_1.0.bb + `:: RDEPENDS:${PN} += "${VIRTUAL-RUNTIME_base-utils}" - The second example is in the :yocto_git:`core-image-initramfs-boot - ` + The second example is in the :oe_git:`core-image-initramfs-boot + ` image definition:: PACKAGE_INSTALL = "${INITRAMFS_SCRIPTS} ${VIRTUAL-RUNTIME_base-utils} base-passwd" @@ -11632,13 +11629,13 @@ system and gives an overview of their function and contents. - :term:`PR`: The recipe revision As an example, assume a Source Directory top-level folder name - ``poky``, a default :term:`Build Directory` at ``poky/build``, and a + ``bitbake-builds``, a default :term:`Build Directory` at ``bitbake-builds/build``, and a ``qemux86-poky-linux`` machine target system. Furthermore, suppose your recipe is named ``foo_1.3.0-r0.bb``. In this case, the work directory the build system uses to build the package would be as follows:: - poky/build/tmp/work/qemux86-poky-linux/foo/1.3.0-r0 + bitbake-builds/build/tmp/work/qemux86-poky-linux/foo/1.3.0-r0 :term:`XSERVER` Specifies the packages that should be installed to provide an X From patchwork Thu Jan 29 15:23:20 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80001 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 08001D6103B for ; Thu, 29 Jan 2026 15:24:29 +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.17104.1769700265498762452 for ; Thu, 29 Jan 2026 07:24:25 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=mOlVlOg+; 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 0517E1A2B0C; Thu, 29 Jan 2026 15:24:24 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id CF397606FD; Thu, 29 Jan 2026 15:24:23 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id C2020119A886F; Thu, 29 Jan 2026 16:24:22 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700263; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=rLCEHWNGr6eddx+hl7LlMQHNsXNfQRqquwCD6NQ9d7Q=; b=mOlVlOg+CjE1AETZX3kc5ft9DSKs8vuJB1D4TPsD+BlJRyVuYARQElCvPA6IG5HwAdTjQD kA2Vfr9vkwc+GQmYZOJkDOn2NsuBTbOx0pgWqM+BMYJm1BcdQvIMKBNrWs90ucibClMZgT pXon/Csrvc+XThqR4hWtXNCBWhLxdMbxNv6jSViK+WAnLH86vqv7iKVyBapSnyIc247nsp 90ow1CO/QJrLeBNP00/+8o0Nq5h3/suJ6h+iAtOK0c3k1wxbetocukA2PI1bkrOIyOBj18 4hUYuPDdQ4JvcGQtadRRzpLZ8rdGXMVfG7Mw3Dkyfu+cCZKCqZZwDmK67HNOjA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:20 +0100 Subject: [PATCH v3 29/57] sdk-manual/appendix-obtain.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-29-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=925; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=MafI2AcNdD8TuqwMIDJi8Kd+jdqZA7tLcYjnsEdHX7M=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uNDMuShh+H4E9ih1uR52WydxMwdOwrWRY5E fhTZWDiK0qJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jQAKCRDRgEFAKaOo Np0+EACZIvTy72vqrEKNXSw++Jbldxlm5QXeNh/Er6cmHGwtSpJvgRy3ubVfHX+ympvnNOGS2Er jbo5V1nbAMOPTx8efDK3ZIykYMuRp6HKMBenNyp8ODT2JJhaP/FLvsMIFpnfGXDbVljn7RBtgdR KFpVIx4sOWi+EWOt/+0UZ+nJVIzwUOOX8n6O+WjBKYwNvMhSCuYbyPGXb7sAx+yA0c74tx7sDh3 U7gURi04Ls8bxJOIbZSvWnPA+shKNxBjkR0H8ogVA1wJXYySW4RFbidhhi9KEWceIV3e2WfFXWz VrGBOG08igWqXeaaPvnAL1+nF8BUuG562Xbk+S92O/yXmY/KywAVf3/YNG1uIueU4JW01CUaEEg PjPoC4igUJXgp0OXjAq7wg59hmyqGR+BQZy+RQJlrXHzYorerdoF/9F3WI/9K4epHe1CjnJ3p4E efAPgXyDtRK6d6Gss1M0JchxIIi5z7lyWBOFOb8d94+I4uyWOvdgVqwW2k4orTOSYf4PGhbWYax j5xx0PKNpBpccBDlrVONDsunqTItiVsQD9rSPgoTt1rTh8Xy4DVsHyADAcdvLymfo9rW6oGPDM5 j6T1oP5mt3fo5oe7dyBcXzbZYLIWJejVAatvY6AE/NjLDEIbxnkRcEyH/XpUGVeHf3V3xTn2Bwz 4Qo2RYgmTV0yD3A== 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 ; Thu, 29 Jan 2026 15:24:29 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8815 Rename the source directory to project, as specified in its new definition in terms.rst. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/sdk-manual/appendix-obtain.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/sdk-manual/appendix-obtain.rst b/documentation/sdk-manual/appendix-obtain.rst index fb2326fac..a6f2da052 100644 --- a/documentation/sdk-manual/appendix-obtain.rst +++ b/documentation/sdk-manual/appendix-obtain.rst @@ -166,7 +166,7 @@ build the SDK installer. Follow these steps: .. code-block:: console - $ cd poky/build/tmp/deploy/sdk + $ cd bitbake-builds/build/tmp/deploy/sdk $ ./poky-glibc-x86_64-core-image-sato-core2-64-toolchain-ext-&DISTRO;.sh During execution of the script, you choose the root location for the From patchwork Thu Jan 29 15:23:21 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80002 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 0BF4CD61033 for ; Thu, 29 Jan 2026 15:24:29 +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.17105.1769700266020855043 for ; Thu, 29 Jan 2026 07:24:26 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=AYYn7P+6; 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 7FE714E4231D; Thu, 29 Jan 2026 15:24:24 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 561FF606FD; Thu, 29 Jan 2026 15:24:24 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id B17A3119A8872; Thu, 29 Jan 2026 16:24:23 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700263; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=n5OaUNAOptAFyjAf6DfEXgFAFCGJ+n3HltCfdmRu0wY=; b=AYYn7P+6NMzf0lbcYWbv4lcVI6j8kZBi/WvVb0LFQ7Nv1RrYOdIqDJfoWa1v9rKVBb7+ua eneLt227BQyZ1vY/X+jz53yS3CkCn8uA9ZmAPkgsyVw75esLNXizzqBGy4+SJIHa4VQHqc v5DonMWM43OjkdkeFdJ6V+qhzpkzuKSlPCDDQpbE41guwTtNBUl46rDkjrSO8/QAj8gv6k CbD+hyE1CPKbirXTRostJwIS7sVBlTLnfgvGJ/4+gA1tUhAeTZi6BSRSwrX490OuQKRmXB 4fG2LALiseeKiyU27h9ljo0CpUFS3nrQftg8XMrd4D//sctDTvNnTGuPGsMdrA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:21 +0100 Subject: [PATCH v3 30/57] sdk-manual/intro.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-30-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1217; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=bvQUyqXI+EleB0l1QIp4PFuuQhCJJ9um4ROetcHaQ/Q=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uNB4MNUDt4JyndMK+vJHszbBJlEp4rfm1pE Ro0DIeimSOJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jQAKCRDRgEFAKaOo NtcDD/kBCOtyw2oCSUmq6PQm/f7sz0j8FoaQv6aD8SU+GK5zz4slYIiq9pVFofIHkimR2uM4aC2 TGv4OMhpopWHGIdcoxJ7fTTpLLfb2YoTWkA3o/tUxhW3MDuHoqxDsXVFy7RY+Hn4Bi+dP43LoFy KQcUdE8EZ58032oQXs3bnv2NWNlBqWuf6vllVQrcWMxN514i731fH7w4WDs1RFGFhC4kROENHuR gGDK/p9CRNzanc7LpxZySsmc548U2gcNi156dfom/SWJOutROKSHb9jgcIYWUvgtYgszk4/dYvP pvNxAxvdpTZje3EKdE4FNnWUlzOby4imBx5s4TGZHJ/a2LBnKgX6xxby1nz594M4hCIJYyEjB4T 5pc834NM2e9b0EM77fjECcFKV8VD+NMmnYkSfwRYGj6ABkqdZB4XRI99j+4g8PUM5b5g4Ye1JVx iEuEQXDhTQr68jLWbrMKjtdINcyRXXfbXm9xWIwug2+gmh7In1wCVampD2kbu+LmhzAQsNFQBVy yHJSvPbLttf6zf51MShAC0AaccNKz4n1HORKWNnrv3EIqU3++hmoAxmCrtSvLGm86aGi2syLtSB ZO5mBJQBNi3aEHS8cOgsajHZQIJbw49SmBW1EHCVRuUFL2aeaGLP7aZruenR4k1jkAN/6edgQDQ 7JJ6wl7v8PRt55g== 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 ; Thu, 29 Jan 2026 15:24:29 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8816 Remove the mention of the Poky git repository. Refer to the existing setup instructions. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/sdk-manual/intro.rst | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/documentation/sdk-manual/intro.rst b/documentation/sdk-manual/intro.rst index c96e58dd7..dd2902cc4 100644 --- a/documentation/sdk-manual/intro.rst +++ b/documentation/sdk-manual/intro.rst @@ -133,12 +133,8 @@ your application or image. QEMU is not part of the SDK but is automatically installed and available if you have done any one of the following: -- cloned the ``poky`` Git repository to create a - :term:`Source Directory` and sourced the environment setup script. - -- downloaded a Yocto Project release and unpacked it to - create a Source Directory and sourced the environment setup - script. +- Setup your :term:`Build Host` as described in the :doc:`/dev-manual/start` + section of the Yocto Project Development Tasks Manual. - installed the cross-toolchain tarball and sourced the toolchain's setup environment script. From patchwork Thu Jan 29 15:23:22 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80003 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 1E9BAD358FD for ; Thu, 29 Jan 2026 15:24:29 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17206.1769700266449553257 for ; Thu, 29 Jan 2026 07:24:26 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=qtsZhirA; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id E6A5AC22F47 for ; Thu, 29 Jan 2026 15:24:27 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id E799D606FD; Thu, 29 Jan 2026 15:24:24 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 40F28119A8870; Thu, 29 Jan 2026 16:24:24 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700264; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=RHi7A92HtD+x9RptsFdqPqLKhKHW6FqCplAHQVqJ1sQ=; b=qtsZhirALb6S2MhTu1aKxvwD0pLfuG0gsgg1DJEMEYBmxNVBuprmAf/RZ0VKxFdRQf0yPo i49WIa7dU7C89HSNpJOi1w9/jj6d/LNIp9NaGvEY62pn3l0ELAyjwOyVkoWB2ch9xDp4T3 On6i9kFZ67XF4aVqcbSYNgPbddLkjjBCdNosRDKmISlTzRbXGZ2J9MLEJS1QJvnKQndJYW bgu5bYjQeUL9WOKgrw2nyptX2/mawbYf0CPhL7Jk7EVFa4oNnAWj1EiCNrX5Kvf3P+VRJ8 Kp6RTUFy4rSjL64tc1NTipKFUjXkj3RhddnLSlK5K5oI15hW9I8cNmZWONWQCg== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:22 +0100 Subject: [PATCH v3 31/57] test-manual/runtime-testing.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-31-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1136; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=6b4ZNdLb6VrawItlmTxlixygM7KZ0Wu6HZlxqPaxgsY=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uOJqCoUyhyecVWSwBC43XSnizCsfUmO7rA1 JXpRN1uNCaJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jgAKCRDRgEFAKaOo Nhc3D/0VaOPyaxCbxitjomJI9oflgW7yZhVoMyobQGzHs6DLpcpmDcqmKhFO02nt2atnm7wY2wV Xsxc00xZaD/j63SNhqmdd4PIWIzwEWwDhH7alk7RKDqiY4242pid2jhusj4dc0sd61R8ju6rYcF HdYRgVZVJOP216bZsnJ+AOPE4sY/L/4FY1LQebk+O++WebDkbiqFAfGDERd9vrvHdu6Ndm1kDnL FDUnJKzICepuWcdTForP1jUrS7NeY69HZaOQtE5ObJoSGdBbLQyfN+Xa2oQADW0lbDl8k/+1Tqe /I3Z436V+m0SV0tfHDNfHs3Ek/iyMWeeO5K7z2qkG+nZvt9316ylVRkT9ygeFdjjv4aRjrxWQVh hs/85jpY3v/2IZxE58T0PgsZmLt7iIIin9esuMvGeer+YX0L0IX2EkvMOO8f671wAi5wqQ3LL6H shI81O1zAZtqrnu0szcishqy5+afbZGjgyJaFip0VgEgHHNCUd3BD3L3+e/ztA8OoE0fx7Du8qw bGhAWORrRDqoqjO2uoRqD4e+hUtP+Hm6FVImXIoIFyWc8e07IpT0/vDvEPaiF9gPGMGwiUh8di6 Pb0+tsS7KkiYUHSe4zAmB+M03+YXVLBPw+ovBllxEmzzANS3dZxmCKHMTOW10POZGUxDqQSSt6H UWARtZH4lapv4ZA== 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 ; Thu, 29 Jan 2026 15:24:29 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8817 Remove reference to the Poky repository, replace by OpenEmbedded-Core. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/test-manual/runtime-testing.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/test-manual/runtime-testing.rst b/documentation/test-manual/runtime-testing.rst index 909448ab2..a64a97c80 100644 --- a/documentation/test-manual/runtime-testing.rst +++ b/documentation/test-manual/runtime-testing.rst @@ -338,8 +338,8 @@ You can start the tests automatically or manually: bitbake -c testimage image -All test files reside in ``meta/lib/oeqa/runtime/cases`` in the -:term:`Source Directory`. A test name maps +All test files reside in ``meta/lib/oeqa/runtime/cases`` in +:term:`OpenEmbedded-Core (OE-Core)`. A test name maps directly to a Python module. Each test module may contain a number of individual tests. Tests are usually grouped together by the area tested (e.g tests for systemd reside in ``meta/lib/oeqa/runtime/cases/systemd.py``). From patchwork Thu Jan 29 15:23:23 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80005 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 2C23AE63C8C for ; Thu, 29 Jan 2026 15:24:29 +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.17106.1769700267338992601 for ; Thu, 29 Jan 2026 07:24:27 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=NH22+QbT; 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 C715D4E42322; Thu, 29 Jan 2026 15:24:25 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 9F643606FD; Thu, 29 Jan 2026 15:24:25 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id CBE28119A8874; Thu, 29 Jan 2026 16:24:24 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700265; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=j857tcLTZc6siJgypydhpXa5LtI35vwCsiBiU3//hp4=; b=NH22+QbTP/OSjfGvwGpXXQ2/jhaZ6r43A49nob0oGn4vCrVJ1r8SRHnTl68/tOz4Ua63M1 5XenUK64Jcswgk7kAK74GaPNy59A1tPeX1efQOuYK14MnrZdHsI++DBrvYE19UGLm48DxE qIup1M+PO/NtcsHaJsbmCJBOntKLZWJeqdrkh4NfgLwnKgZ8FENKwrpHavkrl3mD6pbPcc 3tnXUjF+S4xqMoCSSdsKRJhlgdrhUHHUbRGSQBUEmCnHh7hArFvwzcnmy3PfeI5GUj7Pi9 oklVFw/E9Msd07uiWQPLwk8Ot/Qzfn7NXo9oUMsZX1n3aY4EWJeef3LTuiOtLg== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:23 +0100 Subject: [PATCH v3 32/57] README: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-32-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=3087; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=909HxdaXT2V2+jX4ONFms7vGwlPWFwf0ai4DHMrdhN4=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uOux84w9zzg9VitckIeQnKik7Y39AbdEJlU RdfvMLN8AGJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jgAKCRDRgEFAKaOo NthDEACWbEES8WmZLto+uoLUYhN33xmpwG1Xljy1VzneRGj6jwBzmEe92rMsPycZLKFNKm5cptE JUINeGtvnhj9bQ2iOW3SRS9+M4DlzMz+YL6ECXRut/ll3Y7bha2qE12m3Ay0pVtwCJ9qssXDdJ5 hR3hKxaxi7PfPxLLAuBtNr0NSnLtJLVnGnVwrpwpUMMIpCnHYrYJz01QNXyGsND2HDKoXvAo9dh rsN7zLnBuH5mzr9x3N0EyO3Nbof9SUXKSAjkVo2qof/4HO5dvhh81SU28stXZMnK8gEMJsvw/xr gyS8I+rt6dS8Iz5jkC+E6bn7Qm6U2wUMWMZYukj1Z01Tsd1bAivlUhjXl/ULnYJwlFxo9cx9nZI xrFSoy5bMv+Up9vFxCFF3ZR5Aw8vzCmhEp/sTfTSTNJArjaypCZcGxYnzg8NR7CEPZn30Fqwguf LFReG7YFd1WWKYvVXsQO5iQueDTN1qjyO7eL/YbOXD5p3k6Zfn9r9/35tyzNZJFYyHsD8zsvfBy EGbF7jujf04BLB468dxwU1TvWtfszNcGegqLpmM+5+YZgMtd7Wj5asasBX417PV7ZA+2fG3/BHJ 6TkjAN5WdKNQVICRRg2I4/80Ibxc/VHq0yQcGJEmcoW4tq3SEMRq6QIac6cKHw2lWzTZF9Vm+be M5atr3tRjfevfCQ== 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 ; Thu, 29 Jan 2026 15:24:29 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8818 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/README | 39 ++++++++++----------------------------- 1 file changed, 10 insertions(+), 29 deletions(-) diff --git a/documentation/README b/documentation/README index 56eac7ca1..5516d71a6 100644 --- a/documentation/README +++ b/documentation/README @@ -1,33 +1,14 @@ documentation ============= -This is the directory that contains the Yocto Project documentation. The Yocto -Project source repositories at https://git.yoctoproject.org/cgit.cgi have two -instances of the "documentation" directory. You should understand each of -these instances. - - poky/documentation - The directory within the poky Git repository containing - the set of Yocto Project manuals. When you clone the - poky Git repository, the documentation directory - contains the manuals. The state of the manuals in this - directory is guaranteed to reflect the latest Yocto - Project release. The manuals at the tip of this - directory will also likely contain most manual - development changes. - - yocto-docs/documentation - The Git repository for the Yocto Project manuals. - This repository is where manual development - occurs. If you plan on contributing back to the - Yocto Project documentation, you should set up - a local Git repository based on this upstream - repository as follows: - - git clone git://git.yoctoproject.org/yocto-docs - - Changes and patches are first pushed to the - yocto-docs Git repository. Later, they make it - into the poky Git repository found at - git://git.yoctoproject.org/poky. +This is the directory that contains the Yocto Project documentation. The Yocto +Project documentation is hosted at https://git.yoctoproject.org/yocto-docs: + +This repository is where manual development occurs. If you plan on contributing +back to the Yocto Project documentation, you should set up a local Git +repository based on this upstream repository as follows: + + git clone git://git.yoctoproject.org/yocto-docs Manual Organization =================== @@ -261,9 +242,9 @@ For example, the following .rst content will produce the 'expected' content: .. code-block:: - $ mkdir poky-&DISTRO; + $ mkdir bitbake-builds-&DISTRO; or - $ git clone &YOCTO_GIT_URL;/git/poky -b &DISTRO_NAME_NO_CAP; + $ git clone &YOCTO_GIT_URL;/git/yocto-docs -b &DISTRO_NAME_NO_CAP; Variables can be nested, like it was the case for DocBook: From patchwork Thu Jan 29 15:23: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: 80004 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 2CA7BD6B061 for ; Thu, 29 Jan 2026 15:24:29 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.17107.1769700267922890150 for ; Thu, 29 Jan 2026 07:24:28 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=ZExQp8Ip; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id 4BA88C22F48 for ; Thu, 29 Jan 2026 15:24:29 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 49669606FD; Thu, 29 Jan 2026 15:24:26 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 80B74119A8876; Thu, 29 Jan 2026 16:24:25 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700265; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=NCqCo/b1MZa4OC5vrY9VUA8rSKR0GZNy/OoKZ7ZGSD4=; b=ZExQp8IpvExeMxgRzwqauLC0CYdMPdq/zCqUpD1HCrv/645HpDKqEGMUhnWQO+dlwjXcuH ID/oEhup92fVD2K3KZU6ogyVAKGRd7Tm3jN2SiCvZBP0UZWeYiq68DmirWH8TInROWubl3 hZloZDtE7iePA96E9rPobwTSX5lUdwkKBk5ul2kibxARZu3gPJtyDgGzMxD9/bwFA+4Vhd v7dJocKKbnajE9cUNIStPVLu9bH5fmJf3JAA3Vjwmoo2H7jwm9Lo77iNMS1Di72/LGto2m HS7l6pY15mkga4ROMdDY5HzvSrMKmEbE8JxyoQMfLZCHx/Ss3mnwDdf2LNdSrA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:24 +0100 Subject: [PATCH v3 33/57] README: replace obsolete substitution variables MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-33-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=971; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=SSk4gs0Wl+3OcvDgNod04W5CxW+0WvJBuqTPOPWE7TM=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uO7rbrrNmG16+howyFjakn6hPryBVSLfOao ldN0ga7EjOJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jgAKCRDRgEFAKaOo NlPpEACCl7eA+cwnX2Sjh+jTW5KvkgYBGHkWiTuPKXzD89oL/IUDEOuBTQWeH6CML47CCMDfOl0 JqgvDvrFoDAdNP2adlz5vPLPxCAhfBdZhdzQ1ct+R7eCF4zK5I/0vI0kqcXcvsYd8dNAm8oCVG5 YmyHmgsKZhrIXQqw502QUoChvzLeaFqAb6BS6neZ3p1ZEFtPY9KfuGmJ1kmKucH7FUQJ4I1Fy80 +Q4qkBaOXX6ctXx62sxDBhwiL1a4CkGfp0UYrpSLMcLNgD14fXcmWa2I5pSqLQGr3GFGwfQEae5 q4iZ9lSHYNxbmM2eJBt0igNIUNfhpd8QVl7OQTVn470i5IoQoi2Xbs67bOTVIbtBCv8XInIQ2Gq u7ZUIi+bZ9XHXvQBVjD/qTErY1XOG8KsvPWspATCMlfBw/EVaKMy4m1lO6pDtJcrrZDZH+QeHtb tG00n6IkwovGJNauU4Bui8eCGJPfyQSVt1/o2cFTTKs67CuMfi/oTLfczBzkP9vUH4bLS/etAQ2 /BNmE4cM7R8/KKe+D6PoQhGaptpe4/mvxUsxuozc7B3u5DZkWILFotVhzTwNo0Qni/GaUmFNNdZ ik3+RhCP2hnzH7Wyev4BdV3MMKdJ5BNBzxryR5N9GtiiemzCYj2Uz+mOyIG57LOpyuCUKneUXdT DQkUOzu3UB5CqSA== 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 ; Thu, 29 Jan 2026 15:24:29 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8819 Replace obsolete substitution variables by current ones from poky.yaml.in. Suggested-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/README | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/README b/documentation/README index 5516d71a6..7c4472c73 100644 --- a/documentation/README +++ b/documentation/README @@ -244,12 +244,12 @@ content: .. code-block:: $ mkdir bitbake-builds-&DISTRO; or - $ git clone &YOCTO_GIT_URL;/git/yocto-docs -b &DISTRO_NAME_NO_CAP; + $ git clone https://git.yoctoproject.org/yocto-docs -b &DISTRO_NAME_NO_CAP; Variables can be nested, like it was the case for DocBook: - YOCTO_HOME_URL : "https://www.yoctoproject.org" - YOCTO_DOCS_URL : "&YOCTO_HOME_URL;/docs" + DISTRO : "5.2" + DISTRO_REL_TAG : "yocto-$DISTRO;" Note directive ============== From patchwork Thu Jan 29 15:23:25 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80014 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 4A5C8D6B062 for ; Thu, 29 Jan 2026 15:24:39 +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.17108.1769700268965500507 for ; Thu, 29 Jan 2026 07:24:29 -0800 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@bootlin.com header.s=dkim header.b=qjpYaPO9; 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 7008B4E42324; Thu, 29 Jan 2026 15:24:27 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 4786F606FD; Thu, 29 Jan 2026 15:24:27 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 2F200119A8871; Thu, 29 Jan 2026 16:24:26 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700266; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=uMcuMT4dibcWtAqrz09O2BtxBgPEYlHDEBdt/vUkqWI=; b=qjpYaPO93jUep2iT6Cswdu6bJQ4WI2HiSiQVFO1p3khIEJhIuZ6XlwtHalC2c4U9OphXUK g4fVmDaKQX9jwtGVPVAk6Y0Z8s//jMa9bHn2XZhuwaa/jWUAllknFmrrrv2r153khNCIQh hBkVMq26luLX6ckFLKZN4AtbIhxET2d6mDTEh8funoq4pq3cTY/pDi8llV8L4UlSyDCgcz EWVozic0U1BEmlcpWD9IQTOpHXOkOJmjKxcE/iwnZaYK/RIcyPCm/rHsmc3eta/cUPJv8r iwm92TsdIREo4cew+OZ9IQTxogcrIeKxRReRkGFXiaBcd4VJtGi2v6IeLM60/g== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:25 +0100 Subject: [PATCH v3 34/57] contributor-guide/identify-component.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-34-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1378; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=Mn+EAY4BOzv7Kb488qKxFYyP/2eJ8qGz4fgueKEcaRc=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uOTkQccVrd5E4fVf44S30oBPmQCJL+1qGf8 lvL7uzalvOJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jgAKCRDRgEFAKaOo Nmn4EACQobh7G7Au3Dp2IO7ofBk1sMaQSd2bC67iRfd0IrWSeIM8Ye2X9BdlRyaf4Bdyf4dJA5t 6ealQ2gV2t5awC3BpG7NFoBUlvZtEDhFqyH6OPx8V41pRHUA3+jqcVAWiE9NRpOUdJl4tPBquUx EO/k0zoN9b7U4TFJcSd4Wn5ImANPJqBk2atAPk1RjajitSoOhi/DOJLXjPlpiMFWHUsfP5qum0y jJ6V0kkhz2Ys0UCIxDbohOpmxhtznpJR04TpLthGBKUGYbIdRyBzWBsjAlBRfdAZtZRHPCH8D/V ARsfpjjzUB2SlqNq3P9UUz8fGIRx6AFuX/1RBghcame2a13EeDau15aV4rkfto/iVQB76UXqvHJ IePYw+fas5/5ltyq3IbaFzrswqVY01GlSRmy+JQ1WtXai3tnswY00Qv9cCxQUMAqz+gKK6QYmRy sBfpOtTr5zFWqUgzlJfBcDG36JuniUaog+kZ6KcqiB/BsvnAJmB+Lwj8lL0/zXozlcHh6gWruw9 L8h1J6R7u34bbVMSqF9jubfCvtJm4DhFhAo0dh05VEUo93Cy5UnakGT4qQm/2C/zFdsTCokLcKI srZO8thKTOR7krprPK1V6XHcz+GJJG/alS1ggk/cQbyok4NT19T4BSK7jm1QT8G/Zn51kzm/Zvs qXnMQJLTkytkFzA== 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 ; Thu, 29 Jan 2026 15:24:39 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8820 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/contributor-guide/identify-component.rst | 9 --------- 1 file changed, 9 deletions(-) diff --git a/documentation/contributor-guide/identify-component.rst b/documentation/contributor-guide/identify-component.rst index a28391a66a..6cf8ed9858 100644 --- a/documentation/contributor-guide/identify-component.rst +++ b/documentation/contributor-guide/identify-component.rst @@ -20,12 +20,3 @@ If the issue is in the core metadata layer (OpenEmbedded-Core) or in BitBake, issues can be reported in the :yocto_bugs:`Yocto Project Bugzilla <>`. The :yocto_lists:`yocto ` mailing list is a general “catch-all” location where questions can be sent if you can’t work out where something should go. - -:term:`Poky` is a commonly used “combination” repository where multiple -components have been combined (:oe_git:`bitbake `, -:oe_git:`openembedded-core `, -:yocto_git:`meta-yocto ` and -:yocto_git:`yocto-docs `). Patches should be submitted against the -appropriate individual component rather than :term:`Poky` itself as detailed in -the appropriate ``README`` file. - From patchwork Thu Jan 29 15:23: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: 80013 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 552DCD6B067 for ; Thu, 29 Jan 2026 15:24:39 +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.17109.1769700269315622223 for ; Thu, 29 Jan 2026 07:24:29 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=IS7ts26B; 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 C2F7C1A2B09 for ; Thu, 29 Jan 2026 15:24:27 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 99822606FD; Thu, 29 Jan 2026 15:24:27 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id EE702119A8878; Thu, 29 Jan 2026 16:24:26 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700267; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=OwUWpRWMPrgm6HVeblqHP0Oag71pbGSwTNBV37/NDZQ=; b=IS7ts26BfulyEeXY5i+iRhSMVaIvDOkPnS6x4mZ0YEpQiNOc+/WKMIwoAfZlSrzlsKMOSL FKOEPQkhThUU3p8vrphQgX/iTyQJOBDygoWV0EkP0XE+miBEU5AEgf61Uy6gEx8dcgUFPb mGFwrUwxzb/DszG2cv871pD4qjzRv8WAjymk1liJfM5X8STcD7VSMmucxEbPoDIfRVvny7 3ghKEEWQsTtEI3t1u9VZaGd0JGA+Wdd1NZOrwhayhSO0GL9m/3SrzrhkvY2wFRWilq3UOa PAYt9lbmQgMoo2OUU8hOOkVY9hLPz4Cenx7JT8Pbm6efQGDYb57Hhb6nM3kfxw== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:26 +0100 Subject: [PATCH v3 35/57] dev-manual/build-quality.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-35-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1058; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=k18j4Wg0rt7VgSRN3B60+9X3/bH0AdNYWB9NX1davUo=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uOzJiwwVIpm2mDSuB1BShIMnzxX/kBSq+t0 HJJekSGg4GJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jgAKCRDRgEFAKaOo NskOEACB4t9U7xrh0Qh67WDTuDd3YwTwChpgY+9NVyr3DfjX2+mcg4Mf4xjweFhX9X46lNwtRv2 Egc8SB/VOHXWltAgVXoRUKwcXQReMpc+Fan/30UF+7EHZAlSIZ32hUWM/CCDl5yMIlAVJjtwtMS rzfZn3eIKUxuqckSfxwhbCxkCS7J0Gp0M7AtML2IS4dE5rith4FZ4zl3TT3atwTm4iXWRyVJPCs fc4evSAbXStKJWSw48GVCBoO6T9FuQ+NdsvlDz/OV6OqE6rLGsXMQ0ygK2YJyizq7RMQVGv+MMf MQH32nAgPL70Fr/JtZEqQhMPlGVg84p4xaO0c5fNoJu2QIyY6JvK4tRVlYNb7fhpCdvAssoEAsr sv0Hhb8XnqIDiW7Tr+FGdasTtPXFOL66PaqAE41kAH/Z1I5jHrFbgdZDvtCXVF3rtOFzF89L0Q0 Ie3h1IkuAT5f/gF3yjoLNxxrpzTsKzdElrO9rhVscIUM1ymjfAW0t6SJdFGHqQi9LiTSMxZUDFA sfJU7htxihJ23nm+ZJIdxioHbk4cTxZYd0n7oR6jdFbmXLHzZuBbZu5OxEAtiQP5s4quxMNe331 Puow5uKySr7q7OaLn34rqIJkTu5SHhGKFvUI6FrJEg6uJszw/0rLp24dacpfRWoP5vEW4lHkr8w GdSBZCC872NrHqQ== 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 ; Thu, 29 Jan 2026 15:24:39 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8821 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/build-quality.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/dev-manual/build-quality.rst b/documentation/dev-manual/build-quality.rst index fbe5fb6f0..163d8832e 100644 --- a/documentation/dev-manual/build-quality.rst +++ b/documentation/dev-manual/build-quality.rst @@ -372,7 +372,7 @@ There is a command-line tool called ``buildhistory-diff``, though, that queries the Git repository and prints just the differences that might be significant in human-readable form. Here is an example:: - $ poky/poky/scripts/buildhistory-diff . HEAD^ + $ bitbake-builds/layers/openembedded-core/scripts/buildhistory-diff . HEAD^ Changes to images/qemux86_64/glibc/core-image-minimal (files-in-image.txt): /etc/anotherpkg.conf was added /sbin/anotherpkg was added From patchwork Thu Jan 29 15:23: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: 80018 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 9E414D6B072 for ; Thu, 29 Jan 2026 15:24:39 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17208.1769700269990337866 for ; Thu, 29 Jan 2026 07:24:30 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=AnRDbbXz; 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 7B0FB1A2B0C for ; Thu, 29 Jan 2026 15:24:28 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 49703606FD; Thu, 29 Jan 2026 15:24:28 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 819EF119A8875; Thu, 29 Jan 2026 16:24:27 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700267; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=5lWGedgMp6d5SJVOVQvGB3V6zoCnioUJVv95zER9pBU=; b=AnRDbbXzkhYfCHp+sDdKz1FAJNPkzQBBNhGYDTK3CKO+G9qOm6zSuL0ncEZLXa58VOXB/5 ue2XSMG307ux3s9U3aZaeUDIm7rQOultwv3CUIQ/TL3IlpDfWKUWtnAErv/iVb/KL/NQBz uYLoB67wwa9+Si6IHz1qGryiU63MytffzVkaUfJm6TLGdqKH8BQrcB+NsCe9QpvdeO1UCi MC0DAhXglkPZOus4zQMnBSauPfICsQWY01yy0baSz6/kaMiNU2mt6VEipaoOBLBdXjBiWB t8TqylfD+d9HCmlkS88N/BdmLgDhfiSvN4/S/YqplGfKGJwS4FjLNGYOLuM0RQ== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:27 +0100 Subject: [PATCH v3 36/57] dev-manual/custom-distribution.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-36-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1191; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=e2biYZgbv6AVXFPbMCV+AeaAWoHiX/b2fQmc1CcthnU=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uOulMrf6mwor5CWhilYrmkpzFgv9qIJdXcX hK8zuaCtwqJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jgAKCRDRgEFAKaOo Nk3mD/4582ftJ8i4ANLCCbMG4Nk/JV6kYZF44RSvNpPamiKV1aWriEsbSjMoir9CnEpqpjsbXu1 H2rDObCX5FXHGY6OUZKPSGV9A7FrBHrq2DaUCr5/O69pEXeZn8xLe5evrpFnsTbgLvmj747631K Tx00ebRnkX0PPHKuGZqwKPP6UYtuYvMff44CsY6qNoxroX0mjeYX/dXm1jBPU8jb3RvIrdcmKRC mwCQ/HV5sJIMPBqhGk1GgshIyKzohjO5yVRwvuo51NNVeB5koeJml8ueu7vG8cVFQKIYA0cwi8Z rXIZHFUROLo3xan36tUx/YH1JPH9aU/d0DT20xKEa3Kv/SoZKHPrw3OpUD/N+jXsB/8uvzkRZ4T VxBvqkbQsHOI4tXOkVBo0y7bRS1ExGSD25hCI/dLLy/EXugEWA5eQ8HkvfauUKQZYphqH/PrVt0 mts3BfWgX/ezRHNShvy+eAMdwzokSCCsgw+HjNr3bGmfQ3ISDVv9RnYD6Z3OBDbIsBcMOdsEhSB lGvJrvR7MYbVuCSZaJhTsgRKPoUa5BNAJmK7YiRo0N0mG8qXCFOUL09jGfTJgAbqbeh+aUeboSv ZhwlpqKBy9SS7/4jWOB8loM0gEqMT+rJbeZXxqZ22lgRBlkn6LC9OkR9nF01ivWiC1/++j9pM75 n/BWwEA9WRSwevQ== 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 ; Thu, 29 Jan 2026 15:24:39 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8822 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/custom-distribution.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/documentation/dev-manual/custom-distribution.rst b/documentation/dev-manual/custom-distribution.rst index 55854f00e..4dafd2725 100644 --- a/documentation/dev-manual/custom-distribution.rst +++ b/documentation/dev-manual/custom-distribution.rst @@ -3,8 +3,10 @@ Creating Your Own Distribution ****************************** -When you build an image using the Yocto Project and do not alter any -distribution :term:`Metadata`, you are using the Poky distribution. +When you build an image using the Yocto Project and follow the default setup +showcased in :doc:`/dev-manual/start`, you are using the :term:`Poky` reference +distribution. + Poky is explicitly a *reference* distribution for testing and development purposes. It enables most hardware and software features so that they can be tested, but this also means that from a security From patchwork Thu Jan 29 15:23: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: 80022 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 C2A59D6B07A for ; Thu, 29 Jan 2026 15:24:39 +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.17112.1769700270708242204 for ; Thu, 29 Jan 2026 07:24:31 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=Ro7XGHTI; 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 365541A2B0D for ; Thu, 29 Jan 2026 15:24:29 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 0AFF1606FD; Thu, 29 Jan 2026 15:24:29 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 2D26A119A8877; Thu, 29 Jan 2026 16:24:28 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700268; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=bgsowh6WONqjPhmLOwPwAU7mtx2qSZgfCB+zeTafkmM=; b=Ro7XGHTIXQak/etDnfUbOfGRpUwHYPDVrFF4T6fY0fSvYj6pINwSTzGWjjlhdu6HYc53Pq yvmIg8xYChtUDko89GLYlVJMkMBUXZP+3jlKrvHqcq14Y8W1w/Eljs/ihAEOllWR1P6yIH odXiLqE/DBH5zScZQAB/Qy3XYZrLMMtdaGKBFlBIRpIdzwdeiCtFfA2NfChwko1viGXt0J 4Wd20R6sR5QyLVKZgKZFQLSE1xnlmtf0jeB/dWCcQMRJF3VRN7BUYgXYl6ywfKdYfqapJO SNwKyVNnZruxMaYohfwQAEvW9tBK+3JrOpbdMcVinmqrV7HYMuIvtkrwdkQMHg== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:28 +0100 Subject: [PATCH v3 37/57] dev-manual/custom-template-configuration-directory.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-37-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2638; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=rK4hEfFA9Qb4yoPPKJ+Z6dFGd+u62tigKWjRxy6uxgw=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uOP6qRkV4scuwKObvisVaa1T6t9Ss84eJVe PF3nXfYoM6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jgAKCRDRgEFAKaOo NmG7D/4xGHTKmHjvzmxJHWHi7WZC0/vaf626opGab5k8LXiB/Fyek6yyKo60CB+NEzxorrQ8Isl Vg3x1nTpt6ex7+ghrNWVFcdK0KGFDbPwT0tHPmsMvI6Z63nVX6VEKAI5Pr0D8LNRLdOILQDSWn7 KGXrrHuBiFiXQ/e2mJ2/OkWOi0/o2RTDVMkoEAzJVapxSkffMf2zZ4Fk3D5ME6JGdVV9/27Mp21 zFHqbuCRorjHZVLh3JxQ6aLPsVuUtpHyNPSBxwGqlqzGhDtt/Z98+VXaykC0jKvh+37ahj8/jy/ PjUnbFA6KCFIX7DQOkoynOpU3sYJOx2Dvx/0/ozQ3iyXsjOxJshwhlKraG1w6L+2JPEvfziCxdQ ygTI6GTxwp1kuP8yStYIlTsDM2NZ/ACE8jAazglZaSYUdEH2nUPUaFENPrcjDsveAQdA99cW6Gw GQn9xOfDMJbQpXGrZ9jSFQ6ziz7ns0UwoBBjCoR5a9EqStIq/o2VZ1t/2tryM3KHRtgj6+SHabV vEsEg0q6zcT+6YScg1uvdtRumMx+lPibcNhnNc1zQnRJC7hZbASvaMKLiGUF++Kit8/4zvS+1hE /cW4qBF/Fh6JJCf2xdpNOTzpjhixj+XAd7lkn7tLNqat0XIK4mLHMiEJGx14ceR0OvLGcy1sL1J e1zNa+a7G6LQ86w== 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 ; Thu, 29 Jan 2026 15:24:39 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8823 Refresh the document now that the Poky repository is obsolete. Adapt paths to match to encouraged Source Directory layout. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- .../dev-manual/custom-template-configuration-directory.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documentation/dev-manual/custom-template-configuration-directory.rst b/documentation/dev-manual/custom-template-configuration-directory.rst index 06fcada822..8bf763569d 100644 --- a/documentation/dev-manual/custom-template-configuration-directory.rst +++ b/documentation/dev-manual/custom-template-configuration-directory.rst @@ -15,10 +15,10 @@ This can be done by using ``bitbake-layers save-build-conf``:: $ bitbake-layers save-build-conf ../../meta-alex/ test-1 NOTE: Starting bitbake server... - NOTE: Configuration template placed into /srv/work/alex/meta-alex/conf/templates/test-1 - Please review the files in there, and particularly provide a configuration description in /srv/work/alex/meta-alex/conf/templates/test-1/conf-notes.txt + NOTE: Configuration template placed into /srv/bitbake-builds/layers/meta-alex/conf/templates/test-1 + Please review the files in there, and particularly provide a configuration description in /srv/bitbake-builds/meta-alex/conf/templates/test-1/conf-notes.txt You can try out the configuration with - TEMPLATECONF=/srv/work/alex/meta-alex/conf/templates/test-1 . /srv/work/alex/poky/oe-init-build-env build-try-test-1 + TEMPLATECONF=/srv/bitbake-builds/layers/meta-alex/conf/templates/test-1 . /srv/bitbake-builds/layers/openembedded-core/oe-init-build-env build-try-test-1 The above command takes the config files from the currently active :term:`Build Directory` under ``conf``, replaces site-specific paths in ``bblayers.conf`` with ``##OECORE##``-relative paths, and copies @@ -27,7 +27,7 @@ the config files into a specified layer under a specified template name. To use those saved templates as a starting point for a build, users should point to one of them with :term:`TEMPLATECONF` environment variable:: - TEMPLATECONF=/srv/work/alex/meta-alex/conf/templates/test-1 . /srv/work/alex/poky/oe-init-build-env build-try-test-1 + TEMPLATECONF=/srv/bitbake-builds/layers/meta-alex/conf/templates/test-1 . /srv/bitbake-builds/layers/openembedded-core/oe-init-build-env build-try-test-1 The OpenEmbedded build system uses the environment variable :term:`TEMPLATECONF` to locate the directory from which it gathers From patchwork Thu Jan 29 15:23:29 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80021 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 CEF8CD6B07C for ; Thu, 29 Jan 2026 15:24:39 +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.17113.1769700271282561806 for ; Thu, 29 Jan 2026 07:24:31 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=rcV1s897; 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 B886E4E42322; Thu, 29 Jan 2026 15:24:29 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 8EE02606FD; Thu, 29 Jan 2026 15:24:29 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id C7D9A119A8879; Thu, 29 Jan 2026 16:24:28 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700269; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=/y1DwQWWC+bG3sAfBh0BmLJxIsOeierLVS+gu8nlvzk=; b=rcV1s897h+oT/+0ZtMblrFNuTlWZuSIXfYmx4EhSzco/2GBaiVOYyJRIx3NBKhsRqXvgXr vS/GcPfkllMGlZ2/bGDsNfFwp0dDWOJ9g4s34BJoukQoTDsW8j+NfRAB5Cf9pAYttCsMb+ x3obEN04a04j6QhasJbyt+JHHSsISvV5XvfVKSDlu+3vZNrHSep44/5ooti69zqpUb0NIV jt4tZ4S+qRFyiWvAUFpLo8GsGqg8BvxcI5BgHGNupHUJNagx/LGuqeEWyeaypwqtV31Qt/ 8jZ1+/6yfhAhks2IGQIuR+k1wUrCGs0dxXwjOo7hP/a4mm74Clj5A6dmZ1zslg== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:29 +0100 Subject: [PATCH v3 38/57] dev-manual/init-manager.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-38-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1368; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=c6AoTqHAhHK8Oj5u1F4Y5nmJSHQIBaYhOphObOes/Ik=; b=kA0DAAoB0YBBQCmjqDYByyZiAGl7e4+ha1rbe+E9+bGbCtNKJnA9egqMQeUSumE778+WivRYh 4kCMwQAAQoAHRYhBIZIclGI3UAbuaDT/9GAQUApo6g2BQJpe3uPAAoJENGAQUApo6g2rfsP/332 nFdVMrxShSZLQZxSGXNBF3KiS1kXKTw/2oxhOd+wgyJZ91gP88AegnQs/2lazsgU3xxxzu8821V 6tVpIPkqHPvKi3hg1U71JGC7Eur/KquS+SPu0cHW8Cm+Rjv81nS0/Et0+kvXwDdV9JHz5AopYau sg2PbYQexyh7iJz8Adt+9V6ZWZU9ukP1otm8BPaOGxyR6YBcapfEeHno7ynHmdY9jokGN5rAs9Q 88f93ynp37t91CqjKtAww+zbEsU9v64xMfg2cuQP6OyxQ+HtLzfgNbARrWKWggPg2+3Jw++vlb9 5FR0uZYyDhynQLu8CAiemKIRGeq2CF/Tx1Yf6aZRgimJaQE5AuUhAXzKqPlAwXabXXpVRAWbWEu 5McDrHURuIl3wO/0PNH7B9874JDiVlG6Dfbg2upBLypbHHTamcjk2wNLoHETbVG4OK+tYgBO3xP BHnpUq2aOIQNjAP2/tyuM7tBik06PXWUz2FPH78LlbocEe8rP/80pbF+ac8Q6kYLr9qheqWS4m7 BTVEa7vUVKVnXMONVYmTZa0m3DV6NW++AXd0EAqLxEeyMhB8PCjczLx3R57Uxp8jWe6sJr9MTEH LgbIj8IT0MmQenfLMjl5VWuZE9EgZLz2S1hsVcL9UJz8UF0i8K5juI4wElbLdI3+R6PhbUAdKEA RaNGD 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 ; Thu, 29 Jan 2026 15:24:39 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8824 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/init-manager.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/dev-manual/init-manager.rst b/documentation/dev-manual/init-manager.rst index d0fdfdf77..670810310 100644 --- a/documentation/dev-manual/init-manager.rst +++ b/documentation/dev-manual/init-manager.rst @@ -54,7 +54,7 @@ Using SysVinit with udev ========================= SysVinit with the udev device manager corresponds to the -default setting in Poky. This corresponds to setting:: +default setting in :term:`Poky`. This corresponds to setting:: INIT_MANAGER = "sysvinit" @@ -77,8 +77,8 @@ for more complex systems:: INIT_MANAGER = "systemd" This will enable systemd and remove sysvinit components from the image. -See :yocto_git:`meta/conf/distro/include/init-manager-systemd.inc -` for exact +See :oe_git:`meta/conf/distro/include/init-manager-systemd.inc +` for exact details on what this does. Controling systemd from the target command line From patchwork Thu Jan 29 15:23:30 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80025 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 DF33DD6B07E for ; Thu, 29 Jan 2026 15:24:39 +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.17114.1769700272011382561 for ; Thu, 29 Jan 2026 07:24:32 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=DPGgJ7vL; 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 760C24E4231D for ; Thu, 29 Jan 2026 15:24:30 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 49705606FD; Thu, 29 Jan 2026 15:24:30 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 78FE4119A887A; Thu, 29 Jan 2026 16:24:29 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700269; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=D7YoF5GvodqxJqCKX9sEBURwTcBOomTKsSrlvHkNkmQ=; b=DPGgJ7vLleJOdy/+c5JFrk7cVKOqbBgmxc6tSU0+XCUw1QXpqrj4K9mzcyRmbKALLHmN7+ LAhtI8CsBlJ3q5weZMGqYnTSq9pNIhVog7oRZt4Y4uPnBmh2sLa1bJuFVZE/1+Am4nyaI0 XbjeBCBm0t9qaj/Nju3VoZ4+BcZbV1xYe4F6VzdT9boMkh0lLzI4VfddfdYiEblID/Kj8u ulGzwZok5ed9QG9ks1cg8PStVJaCGghHBz3qE+wI0M61gIBqLJ/KugNkwOeku35JCqeRxq kA7OlpG1ckafYfSb+qbTytD1vWQ4kAQ1dgqwfKBXh0SD7j6jK30FHfC49DosNA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:30 +0100 Subject: [PATCH v3 39/57] dev-manual/licenses.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-39-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=3737; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=E05w+ARdEjFDmOU/rWOwAYnufn8soSr2aWcleHHxgX4=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uPQVbOxmDKL1JIVNddSg9HxTUcQxTv+SnUF +VDLizCh8eJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jwAKCRDRgEFAKaOo NhRAEACJQbPO/iD8C3Ro+9PZIXfhV/CHclspgIyzhCcmhkhf60LGV9O95jS7fxFp7pdIcZ7v3e0 5V6j6Lm6TQojM7gcYEL5Go52RLOvOF6Gl5Hv3glHcd5QP5kPcG51ktPSqDbxaBbWrwWgxtUD2wX OM3tp9GMXi8Hduzb+hCqTi8XDDrB6s0x3MKo7ZHAeFil5ZvBnIKLpjg4MpuANe7uvISj4Zl1zk2 f8r/EeMT+i4qwXkgbVVrqQLMfg9wBSXVLBy/x4oPhpo9SfYe84H9ow2+FZZP9uEbXq6hxsGzk1o IxHA6MZF51MCtqpUbqjKr3MZQYmYwsr4RvZrDBjILVDP1ua3dK/W/owxaB5xJvmulzSUTmNH03V L0x6jQkjibb9Bo9sStMju49HxpiZAHZgvXoj3cmTO75ht/H/XAtdopNyUcZKXhnARgvQhw7R1la 18nrI1+gA9Yykj4dNrhZMCZbkMsE0SE5KSAZm4JkHEerPZRkfVWnwNXdjK2ODaTSpSe6I5UumRc ljq9Pnr0NBhyk/8pG/bNWT4rWsvFAeTV4oEsv/fhC9VEQnmJJD8yj9eoeP3/qwyORtpyLxAsaZ6 qRsV5YrDSxFSsq0EtIdbiEg9soKPbBWZoTxJMJ7IFYwwLLPIxGAXk0JYInfdPLhqvLU9QGCeHtY pO4Yih2bhhLAYJg== 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 ; Thu, 29 Jan 2026 15:24:39 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8825 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/licenses.rst | 30 ++++++++++++------------------ 1 file changed, 12 insertions(+), 18 deletions(-) diff --git a/documentation/dev-manual/licenses.rst b/documentation/dev-manual/licenses.rst index 7d6636eef..fff4abb11 100644 --- a/documentation/dev-manual/licenses.rst +++ b/documentation/dev-manual/licenses.rst @@ -112,8 +112,8 @@ commercial or other special licensing requirements. Such requirements are defined on a recipe-by-recipe basis through the :term:`LICENSE_FLAGS` variable definition in the affected recipe. For instance, the -``poky/meta/recipes-multimedia/gstreamer/gst-plugins-ugly`` recipe -contains the following statement:: +``meta/recipes-multimedia/gstreamer/gstreamer1.0-plugins-ugly`` recipe of +:term:`OpenEmbedded-Core (OE-Core)` contains the following statement:: LICENSE_FLAGS = "commercial" @@ -136,7 +136,8 @@ needs to have a matching entry in the global :term:`LICENSE_FLAGS_ACCEPTED` variable, which is a variable typically defined in your ``local.conf`` file. For example, to enable the -``poky/meta/recipes-multimedia/gstreamer/gst-plugins-ugly`` package, you +``meta/recipes-multimedia/gstreamer/gstreamer1.0-plugins-ugly`` package of +:term:`OpenEmbedded-Core (OE-Core)`, you could add either the string "commercial_gst-plugins-ugly" or the more general string "commercial" to :term:`LICENSE_FLAGS_ACCEPTED`. See the ":ref:`dev-manual/licenses:license flag matching`" section for a full @@ -244,7 +245,7 @@ Other Variables Related to Commercial Licenses There are other helpful variables related to commercial license handling, defined in the -``poky/meta/conf/distro/include/default-distrovars.inc`` file:: +``meta/conf/distro/include/default-distrovars.inc`` file in :term:`OpenEmbedded-Core (OE-Core)`:: COMMERCIAL_AUDIO_PLUGINS ?= "" COMMERCIAL_VIDEO_PLUGINS ?= "" @@ -460,22 +461,15 @@ and the source code modifications in one step. If the deployment team has a :ref:`overview-manual/concepts:bsp layer` and a distro layer, and those -those layers are used to patch, compile, package, or modify (in any way) +layers are used to patch, compile, package, or modify (in any way) any open source software included in your released images, you might be required to release those layers under section 3 of GPLv2 or section 1 of GPLv3. One way of doing that is with a clean checkout of the version -of the Yocto Project and layers used during your build. Here is an -example: +of the Yocto Project and layers used during your build. Removing the Git +objects can be done like so: -.. code-block:: shell +.. code-block:: console - # We built using the dunfell branch of the poky repo - $ git clone -b dunfell git://git.yoctoproject.org/poky - $ cd poky - # We built using the release_branch for our layers - $ git clone -b release_branch git://git.mycompany.com/meta-my-bsp-layer - $ git clone -b release_branch git://git.mycompany.com/meta-my-software-layer - # clean up the .git repos $ find . -name ".git" -type d -exec rm -rf {} \; One thing a development organization might want to consider for end-user @@ -494,9 +488,9 @@ automatically:: BBLAYERS ?= " \ ##OEROOT##/meta \ - ##OEROOT##/meta-poky \ - ##OEROOT##/meta-yocto-bsp \ - ##OEROOT##/meta-mylayer \ + ##OEROOT##/../meta-yocto/meta-poky \ + ##OEROOT##/../meta-yocto/meta-yocto-bsp \ + ##OEROOT##/../meta-mylayer \ " Creating and From patchwork Thu Jan 29 15:23:31 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80024 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 EC47DD6B080 for ; Thu, 29 Jan 2026 15:24:39 +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.17115.1769700272519066519 for ; Thu, 29 Jan 2026 07:24:32 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=tj/Zu8z3; 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 08BDE1A2B09 for ; Thu, 29 Jan 2026 15:24:31 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id D40CE606FD; Thu, 29 Jan 2026 15:24:30 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 2697B119A887B; Thu, 29 Jan 2026 16:24:30 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700270; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=JVHAkd1vK7j6uW092t8sXAgAsL7gXq3WUl8+T0wNZeE=; b=tj/Zu8z31Bm/mUBhc6fIYAF9yTOx/MlpocDdjE2Q6vrt5ZIXk1gD4wH1cOHPqAodghFJOY z53tBw0Z8k/BhJd6b7BgGlqzyQF6s5yaWWHYHV4q1EjZCb/yAcXZR2IOQu4QaLOPWN0QeV tZKSudvg5QqHvM8Mq2EpLg2Ljq7DqvFuh6M1LecQbhCjvlDKHVftA8AUc8xQOvHgiBmHmQ Q6/Y3a6ZOGSVIzL0Tsf1WPAe0akgXtWp5SdzxpPTqrO3NowpH9R4saNzXN7Yp6tMg8fTrA 8cN7mCY+9/r2RCJS47f5iN7q7GVdQeO9fId4IHXls11ONzMyyyczBnNsndDMsA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:31 +0100 Subject: [PATCH v3 40/57] dev-manual/licenses.rst: instruct to use git-archive instead of removing .git MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-40-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1362; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=rAWlZShkfs57Y9FF9FS6IBeYULfrOE3o12GLvaqUI8E=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uPilvInU0b0LrkZIN4MBVhGPeFx3DRpsDFw SA7UNm06gCJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jwAKCRDRgEFAKaOo NiLgD/9FElyzaWqLKLdApqF3rFwpbaFubMkNHyI7oyhj7xmDwaUl8CfuRdid1N6AeqVE13UBg6s YlS3awKc6zAbYeO5CXyowj7IfIQh1lr2zWTPrAescYm546s7ZaXUBr94gMMvC5fL3uX7IDUtuDl ef//3rBfcyCYppORMP3V5zXRu0j38OeQvWzlF+VKZdu9KBf8+/SE5kB70rcgeXElgfkCfYV9Fmy roE6DJb90dXZd5Be0puWBKvCKOfYMoI3qMZfuoQ0jclfZFFAZLPazbQfEfn6QIJpkI0vrzsYYfU Jx1twizFjtsCD6Rn12PSw0IuYeZ0qvFOqJdagrnJ9ylOvxe5GEoYl2hMqcnrUWGRMlt2W+6zY6L N/2tLm7T1wooap6OODfwET2TTsT49YblxKhfbfMgYJBgGiDwnKDtWTEoOCfPxfZPGHBwS9F0qTd IcAhYiMk/qKG0sN+XJbbgSrxft8eRSM+x6FOzdVHUkcE40eHKgdhqSaY3Q1NsM849Ky80JBVfzu CVL9rxH3vJEkZo0RAS+xDXFoZgu2PBYviHNcqPgMC+NMUSmxqdWzgwJ2+2s9TPaDc2SWPyCmdsP T5n6qfT9pIIGMFwncbLiRU2Cvz46N4eWZmF6E8odcqL0byyf2Ou/7Iyqvq9ENbXNXN8FxFBp111 GTY9azFvATXtn6w== 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 ; Thu, 29 Jan 2026 15:24:39 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8826 Removing .git directories is destructive. Instruct to use git archive instead. Suggested-by: Quentin Schulz Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/licenses.rst | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/documentation/dev-manual/licenses.rst b/documentation/dev-manual/licenses.rst index fff4abb11..4bc1f7376 100644 --- a/documentation/dev-manual/licenses.rst +++ b/documentation/dev-manual/licenses.rst @@ -465,12 +465,8 @@ layers are used to patch, compile, package, or modify (in any way) any open source software included in your released images, you might be required to release those layers under section 3 of GPLv2 or section 1 of GPLv3. One way of doing that is with a clean checkout of the version -of the Yocto Project and layers used during your build. Removing the Git -objects can be done like so: - -.. code-block:: console - - $ find . -name ".git" -type d -exec rm -rf {} \; +of the Yocto Project and layers used during your build. Archiving a Git +repository can be done with the :manpage:`git-archive ` command. One thing a development organization might want to consider for end-user convenience is to modify From patchwork Thu Jan 29 15:23:32 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80028 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 033E1D6B082 for ; Thu, 29 Jan 2026 15:24:40 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17211.1769700273566995838 for ; Thu, 29 Jan 2026 07:24:33 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=QfjTLxCz; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id E9DC2C22F47 for ; Thu, 29 Jan 2026 15:24:34 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id E8D83606FD; Thu, 29 Jan 2026 15:24:31 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id B787B119A887F; Thu, 29 Jan 2026 16:24:30 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700271; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=2UBbJylCZ6AFW0/ZJ8jSUJjND+uIJ0s4TJURHjXZauQ=; b=QfjTLxCzsvifJgI5q56PHO2WJDm62C/4szNScN6Gq+WDCLPZfkbWBixqgLrUxACq/u0v/f Nc1nQ0dEkoA/3M3O92ya7eJVXd8Ea6sXpZ3Celyslg/roBjMO257VPSGfnMJZtJwvEDILA TrSJTv3IScQkuOyLkeBNvJQzVIXXGESdJ0t9VY3V6zboL0cCk06oE0bUzlZsIn5fpTev7g yusjPXRrySjFMjKV/xvpiSna8c0wl0Vjmyxv8jdRJ9PtueYQJKcmF9qXVYkIoRbMg7DxQq wZjfyAXQtCa8aAnaZYb4Q3oN4Me1CZg1KrRziO5ZHaRcHfcIsoWkboXr9rtfPw== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:32 +0100 Subject: [PATCH v3 41/57] dev-manual/packages.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-41-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2270; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=sipZX5YaKlni2+uWAY++BWh/Et1byo3Re9ZNWo8ouoE=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uPEOF93n1TLUSyhfONTd6KQFvJ8SdZlcT56 k2pgaMg7qiJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jwAKCRDRgEFAKaOo No6+EACkkblNhiC9Xh+rb/mZZ6GuhWUL4wV8ijDh8KDhfj/ZSNx82EeA86DHI5mQYWidplBrolh /hUbSm+MQn7n1FTlBbjim5ffgKm95K/cGoals7SnCNuHYpKyzrlgg95mrjvGrrZNdlD5MhjqlRa e55K7idzBH2qngzNOJM9vANQm71Q8LiXyugtWJ2/2F0ix8kY/G372m8HY4Bl1+bySL1FrxzUEH9 MvGbZFtPP+zBPstTAaPMkxHorvBIuWEKQmoM//2krqe3PUmBnC+/j7Z5e62Csol5J/i8xMVHoOp ANP3HjkgkEDNn4ApXxh1PgkY93TGxMyM9euICrqBzM78ohx+/NvHwefy8kqohGUtULZtoiItgYb C0AZNRi1N/HI3A5qZXxbMaW8ZVYn1mOqk4jo+El4NoNn8xafFQOoDTfeCEx8T2oNeAiSpOTjSxi I0YtcOqp9k0cL8QiOt9++Vtst796qSI/MmyiKPaN1cEQjwNwBt1570/VEzVH9sREzJDgWeSbABu VdbpuXqz2tvSu6vGsdhES2Ci10tHd3iDBdnuH1LnXw2AEXnbQlHmI2U0USUlQdVFN4koSjKKajU WM/gzylEOaJ3rRaHa2vwkHYEXAmOJde/eY+WnQxoliYyquWR3Kj/lmYIZISlfDbtd7n5iewCVsG xKcLUYso/Kf9+CQ== 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 ; Thu, 29 Jan 2026 15:24:40 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8827 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/packages.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/documentation/dev-manual/packages.rst b/documentation/dev-manual/packages.rst index 8bd48c8e8..ebed8f076 100644 --- a/documentation/dev-manual/packages.rst +++ b/documentation/dev-manual/packages.rst @@ -361,8 +361,9 @@ package. It is also perfectly acceptable to call ``do_split_packages`` multiple times if you have more than one set of modules to package. For more examples that show how to use ``do_split_packages``, see the -``connman.inc`` file in the ``meta/recipes-connectivity/connman/`` -directory of the ``poky`` :ref:`source repository `. You can +``connman.inc`` file in the :oe_git:`meta/recipes-connectivity/connman/ +` +directory of :term:`OpenEmbedded-Core (OE-Core)`. You can also find examples in ``meta/classes-recipe/kernel.bbclass``. Here is a reference that shows ``do_split_packages`` mandatory and @@ -543,7 +544,7 @@ to use. In your configuration, you use the variable to specify the format: #. Open the ``local.conf`` file inside your :term:`Build Directory` (e.g. - ``poky/build/conf/local.conf``). + ``bitbake-builds/build/conf/local.conf``). #. Select the desired package format as follows:: @@ -637,10 +638,10 @@ Lighttpd, or Nginx), take the appropriate steps to do so. From within the :term:`Build Directory` where you have built an image based on your packaging choice (i.e. the :term:`PACKAGE_CLASSES` setting), simply start -the server. The following example assumes a :term:`Build Directory` of ``poky/build`` +the server. The following example assumes a :term:`Build Directory` of ``bitbake-builds/build`` and a :term:`PACKAGE_CLASSES` setting of ":ref:`ref-classes-package_rpm`":: - $ cd poky/build/tmp/deploy/rpm + $ cd bitbake-builds/build/tmp/deploy/rpm $ python3 -m http.server Target Setup From patchwork Thu Jan 29 15:23:33 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80015 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 5AF29D6B06A for ; Thu, 29 Jan 2026 15:24:39 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.17116.1769700274319632412 for ; Thu, 29 Jan 2026 07:24:34 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=gJMw94ge; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id AFD8AC22F48 for ; Thu, 29 Jan 2026 15:24:35 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id B1C18606FD; Thu, 29 Jan 2026 15:24:32 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id B54B6119A868D; Thu, 29 Jan 2026 16:24:31 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700272; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=5IR39ciDdraoZJYNxXryGzoBV2whcFBcE1cYu4MPdgo=; b=gJMw94geJfyrzCpsrDMpvtdL/g3Giw/j0J5k/OF/tQCYyHGDrlWYNCz6YDlN1Khmw7LjwT C6J6UGwXHej8UchWwQR/ZH4mYylhcnOJAmO2mY8lHg14ZFGx0jALeJo4QSXIiecWs05Q1H J3zlAPAwsMjocu3+zF5I2uB92jSO+F0R9fQRn3KeO/yiyc5QV5n5arHFtS2TRuKDkwYLoZ ucIUAOCkPwr8//sXTA7eLKZ6yRs23lmaYkLdvDAjStGH5JQqkW8BMFH3IrP3757GgLc4yP /Xf0x7l53iQbtFr0PyRzyUcXGdSSPBNnKjVV/bGJcHowgzhfCVdmQE8U/yz6TA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:33 +0100 Subject: [PATCH v3 42/57] dev-manual/python-development-shell.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-42-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=956; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=O8SpQLw3mlWHN/hVptaP4QFEIzbce0arisg4v88VMiM=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uPCXfZUzkjlHEW2A7cYIYNGF1ggs9uC/PO4 FZO5C9qoK+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jwAKCRDRgEFAKaOo Nu8pEACZqehn5LTSa2F0Efz6UEAJk89uzUpRYein0nT8OKkQURCu6dtq4gKmx5NoHvEKew1iIJS Zuru9r++VwZUPkNgGAMNf3gTetCVrbL5Ow7g2s/Vc3tVMLKRUZQs1ZNaU4PcEirFqdN2DilbNZX RTZw55s27cRxz1RWlbJSk//W6wfXbb3tCMr6LlBlpZNRHAgRq3nIiYuNsVv3ca31gG48KgR85fw IRqYBLFyjr/Bxi4y+RMEUzgRhlZ+MCKPSrEOfTcD2yZKTq+XCsJ+8804FeeW5Y9O9NwO4fN1oqQ GBcrw5wIy4tiU3AzdRksEWPtr6wPM0ssCaPP+UNueUKk4UvpN2VD02pBZuohwFjdO/CruMv+AEH ibcBJeA2ycL7waiX2qjARBmQfJtHzqlmYwrqr5LrxfZ9/JrhV/vI6b2Ia3aoV6aLvv3TT1rU/1B M4d4S/iwg9C5LzZmfzrEbIKA0sftbTQe5bzFNYk3onLbXomCpL9Dg0zZIoG/znWbxdPmcl5iFYy a9A14jV3YxANVUViOGxubP/DG92Hw6jfX2eYb8ursk5oNcCOkyarO6jRgzqeOuatTJt4bbGW26k +pYCujKJPq5oZiggfyLhKeoT9e8X7vU7kGQZ9rDuw3cg+4mQFUQn/KkZUcE4dQJe/MZ+DwP4q4i OoQ0YG/ovGUHrrQ== 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 ; Thu, 29 Jan 2026 15:24:39 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8828 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/python-development-shell.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/dev-manual/python-development-shell.rst b/documentation/dev-manual/python-development-shell.rst index 81a5c43472..0756304323 100644 --- a/documentation/dev-manual/python-development-shell.rst +++ b/documentation/dev-manual/python-development-shell.rst @@ -16,7 +16,7 @@ the following are useful when exploring the data store and running functions:: pydevshell> d.getVar("STAGING_DIR") - '/media/build1/poky/build/tmp/sysroots' + '/media/build1/bitbake-builds/build/tmp/sysroots' pydevshell> d.getVar("STAGING_DIR", False) '${TMPDIR}/sysroots' pydevshell> d.setVar("FOO", "bar") From patchwork Thu Jan 29 15:23:34 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80017 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 74CC5D6B06C for ; Thu, 29 Jan 2026 15:24:39 +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.17117.1769700274942736892 for ; Thu, 29 Jan 2026 07:24:35 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=htUp70eM; 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 5F6224E42322; Thu, 29 Jan 2026 15:24:33 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 35AE7606FD; Thu, 29 Jan 2026 15:24:33 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 7ECF6119A8853; Thu, 29 Jan 2026 16:24:32 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700272; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=iyO4sDwjgpuDnZqHqirXF/WZJNoNQIhf6pTVC0Qg/Ds=; b=htUp70eMzMEGT9z+ufYm+NuzE8DvI5KPKyVS+caLHcUJQKTp/dDgAcmvkqDJZOs5jFPhkS qSfqpcOGqMBFHvPuLwksmSz8smrjEaH/SEI6ezUEtErC9PpO/Y+qyJkemR7P+OaGk8mfS6 TUGGYNVjHG+i6pOCKKQYxYQlA8SaefnHri5AL7UCF4gznqR7kJb161OLUas53V8fXXZZUG 39XbJfv60sA3RWqIIhosNhNR4E8WYVmxjN3nRgzSN4NiiDGlXhB6l+pg9791W30KETy6Tr TNHcrBOIfhqBAjzfB7GtpTeuj3vuyyMdRsymdbBVnfH7OZ7yqXX0Jf8zE9CXbg== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:34 +0100 Subject: [PATCH v3 43/57] dev-manual/qemu.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-43-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1380; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=2XlSNHXthzVEvghh4GejLPwX5nHi3jOAAARDOe3o7lA=; b=kA0DAAoB0YBBQCmjqDYByyZiAGl7e4+gwmZti6EI5Zrb78Tr7vFfRgH+rStRfQZBHe0L8pgsG YkCMwQAAQoAHRYhBIZIclGI3UAbuaDT/9GAQUApo6g2BQJpe3uPAAoJENGAQUApo6g2kpMP/jad YBRr5qzjrjDKPpXl0d6YZcfa1anHTZX7t2TKYUc/qCyWOz4K3/THoBRgutiU16lBTR36xMhA8Ae I7yk+Q0OxFSAS/4LGtCdgjXsOAM7SO+D/9eCyPpuOKT0LfvGCokEoCWW2930L0w1ZUrBGuT9TY3 ikzKYakybtKgg9005yMujqLaFVOJuGlCzbJQqrU2twzRlGw9UHmbN73FsrRIUumdaEjvs4+zmhv 0RJOL+aNelqpomDlWfb0CIsjJsLexs++KRvDfid1u26HukdJRCOmjPsVzrY22S6wxCuQcWtwdBT SwJTmpUbMjKyZjl0ifOd2kvixXp1Uxc42SswghPh8e0eIIYUZfdjXjZrfYvt6bv7WxNnJ/B+18k j2hg8TPkdBuiyIZkOKNreFjhrk3z2cG7m38/1O00IdM3gPQ3lzWplsqAQXgq84O9mUaMl+kZLtl 3J1wTukbpDkz8/LAqpC7IMOud2TJ0ECqSPvWEEBQyceU1HLBaNsK9UKC5vFzlXupO1R7rxcX52F VztgEUiwttSXfR8l0bAJ/xw/hMlZBsXCfL/4CjhiBytKFgvxWf0Ki+BM7dzJBB3u8sGkzuPM1ie X3DtkLbZUd0PZfPJxo5EixtSQ0VFDTfAfgSs9WyR/AsPdghpW6TGnpH9kXpL62y6isVkbK4F7Oi 3+dbZ 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 ; Thu, 29 Jan 2026 15:24:39 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8829 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/qemu.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/documentation/dev-manual/qemu.rst b/documentation/dev-manual/qemu.rst index 442fdced3..e40660a96 100644 --- a/documentation/dev-manual/qemu.rst +++ b/documentation/dev-manual/qemu.rst @@ -53,12 +53,13 @@ available. Follow these general steps to run QEMU: #. *Setting Up the Environment:* How you set up the QEMU environment depends on how you installed QEMU: - - If you cloned the ``poky`` repository or you downloaded and - unpacked a Yocto Project release tarball, you can source the build - environment script (i.e. :ref:`structure-core-script`):: + - If you followed :doc:`/dev-manual/start`, either use ``bitbake-setup`` or source + the environment setup script manually:: - $ cd poky - $ source oe-init-build-env + .. code-block:: console + + $ cd bitbake-builds + $ source layers/openembedded-core/oe-init-build-env - If you installed a cross-toolchain, you can run the script that initializes the toolchain. For example, the following commands run From patchwork Thu Jan 29 15:23:35 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80016 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 8C415D6B06E for ; Thu, 29 Jan 2026 15:24:39 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17213.1769700275814432528 for ; Thu, 29 Jan 2026 07:24:36 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=sJf5oRdC; 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 45D811A2B09 for ; Thu, 29 Jan 2026 15:24:34 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 1C7B7606FD; Thu, 29 Jan 2026 15:24:34 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 13110119A868E; Thu, 29 Jan 2026 16:24:33 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700273; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=7tKBkLuatH9Gz27qVpBEGhM1TMEp3bhA+6cPbBpOUMU=; b=sJf5oRdCvqeN9MoZDeerXHaMOPJXakB0jDrEDZaBgF/hC60Y5LmYuB6MqRHdunYuFlySNb 01KNmZr284CXwmE0J/TFTAOh2qZO1zcFpXyUZRHF6ewqqgA8QpsEn8acHiUQMbEZQP9+ey p7zLjibciJyQb/8nXZLxNVTcF77xcI/U7acrZPRE/3Y0ypvymG2EWReBY5GYWf6AmK4XY0 yCkWBCL3JVtccpWIOQcHXAiEwrmmjt6zR3sTmGsInK0YwZu1trHzhCFz/zcgxflBul7s/P UnRoFUGCQ1WqRkA49ncSUtBEuqnWr0KNjkj5oEHOXcPDfCeJteFCb7DCt7Hlkg== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:35 +0100 Subject: [PATCH v3 44/57] dev-manual/upgrading-recipes.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-44-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=4984; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=zFshia1rd5eji1rAtX8mAvF4Z+ewYPoSDuEEH9v1CYY=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uPAfqoP0AO7EksuUugxBvJEw810hVKf7ilk ZerTbcT+aiJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jwAKCRDRgEFAKaOo NvlPD/9/h3QwCpwLtG2VOtCO57EY22x20njaELd3qTVfZRIUs9AreSMkhDEhHSA5xqfdT/YyaD4 wlyrTl3HoIOo28Rx19VLauAZgoZWKHRXUxev2eCY2gTG36GLuCCvM11Sa1byjJ6/LHuAZVuCBrt ci+jJOgTRyBK/Njg1iTc2vIvn/7qFjdM3XWefRnSv4kpv3sbKC+kSTTWnCNwWDCGThBbLdxyljK H2p8kP8MDwumR0p4qGaBNDxdr0q2TbIR0pJFw1QgwvB6YxBb6PqA9xxrTJYB2cVwwhGRo1dkAf2 +cNc6V1oNSrm9HsgQrEqwZSejgpAlKZi3X0QepU0+3bpBFsqhk565HJVPr6ZvmlqRbaRdttmHuk aB1/o/DYfYMeP+Q5hxFWXafONdP/rOKbQaQIfy8EO+bUdUZdzBHNArxVnzwZk7BcKg9LLC9ET55 cQ0N6aLsUHXk9y+3x9Z+NH6rJdiVfQDCVvivrzNT6Pk4xaEq8yKPYUP+rmX25qX1qRBPHMq3zSJ zG5lEUmX5/Bgjj4bwe4sne3EecjhGcSLVgCgA3OfT1asPeccFO3X8a/KEk8dlZW56XoLZg2xL0H DR5bk2ch5us2AKWEE9n1momDf2rpDWecBJkEV4c32Jtqk16FbZYOGI29TZ4sioOkg3K0lYAoH0O fJnMmo1IMsxsUmg== 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 ; Thu, 29 Jan 2026 15:24:39 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8830 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/upgrading-recipes.rst | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/documentation/dev-manual/upgrading-recipes.rst b/documentation/dev-manual/upgrading-recipes.rst index 2e6567867..c4199d160 100644 --- a/documentation/dev-manual/upgrading-recipes.rst +++ b/documentation/dev-manual/upgrading-recipes.rst @@ -84,12 +84,12 @@ The following steps describe how to set up the AUH utility: AUH is not part of the :term:`OpenEmbedded-Core (OE-Core)` or :term:`Poky` repositories. -#. *Create a Dedicated Build Directory:* Run the :ref:`structure-core-script` +#. *Create a Dedicated Build Directory:* Create a new :term:`bitbake:Setup` with + ``bitbake-setup`` or manually run the :ref:`structure-core-script` script to create a fresh :term:`Build Directory` that you use exclusively for running the AUH utility:: - $ cd poky - $ source oe-init-build-env your_AUH_build_directory + $ source layers/openembedded-core/oe-init-build-env your_AUH_build_directory Re-using an existing :term:`Build Directory` and its configurations is not recommended as existing settings could cause AUH to fail or behave @@ -121,7 +121,7 @@ The following steps describe how to set up the AUH utility: .. note:: - If your distro does not enable by default ptest, which Poky + If your distro does not enable by default ptest, which :term:`Poky` does, you need the following in your ``local.conf`` file:: DISTRO_FEATURES:append = " ptest" @@ -143,7 +143,7 @@ The following steps describe how to set up the AUH utility: described earlier, you must enable it in ``upgrade-helper.conf``. Also, if you are using the default ``maintainers.inc`` file supplied - with Poky and located in ``meta-yocto`` and you do not set a + in :term:`OpenEmbedded-Core (OE-Core)` and you do not set a "maintainers_whitelist" or "global_maintainer_override" in the ``upgrade-helper.conf`` configuration, and you specify "-e all" on the AUH command-line, the utility automatically sends out emails to @@ -263,7 +263,7 @@ directory automatically upgrades the recipe for you:: $ devtool upgrade nano -V 2.9.3 NOTE: Starting bitbake server... - NOTE: Creating workspace layer in /home/scottrif/poky/build/workspace + NOTE: Creating workspace layer in /home/scottrif/bitbake-builds/build/workspace Parsing recipes: 100% |##########################################| Time: 0:00:46 Parsing of 1431 .bb files complete (0 cached, 1431 parsed). 2040 targets, 56 skipped, 0 masked, 0 errors. NOTE: Extracting current version source... @@ -275,8 +275,8 @@ directory automatically upgrades the recipe for you:: NOTE: Executing RunQueue Tasks NOTE: Tasks Summary: Attempted 74 tasks of which 72 didn't need to be rerun and all succeeded. Adding changed files: 100% |#####################################| Time: 0:00:00 - NOTE: Upgraded source extracted to /home/scottrif/poky/build/workspace/sources/nano - NOTE: New recipe is /home/scottrif/poky/build/workspace/recipes/nano/nano_2.9.3.bb + NOTE: Upgraded source extracted to /home/scottrif/bitbake-builds/build/workspace/sources/nano + NOTE: New recipe is /home/scottrif/bitbake-builds/build/workspace/recipes/nano/nano_2.9.3.bb .. note:: @@ -298,7 +298,7 @@ newly upgraded recipe:: . NOTE: Executing SetScene Tasks NOTE: Executing RunQueue Tasks - NOTE: nano: compiling from external source tree /home/scottrif/poky/build/workspace/sources/nano + NOTE: nano: compiling from external source tree /home/scottrif/bitbake-builds/build/workspace/sources/nano NOTE: Tasks Summary: Attempted 520 tasks of which 304 didn't need to be rerun and all succeeded. Within the ``devtool upgrade`` workflow, you can @@ -320,8 +320,8 @@ directory:: NOTE: Adding new patch 0001-nano.bb-Stuff-I-changed-when-upgrading-nano.bb.patch NOTE: Updating recipe nano_2.9.3.bb NOTE: Removing file /home/scottrif/meta-openembedded/meta-oe/recipes-support/nano/nano_2.7.4.bb - NOTE: Moving recipe file to /home/scottrif/meta-openembedded/meta-oe/recipes-support/nano - NOTE: Leaving source tree /home/scottrif/poky/build/workspace/sources/nano as-is; if you no longer need it then please delete it manually + NOTE: Moving recipe file to /home/scottrif/layers/meta-openembedded/meta-oe/recipes-support/nano + NOTE: Leaving source tree /home/scottrif/bitbake-builds/build/workspace/sources/nano as-is; if you no longer need it then please delete it manually Using the ``devtool finish`` command cleans up the workspace and creates a patch From patchwork Thu Jan 29 15:23:36 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80019 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 92F96D6B070 for ; Thu, 29 Jan 2026 15:24:39 +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.17214.1769700276531006050 for ; Thu, 29 Jan 2026 07:24:36 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=GhrRg3Ro; 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 C375E4E42324 for ; Thu, 29 Jan 2026 15:24:34 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 99B40606FD; Thu, 29 Jan 2026 15:24:34 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id E9E4D119A8859; Thu, 29 Jan 2026 16:24:33 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700274; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=51hlssbdk6z4aDjQITX+mr52V7HdyGRhoNWHuosCwVM=; b=GhrRg3RorKZtZv+fSTHl7HzedtR7wOZi7LCok7E+4NKFTdDmTt/ou3lkhc3aDxaw8yMcNl CAEuWwbffXJjGyO30067WSosGS9TAdyQefd1KnH2M4YGhlgHtx+lBkt5ySR/JFaKxSWaEc UgID65B+Kgo7mNh9ajrkQNYVCymMny6pL4UOMS/X82uLfuLO19UkfRfbiez1orLZQzxVCI GbZ2YbW2489vtEz7d0PvbixN3NTVaNNE4dyDkzSk0P0sKdcTk3xX+/o3J/CimiTRshytDW ZTabTkwGILAHROZ+/HLVkOxjHhFXpZ/B6q62/D+YZKM1wFTKb6bRvO6gdGulEg== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:36 +0100 Subject: [PATCH v3 45/57] dev-manual/upgrading-recipes.rst: move meta-openembedded to bitbake-builds/layers MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-45-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2330; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=dbjj41ktIjBQKPmhJl4Bhakgn4vVZ3r2fteBBZYFCVg=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uQnkFBh/ATBWz38+ESve2Fcwj8gDQNQAQQA lYs1Dvw+pmJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7kAAKCRDRgEFAKaOo NpIBD/0VTo/rbwsKxOeMmEyOZQkcbuY0hZ9/RSd9LrdE3zxQUtO4crwqiS9k5lvVUp4024m0EX3 +JSQNul9S5Zeh3anhvvLfUxFej1CeC1J79+jT6d2O3zmJC5jtHKeHi1X3l/n1Jti3u33cuyE2S0 S3TjfJddIkuZGziSFPgGmN1OueYLqoAmwtnzskeHjDOLYfdKlI3SOnxX0vlfcwEXbuSY9LwISMa tm3GC5RK4Jg0803gp12tYz20/ubY11tPgpL4zwNbVFTwsobazyL6McvZx69pp0jDEQ0gCznMDkQ TJ6sOHpVP9swiWjbcrBu/oJRgUDjwtMqWZyh8/XoiHp61LSEftcsFlxJ4sUfZ1GJXs5dtcPVN3y FQP+shjY7e6IaTrPOS3CIYHGjtSyS2ksnWibdTQvwnjazXPH8OIVARBPAW2yoaCc3k0hnhfzSB4 Q/dXRKeqnLl8ejmZCH/mw8IzzHuJHtU41c3Dcuj5a2L0gqra+A06eFnJv1xutZhtLn+yygkVetx 0M8VmbXyVb8MC8EM37CTc2RTup5BiWJKkwe5FVNPyNHhz8JVeQqi0b8uluwGjMQvPhDrZlO+bpI dKBWWcjcbMq7nM78bQuTJJ+GokTKOs+4C50rp5DUwZ9GdDw8HtCo6Dhm/rzTsmqd1HRKYBpJsNy Z/png6AVxyK3OLw== 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 ; Thu, 29 Jan 2026 15:24:39 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8831 It makes more sense as we expect the layout to be that way. Suggested-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/dev-manual/upgrading-recipes.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documentation/dev-manual/upgrading-recipes.rst b/documentation/dev-manual/upgrading-recipes.rst index c4199d160..01fd12d86 100644 --- a/documentation/dev-manual/upgrading-recipes.rst +++ b/documentation/dev-manual/upgrading-recipes.rst @@ -242,12 +242,12 @@ script. For example, suppose you use the ``nano.bb`` recipe from the ``meta-oe`` layer in the ``meta-openembedded`` repository. For this example, assume that the layer has been cloned into following area:: - /home/scottrif/meta-openembedded + /home/scottrif/bitbake-builds/layers/meta-openembedded The following command from your :term:`Build Directory` adds the layer to your build configuration (i.e. ``${BUILDDIR}/conf/bblayers.conf``):: - $ bitbake-layers add-layer /home/scottrif/meta-openembedded/meta-oe + $ bitbake-layers add-layer /home/scottrif/bitbake-builds/layers/meta-openembedded/meta-oe NOTE: Starting bitbake server... Parsing recipes: 100% |##########################################| Time: 0:00:55 Parsing of 1431 .bb files complete (0 cached, 1431 parsed). 2040 targets, 56 skipped, 0 masked, 0 errors. @@ -319,8 +319,8 @@ directory:: Parsing of 1432 .bb files complete (1431 cached, 1 parsed). 2041 targets, 56 skipped, 0 masked, 0 errors. NOTE: Adding new patch 0001-nano.bb-Stuff-I-changed-when-upgrading-nano.bb.patch NOTE: Updating recipe nano_2.9.3.bb - NOTE: Removing file /home/scottrif/meta-openembedded/meta-oe/recipes-support/nano/nano_2.7.4.bb - NOTE: Moving recipe file to /home/scottrif/layers/meta-openembedded/meta-oe/recipes-support/nano + NOTE: Removing file /home/scottrif/bitbake-builds/layers/meta-openembedded/meta-oe/recipes-support/nano/nano_2.7.4.bb + NOTE: Moving recipe file to /home/scottrif/bitbake-builds/layers/meta-openembedded/meta-oe/recipes-support/nano NOTE: Leaving source tree /home/scottrif/bitbake-builds/build/workspace/sources/nano as-is; if you no longer need it then please delete it manually From patchwork Thu Jan 29 15:23:37 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80026 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 AB1E1D6B071 for ; Thu, 29 Jan 2026 15:24:39 +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.17215.1769700276968699879 for ; Thu, 29 Jan 2026 07:24:37 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=f/A5+uDe; 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 683F24E42322 for ; Thu, 29 Jan 2026 15:24:35 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 3FA88606FD; Thu, 29 Jan 2026 15:24:35 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 7B217119A8856; Thu, 29 Jan 2026 16:24:34 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700274; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=NbBQDqVcJofKnsIcaVkx8Yq0qiiKoWiu8OXYq2PiHmg=; b=f/A5+uDetNIjVXnNmX4NqtFRjHlBJhXq+nom/7C8aiTalxS60rTq+Yjh3VeN2BNGNXH3HE UYTyYPejw3y984jp3T3w5es9uaQO6KORg2/d+7GHaS0lpsN2wEfW9IgUXFxx+0KjfYrj4x MQhl2YsC5zr6UG90qcMrKkyztwIjiaSxycNIn5E0kqaNWN4ddxA8XsbKBggjnnhfhAjJ40 2kilhDqaYmgVOLoPjaoGMB2jxiDoXL6zoTsvXunCjnmvKOMIHPdhAqVRPg2n90L21WL0Ro cG4QcSrq21iz36PzhKPq+hUa2PLbo7U5rrchnI3Gky7pJrxJei273o8bLKduhA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:37 +0100 Subject: [PATCH v3 46/57] dev-manual/vulnerabilities.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-46-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=4535; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=qD3kgbCnsEgdJ/A4v81lbnSaHjsMPVtzRdWrSsYOA/I=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uQad+4z2sMt7HjLXguRx3suuRGObsFCgt6a o74so4SHB2JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7kAAKCRDRgEFAKaOo NnpqD/9bo+hSBZBPFWZvJVbusx9AZz6GwmKmkA1WWmYffft6y2AUnuhbLQBoNBLmfcWETQlgma4 l3e9e1bfbdiiBhbOnFyFy6mcylx3DOMAx7nVFzdbOwsccmfExJw31/tRxzkppFA4f7bgBi1v7n9 B2h9gzTRcD4gGCNZBXhQR3iYjQ73v/prD8jq/Wp21wjBmxARajXAuMTb+xYe7YFKCJ50taT5NcG whWDX7nQArVbFpkFujY+PWnCzgZyUkqiyf3yzQVnXl2F567S8cJu68hsLA1YFLaCf6ODJwXN7m9 PNpi/NK96+07ehWXAotpnEaa2+Hk2sGLfje2XDlwUl22ncMI8WXCGHPvth9ZLml9BmY1prsC0Cr FKqxIq/zu+l6k+FRwqVk9sPUArlvzVBESKDPxIyIGrewWLE5QLz6MiFjdQHscWdWv/16JpRMcxv YwR/afU/ZVJV9/Xe3eS3e6iBOLuH9sDM8v42lLql2iMkD3SR83Zw6b7tmka5MOZVaqFWEc+QNGW KtXkhripuMMOR9Faj8q26pGTu6BsSPc0OJlSaduwJJV44rKmpMBACGN8M3mvLJyofUjYZ/QWecD 6K2ZumRgAfP0Zg3dpe7SyMWQ6dcT5KymbQNDpLCOsZHa7sJ0NGoGFWmrqDTmk8PzaYx7Higfu+X bdnCde+ahLhW0JA== 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 ; Thu, 29 Jan 2026 15:24:39 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8832 Refresh the document now that the Poky repository is obsolete. Mention that only vulnerabilities in OpenEmbedded-Core are tracked as that's where the packages are. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/security-manual/vulnerabilities.rst | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/documentation/security-manual/vulnerabilities.rst b/documentation/security-manual/vulnerabilities.rst index 6eaf75758..e6135a525 100644 --- a/documentation/security-manual/vulnerabilities.rst +++ b/documentation/security-manual/vulnerabilities.rst @@ -3,8 +3,8 @@ Checking for Vulnerabilities **************************** -Vulnerabilities in Poky and OE-Core -=================================== +Vulnerabilities in OpenEmbedded-Core (OE-Core) +============================================== The Yocto Project has an infrastructure to track and address unfixed known security vulnerabilities, as tracked by the public @@ -13,15 +13,15 @@ database. The Yocto Project maintains a `list of known vulnerabilities `__ -for packages in Poky and OE-Core, tracking the evolution of the number of +for packages in :term:`OpenEmbedded-Core (OE-Core)`, tracking the evolution of the number of unpatched CVEs and the status of patches. Such information is available for the current development version and for each supported release. Security is a process, not a product, and thus at any time, a number of security -issues may be impacting Poky and OE-Core. It is up to the maintainers, users, +issues may be impacting :term:`OpenEmbedded-Core (OE-Core)`. It is up to the maintainers, users, contributors and anyone interested in the issues to investigate and possibly fix them by updating software components to newer versions or by applying patches to address them. -It is recommended to work with Poky and OE-Core upstream maintainers and submit +It is recommended to work with :term:`OpenEmbedded-Core (OE-Core)` upstream maintainers and submit patches to fix them, see ":doc:`/contributor-guide/submit-changes`" for details. Vulnerability check at build time @@ -34,7 +34,7 @@ add the following setting to your configuration:: INHERIT += "cve-check" The CVE database contains some old incomplete entries which have been -deemed not to impact Poky or OE-Core. These CVE entries can be excluded from the +deemed not to impact :term:`OpenEmbedded-Core (OE-Core)`. These CVE entries can be excluded from the check using build configuration:: include conf/distro/include/cve-extra-exclusions.inc @@ -167,7 +167,7 @@ the :term:`CVE_VERSION` variable. Note that if the CVE entries in the NVD database contain bugs or have missing or incomplete information, it is recommended to fix the information there directly instead of working -around the issues possibly for a long time in Poky and OE-Core side recipes. Feedback to +around the issues possibly for a long time in :term:`OpenEmbedded-Core (OE-Core)` side recipes. Feedback to NVD about CVE entries can be provided through the `NVD contact form `__. Fixing vulnerabilities in recipes @@ -175,7 +175,7 @@ Fixing vulnerabilities in recipes Suppose a CVE security issue impacts a software component. In that case, it can be fixed by updating to a newer version, by applying a patch, or by marking it -as patched via :term:`CVE_STATUS` variable flag. For Poky and OE-Core master +as patched via :term:`CVE_STATUS` variable flag. For OE-Core master branches, updating to a more recent software component release with fixes is the best option, but patches can be applied if releases are not yet available. @@ -276,8 +276,8 @@ The entry should have the format like:: CVE_STATUS[CVE-2016-10642] = "cpe-incorrect: This is specific to the npm package that installs cmake, so isn't relevant to OpenEmbedded" As mentioned previously, if data in the CVE database is wrong, it is recommended -to fix those issues in the CVE database (NVD in the case of OE-core and Poky) -directly. +to fix those issues in the CVE database (NVD in the case of +:term:`OpenEmbedded-Core (OE-Core)`) directly. Note that if there are many CVEs with the same status and reason, those can be shared by using the :term:`CVE_STATUS_GROUPS` variable. From patchwork Thu Jan 29 15:23:38 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80020 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 B5ED3D6B076 for ; Thu, 29 Jan 2026 15:24:39 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.17118.1769700277591879057 for ; Thu, 29 Jan 2026 07:24:37 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=Lsiy6N9o; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id F40A3C22F48 for ; Thu, 29 Jan 2026 15:24:38 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id F366A606FD; Thu, 29 Jan 2026 15:24:35 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 322C7119A868D; Thu, 29 Jan 2026 16:24:35 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700275; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=hKE6HB7aYaQaJ2IAafNrZUmTeBp03N16vkYYMxNa2TE=; b=Lsiy6N9oNpYaVvqf4pErslna3giKQYsA1Itz43Mc+8Xz7LpunpZZbCSHi7DRXnU80jTDgE 9zRBkU/RQ5/mYL4gtX7M5Avy3abfMrECq1yM1Z7Nb0HMAQ6ut13wjXwAUpXxQ+Gby58BWy i5f1m2Brc8DVIVhcoq3QapUmCcle/JahprbeWAljPpvvAu+JIhJ5HfSW6JzWPg3ctLJzpZ 5qE8oYLEAYMvGOh9jPAEV1zsQRIdcncggo2VlAubvK3LHUqLKnfFE+dBzJXLpxGjx4TPzk PIa9avgk5AuJLRb8PgtDYykd+pkefjQAInbeibekKaPq0ZyeT+dAwTy1UG0+5A== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:38 +0100 Subject: [PATCH v3 47/57] ref-manual/devtool-reference.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-47-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2733; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=O1d1vrrLrjx45L1rC17Pkv8av6MfKUXVpV2snsBEALk=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uQJPBm+hZF2XvI8/3ZFo+LXl8OvBUPxQ7uT ffDy+MumIGJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7kAAKCRDRgEFAKaOo Nj5JD/9wAmWUYILJ0UF4P7zajJF/NeyfFTDwWH/sbJysSGxcEaRJSwSfnDkeb7ncNenvK9B8ROa /4H0Sztq/yOuALr7eX2vlAvDFm6bn1nQOFcm06TZWsIAH3Dl2rufa1IJ4IKnwFbbo9zGWHLHaoV UI2xrBuGHN5+VjKQa5S2qoYKY9HKjjcqjtPXF1gFLuYPtCTH+vTmatYGwpszMx/vWW8uXbqwtGl e8rr27knswlrky0jOT65WRpnIPYsWOl1N+jjL6MjWta/OFYABI/df/ksbvHXjrkku8POalIgfRT c8+HLNCap5zGhsCY7wAH7P+Y4F3UVZuPpr03LtfTfWGLoO4t3h1BTiTMaeuTCRMddqKfTtPqb4y 4AjA1hXOzf2pRREuxTk3dSqJP2kB1E5ZqajuayhgpwGcaG7JjGhRwYVSv5nk5REQ/EBI0nwz6S6 Knl2u0maj0QAhWAQ9dMb+XTksJ9YkvQnIhB3g96ubPe4PUWrXU7NheCz+EwIrvOY4ZdiXOlAqPT hqjtW4n9P9PKkWzEvo1/tar9KZQOko1j559rwW6/aks+76cDqPwLtlCxY8PCfs3okmtVjK91Zho tPAGKG5fY9GTDTim4Ged6Hcyrc+iMefG87V6HbcGb0iJCVYTfIZyBv4m5sx+XWLTFdKk8QsswIu UENXQUZyD0V5s9Q== 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 ; Thu, 29 Jan 2026 15:24:39 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8833 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/ref-manual/devtool-reference.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/documentation/ref-manual/devtool-reference.rst b/documentation/ref-manual/devtool-reference.rst index 5ac567591..863825b06 100644 --- a/documentation/ref-manual/devtool-reference.rst +++ b/documentation/ref-manual/devtool-reference.rst @@ -346,7 +346,7 @@ variables in package recipes. mechanisms cannot find the new upstream versions. - For the ``oe-core`` layer, recipe maintainers come from the - :yocto_git:`maintainers.inc ` + :oe_git:`maintainers.inc ` file. - If the recipe is using the :ref:`bitbake-user-manual/bitbake-user-manual-fetching:git fetcher (\`\`git://\`\`)` @@ -390,8 +390,8 @@ In this example, while a new version is available upstream, you do not want to use it because the dependency on ``cdebconf`` is not easily satisfied. Maintainers can explicit the reason that is shown by adding the :term:`RECIPE_NO_UPDATE_REASON` variable to the corresponding recipe. -See :yocto_git:`base-passwd.bb ` -for an example:: +See the :oe_git:`base-passwd_*.bb ` +recipe for an example:: RECIPE_NO_UPDATE_REASON = "Version 3.5.38 requires cdebconf for update-passwd utility" @@ -460,7 +460,7 @@ Here is an example that resets the workspace directory that contains the $ devtool reset mtr NOTE: Cleaning sysroot for recipe mtr... - NOTE: Leaving source tree /home/scottrif/poky/build/workspace/sources/mtr as-is; if you no longer need it then please delete it manually + NOTE: Leaving source tree /home/scottrif/bitbake-builds/build/workspace/sources/mtr as-is; if you no longer need it then please delete it manually $ .. _devtool-finish-working-on-a-recipe: @@ -633,7 +633,7 @@ Here is sample output after using to create and add the ``mtr_0.86.bb`` recipe to the ``workspace`` directory:: $ devtool status - mtr:/home/scottrif/poky/build/workspace/sources/mtr (/home/scottrif/poky/build/workspace/recipes/mtr/mtr_0.86.bb) + mtr:/home/scottrif/bitbake-builds/build/workspace/sources/mtr (/home/scottrif/bitbake-builds/build/workspace/recipes/mtr/mtr_0.86.bb) $ .. _devtool-search-for-available-target-recipes: From patchwork Thu Jan 29 15:23:39 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80023 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 C269FD6B079 for ; Thu, 29 Jan 2026 15:24:39 +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.17119.1769700278401421848 for ; Thu, 29 Jan 2026 07:24:38 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=jYKYwfce; 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 D649F4E4231D; Thu, 29 Jan 2026 15:24:36 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id AE046606FD; Thu, 29 Jan 2026 15:24:36 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id B604D119A885C; Thu, 29 Jan 2026 16:24:35 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700276; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=DAwbHrETQg9C866NThUeQRmVaj1oDZel9ip743aLLAs=; b=jYKYwfcedUzTa9qp3EOCIVOCJIu5FIUh+DmwIbd8NSRjIdJHfoHSEa1o1lceDNGf4VWctt EzJeR/jQu2lW11mL0vce+ZvHg/G0NF7ZHYNoLB3HJafhuwAGHQMVzfs25aadpxxEuSHErE TjZ6f6mRqcMrqmLqRTJz7R2IXHtsV0lwJF8vzMYwNRm2ExZuKs6NCtOxXGrtguRB20KGSz AcnIA6NfTbNOkR73Rbsll0vkn869RQjd2cjXOv1Qewo9hYq1sMIi2xpQOWYSeuQbZzRt9C iybC1j9g/oQ+g6Lz9t+su/5uNOqEPfCyEL5/6lCLHJxGPW5a9uPYift/Ke6MTA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:39 +0100 Subject: [PATCH v3 48/57] ref-manual/faq.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-48-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=4080; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=fgSozbuMk5pp6FhUaD4XKBFSxHo95R5P6zUbmhVpZ2k=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uQta973VhwHHeTXyI0pB8R3YrjFqNP0YZpu uA8OjlDnU6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7kAAKCRDRgEFAKaOo No6OD/9G3YiV7pNsAkI/A33Ket9BRbb0pCJaRy1rhQTs8yz2Fo3MECBQpWMzSq5NVtUY1OH/fkY HRZNA90++uYdq+ObM3JVlfQFjmot8XJ75+frYUsooDeAtl7DGpvFsRQhYsRBeXiwDO2lCFEmW0Y pySgT18eSgeRzgTesirWSY0snIa2PZ39BSQ5lx1pmD/R/E83r3TZbsn+9SqFTHHFZiKpy4oCRzd KPrdfM1AeubGWGdGGXAH/rElxPa6dGDk8TENj+INShC8TDzzS1OYppHB56LdJmPCCVjLGVGb5dg 6GNAwYmJIqvKdGLofc3oajrNcwR8E0b9olRRg0WNUS0CW2My7LN3uhGq48qDMSULxSxzYn2TjKn kh2RJUPycmADWPHBCepeSnPb13DhIxCqC/IgmZrA86MucfZYCKbdqqyhSAxXDKKkiswTWtxNVjo syMYvsL8fLGSi9DOdzGkxscDaWL/O/9pyhOVRpwlkz/ni639IZl0Kw4HYiXlZ5m+Fl8ex1UqupP u2HNkTBKN1NaWlwj4hPYKUPpPYo3G92D0rhlDWgw+aP04JWaXAOdZUy8A5n5kZ6MER4LbuWcSLq 8Q/Gek0t7ROeG99GSfo68jNCZBDxmWwLJxcl7LJvd56tSWnJFq/el5aACUlrzhyArkjPeDWyXnn olgwhikcaJAR2oA== 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 ; Thu, 29 Jan 2026 15:24:39 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8834 Refresh the document now that the Poky repository is obsolete. Rework the difference between Poky and OpenEmbedded. Copy the note from terms.rst regarding the now obsolete Poky repository. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/ref-manual/faq.rst | 45 +++++++++++++++++++++++++++++----------- 1 file changed, 33 insertions(+), 12 deletions(-) diff --git a/documentation/ref-manual/faq.rst b/documentation/ref-manual/faq.rst index 6c5b9d4e7..152fbf7b2 100644 --- a/documentation/ref-manual/faq.rst +++ b/documentation/ref-manual/faq.rst @@ -12,14 +12,35 @@ General questions How does Poky differ from OpenEmbedded? --------------------------------------- -The term ``Poky`` refers to the specific reference build -system that the Yocto Project provides. Poky is based on -:term:`OpenEmbedded-Core (OE-Core)` and :term:`BitBake`. Thus, the -generic term used here for the build system is the "OpenEmbedded build -system." Development in the Yocto Project using Poky is closely tied to -OpenEmbedded, with changes always being merged to OE-Core or BitBake -first before being pulled back into Poky. This practice benefits both -projects immediately. +The term :term:`Poky` refers to the reference distribution that the Yocto +Project provides, and a reference test configuration. + +The :term:`Poky` distribution is built using the :term:`OpenEmbedded Build +System` and :term:`BitBake`. The :term:`metadata` involved to build the +:term:`Poky` reference distribution is: + +- :term:`OpenEmbedded-Core (OE-Core)`, which is hosted at + :oe_git:`/openembedded-core`. + +- :yocto_git:`meta-poky `, which defines the + ``poky`` distro configuration file (:term:`DISTRO`). + +.. note:: + + Poky also used to be a repository containing the combination of + :term:`BitBake`, :term:`OpenEmbedded-Core (OE-Core)`, the + :yocto_git:`meta-yocto ` repository and the Yocto Project + documentation -- which were combined with the :yocto_git:`combo-layer + ` tool. + + This repository is still hosted at :yocto_git:`/poky` and is still + updated for maintained releases that are older than Whinlatter (5.3). + Newer releases now use ``bitbake-setup`` to clone and setup the initial + :term:`OpenEmbedded Build System` environment. For more information on + how to use ``bitbake-setup``, see the :doc:`/brief-yoctoprojectqs/index` + document. An alternative can be to setup the above repositories + manually, by following the :doc:`/dev-manual/poky-manual-setup` + section of the Yocto Project Development Tasks Manual. How can you claim Poky / OpenEmbedded-Core is stable? ----------------------------------------------------- @@ -27,7 +48,7 @@ How can you claim Poky / OpenEmbedded-Core is stable? There are three areas that help with stability; - The Yocto Project team keeps :term:`OpenEmbedded-Core (OE-Core)` small and - focused, containing around 830 recipes as opposed to the thousands + focused, containing around a thousand recipes as opposed to the thousands available in other OpenEmbedded community layers. Keeping it small makes it easy to test and maintain. @@ -87,9 +108,9 @@ configurable. You can setup the build system to get source code in most environments if HTTP transport is available. When the build system searches for source code, it first tries the local -download directory. If that location fails, Poky tries -:term:`PREMIRRORS`, the upstream source, and then -:term:`MIRRORS` in that order. +download directory (:term:`DL_DIR`). If that location fails, the :term:`OpenEmbedded Build +System` tries :term:`PREMIRRORS`, the upstream source (specified in +:term:`SRC_URI`), and then :term:`MIRRORS` in that order. Assuming your distribution is "poky", the OpenEmbedded build system uses the Yocto Project source :term:`PREMIRRORS` by default for SCM-based From patchwork Thu Jan 29 15:23:40 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80029 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 0AB59D6B084 for ; Thu, 29 Jan 2026 15:24:40 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17217.1769700279185777431 for ; Thu, 29 Jan 2026 07:24:39 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=jEG6RRhC; 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 A86F51A2B09 for ; Thu, 29 Jan 2026 15:24:37 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 77727606FD; Thu, 29 Jan 2026 15:24:37 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 8F899119A885E; Thu, 29 Jan 2026 16:24:36 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700276; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=vXg/YNLP+LfPpBXis64lD1mq8jE7D6DzEyqc3na0N78=; b=jEG6RRhCBdrqwkLtHikqo//t6DL8fPSKRIXTUD3ltpqjcwM0q+73Q3k9AaV5Y/+8VEk3ng y+FrLqYPMpOcvl4TGekZ6G8a1RFqa221nt+N4pzyvIFMBU7cwgkTo7zHhixarb3oU7tE2w sBAopRFKTwhLsDd3Sulxvmh4KhpImakM3DertDzeLLhLCJJJ2LoEUHdrFXBNIazaFU4tAU eIfRYewLNyqVC3VdB2402un86dVPCQOYI75+7dQC6fZnJ5QEQUydF1KAc91wWDV13jx6eJ hDDOLLiPtXBgRdOSBKroq+2ZqMYZOm27uSKZD4cxFXiYHvAgt0qhgkx63fZMEA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:40 +0100 Subject: [PATCH v3 49/57] ref-manual/features.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-49-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=822; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=quxuJjtWCjod5/wBUuxChFeGb5cBaQ/2ABBmIzb9dp4=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uQV3GOfHUkQaB/9nk5/SYHdW4Q6un3Dc8Mp 8/VGHu4N8KJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7kAAKCRDRgEFAKaOo Nla0D/0RbL71/BAvjyI48tFPs3erIaOKCKOZ1AhhGfHmFXDMpSBBwbs/JE7d9LyHkEMcWFI1iAQ b3P3gwr5K8PK/EvvSy3MRTSCUX95HhP+Dj1FKhiiyQKgsT4HW01vWjxxxb9IP970R+JZDRXJ/OR Mh8x0k2kXddQTdwg1cNXU+xevZ4dr20+xiiPEZTSGyo8kMovoFgcaqmrag7+rpm/L0xz0nNqZ8j qoxU+yPVRwc2nvhCDiohxgVdYhw8UULpkEHSpfJmieKz1v8QthI68XehhPFlVcLzUXSkRxyzndC WhjdkBOB6Yh4W2tPOKZBK910eb/KXMXa+K0lZdzUmTciCjSUzWP4R/eCQ51vKJGsk2LorvfWW6Q 6zVmv5t/YOMqCZh22YDhTOHqmvTtvGWX7qYXFXetKcSUB5fhMni4TfJbHcqyhrUnCK5lvrSv9uK ZPfrwFLrRA1PTpWLMrJ8laNVuYb0RqFJ6oWNoxyA9WLzVJZoq8f1BpafojVA4nT9FWoxJblRh3Z suCg5ny6VYEd/M44ZABqkXAvOc/p7sFdiT+WAX7Hc8IactLoZtm2SDILQOUUItMdvII5iVfmkwE eduy0eJe8yFWZqB9RGbtcvCG5vqPsj59wNKenbRwtkFwuA2lq+nS0PR1wovZxfZJFHRnMnM5gjo Y5qGF6g153/Z0Bw== 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 ; Thu, 29 Jan 2026 15:24:40 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8835 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/ref-manual/features.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/ref-manual/features.rst b/documentation/ref-manual/features.rst index df3783089..be67bc0ea 100644 --- a/documentation/ref-manual/features.rst +++ b/documentation/ref-manual/features.rst @@ -28,7 +28,7 @@ a particular feature is contained or not is to ``grep`` through the discovers the recipes whose build is potentially changed based on a given feature:: - $ cd poky + $ cd openembedded-core $ git grep 'contains.*MACHINE_FEATURES.*feature' .. _ref-features-machine: From patchwork Thu Jan 29 15:23:41 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80027 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 15E43D6B086 for ; Thu, 29 Jan 2026 15:24:40 +0000 (UTC) Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17218.1769700279502703035 for ; Thu, 29 Jan 2026 07:24:39 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=wt7Bw/7z; 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 034C81A2B0C for ; Thu, 29 Jan 2026 15:24:38 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id CE5D2606FD; Thu, 29 Jan 2026 15:24:37 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 1F72F119A8860; Thu, 29 Jan 2026 16:24:37 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700277; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=3kq3+hxUz9p3CM01s0RFmZ26oyNeHO2PGj/RGKNndIM=; b=wt7Bw/7zbCEYLjRB7CawDQwlzhpEu/YZNL5b9x4zR3YmlJVT6pDDM3XkRQQnMhQjhvTsOD dm++E1ZxexFNRlnN9tjI+o88NkBt8qCY9RAg5uVTD39k/IhyQy3+hhR1lr7mow7mWENw4d 4sL/c99AdlwESR3pNsOsKJVhQsQqOITTcZDY7urC8jtsd1tAfRxvvKN9Yzi9mvXD7H1ijH FeS3hxJPjjQ8okeG2AbO4wT1EBozAm1nX8JvYo10MboTZ53joZGpNVXzyhjKiW0fDHCLts +vQxwOmfPcaMG1CLFU99GXC/TpGguR062ZVIIvjsz1sp1z81UHUiUNVGinvOwQ== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:41 +0100 Subject: [PATCH v3 50/57] ref-manual/release-process.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-50-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1348; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=Wkw2SsfG2gNRHNKJEpXPri1B77tA5W47J/yvdfZmNc4=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uQem7vaAbcZ57Eu28kwaJbqJBrR6nRlzzcg TlT9h4oGZGJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7kAAKCRDRgEFAKaOo Nr++D/wOL8cDnLDOmq18DEdaLb65QjnfDETBkhXmC8ZoMa6O2jQOcTL9gr8MoVPhq5xb7h+4NR2 dSXV0j8gnMi8M7v8AKgOP1fUyu/5vOxrSpzJuPPHcRosL3RZy+Re8i15468M2AETGLPugnWqYab JUltOzzdPD+dVo/k78j2oGrqSCAx9LO4TYICZ1C14mGlpl10Nc5UHclChfHILwK16EAX0VpcYwF ue7sH2IsZsGFWxyOZWcgLdWAGM9WwLMbVD9gGFf8vkwPY8iozqeolAh6u7yUiCeDK7ZYHX4HUYS Hj/JBTNmliC3wkmn38vW3oaReohJAt1AKMV/Zl1WvRuRAEu1cEGPfXu7ICHQBTt//DeZOnVIxBP mPtZnM35Sn/9HZa7cGmZ8QzR+r1fa3Cbw1Z1AHZ6eX5/XyrgpgN43Uud3mrmpQMgb9/Jv0Pmltc 5SYFr5iQz9mdNHajgFN142MWFHvR9/P8kR/udtpdIrEdZn/LEtZFXv7IwBlFi814q28cVi3mxA4 sMryDZuxvu83CFkI6+YXvCYg2Fb/K9Nu08Aoehpe/bGEhLUu2aNyrECkO74D5x10GDiPxoZQnXw PNeI3ML24gqOeVB/42Sh1sMpFhHWZ6KaIUYTCSDFnGWKf+7wSkiLUbk9m06yCSsUQMmfH4ODq09 fx+Uu3VUaAMjeVA== 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 ; Thu, 29 Jan 2026 15:24:40 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8836 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/ref-manual/release-process.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/documentation/ref-manual/release-process.rst b/documentation/ref-manual/release-process.rst index 165dfb86d..a75ca52cc 100644 --- a/documentation/ref-manual/release-process.rst +++ b/documentation/ref-manual/release-process.rst @@ -232,10 +232,12 @@ efficiently. The Yocto Project's main :yocto_ab:`Autobuilder <>` publicly tests each Yocto Project release's code in the :oe_git:`openembedded-core `, -:yocto_git:`poky ` and :oe_git:`bitbake ` repositories. The +:yocto_git:`meta-yocto ` and :oe_git:`bitbake ` repositories. The testing occurs for both the current state of the "master" branch and also for submitted patches. Testing for submitted patches usually occurs in the -in the "master-next" branch in the :yocto_git:`poky ` repository. +in the "master-next" branch in the :oe_git:`openembedded-core +`, :yocto_git:`meta-yocto ` and +:oe_git:`bitbake ` repository. .. note:: From patchwork Thu Jan 29 15:23:42 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80030 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 148A3D6B06E for ; Thu, 29 Jan 2026 15:24:50 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.17122.1769700280485223899 for ; Thu, 29 Jan 2026 07:24:40 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=R527RRCF; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id D7646C22F47 for ; Thu, 29 Jan 2026 15:24:41 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id D725E606FD; Thu, 29 Jan 2026 15:24:38 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id B3736119A8864; Thu, 29 Jan 2026 16:24:37 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700278; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=Ngl3kX0aVswIdBiXKRx4CGycdfS3Cfw3lji0UZHDrF4=; b=R527RRCF8JGrfPutFw36EPAp70A8FC2XTPF0wib4IOxAXeCzcEAQBh+3JTcLuIgDpfnlEX yZSTmu5xKsQnMs2giXyzM1DYlL30onf5u/oujQeMsKwxvX2JPP4uH2vi4ZEshpoRjmgUoI bHCAVLBW/9mkQgHy+9U7ynI24baspG5+tIAerzW/spmKW1leKeLLx8Ds6xb7HCmTKnomOi fcIFTw/D822iBsE5JB6IidXxyyNPaU140F1lbXFAMhc6SX9MPLdjPvh50USa4JitAJFnWD FkASVReJH5qi1qhsCzwRRnk8wOOCTpiPKotTuzx/amiIxBmdntRgF76I3ACDWw== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:42 +0100 Subject: [PATCH v3 51/57] ref-manual/release-process.rst: remove repeated "in the" MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-51-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1206; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=+QE9UHu1IIIsP4hHOP6yClD9rS3VXtw9QSmO9+ndH9Y=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uRs75DxC/GY8BvLkhteSHNMvs1PwNiw5CdM kBObJFEzs2JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7kQAKCRDRgEFAKaOo NuLKD/9kOBLABI33zyXckbwYpf/AH8P06oCJwT0AQ812zrbZ9uk1oaEwoSafDnmC6mYkVHvbd2m 5cBfwiHIB/p+mcX/kJcwBi4+MLF9iw9GxTuWA31MXCerlegPnPQyn30V57Xr7d6swLBfAyy2TLQ pMZwWM3PaHdlRIG8jqP1UKcKNxBpFvI9nTkMMxv6WSO3IIoYN5HFdP/nOfNLcvTQr5ZHZ/q9sRE I1ODGbwLF3xxQWkrcvCGMSYcajd56raX0MCZpVwnh6iu9J6LRcNl+HeQgNFR6YgPWWGJbN2wI5/ cIBsUX8Xfemc/iTtok15MvkOKpbQjNzihK5JM9qKBZH8snlu30ZbLWYgRJNFpBwRROl4/WujG7O EkZQE6XW9aoSPLhxnxhrvPs755zia5wjv9V5uVzDdwCioAGittPx8cZf2EdbVlFeEntpMqiY8qP vHVMs2j6sQinyNLClM7bJrQ66dmJ7S/vaD/7FeMQYbp7KK4RjCs0Cr/nW4Uw8oFDGVLcOA1YyJJ GWMQceMDTAEEZkeSfuuVP2+sQzAJR9+u5Rq7TXTWMNY+idJXB9ITJd104pFeT0/e4UwBr0GNeFe hP/awCbkgcQC5iTKRJe6kZ3thZwsRNnnFhNzmzJTqBcCjMWlgF1EnaL39uSZiTTRAj0TkgASsIj ZK++ULoj1b7F5HA== 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 ; Thu, 29 Jan 2026 15:24:50 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8837 Reported-by: Quentin Schulz Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/ref-manual/release-process.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/ref-manual/release-process.rst b/documentation/ref-manual/release-process.rst index a75ca52cc..a55187c14 100644 --- a/documentation/ref-manual/release-process.rst +++ b/documentation/ref-manual/release-process.rst @@ -234,7 +234,7 @@ The Yocto Project's main :yocto_ab:`Autobuilder <>` publicly tests each Yocto Project release's code in the :oe_git:`openembedded-core `, :yocto_git:`meta-yocto ` and :oe_git:`bitbake ` repositories. The testing occurs for both the current state of the "master" branch and also for -submitted patches. Testing for submitted patches usually occurs in the +submitted patches. Testing for submitted patches usually occurs in the "master-next" branch in the :oe_git:`openembedded-core `, :yocto_git:`meta-yocto ` and :oe_git:`bitbake ` repository. From patchwork Thu Jan 29 15:23:43 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80031 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 14868D6B06C for ; Thu, 29 Jan 2026 15:24: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.msgproc02-g2.17124.1769700281522652884 for ; Thu, 29 Jan 2026 07:24:41 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=F9t06Afj; 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 F34E84E4231D for ; Thu, 29 Jan 2026 15:24:39 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id C7CA8606FD; Thu, 29 Jan 2026 15:24:39 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 94EBC119A8866; Thu, 29 Jan 2026 16:24:38 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700279; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=N7F/RRXpf+M9xZxQwX+eUuvFeixLQ8UlYnMTK3X7Q98=; b=F9t06AfjWqjanvBm7Od4DIuueT3t5V79N82yLC+gUMtS06GP96Y8tRR4sxurX8OONs2x7X RJ8xvUPcXiV3ZZuA9gsTYzEKKEKa4p73xh2XcbNHY2LTOpDJ7O5ShFXwSHAs/O45sZ7iYz 4R0IqAVcHoSB1WnYX17eALRJqgu9AS5rFiIvRb3VR6+M+HXCIc/hEQ3NTfJUy3hKohTRTT l/2f7EstpY3dXebkX2WIaFY9PPBciJEz2HJeueNuBniJ6CmtakXTMCUAOrJFSuDkSF6bhE sfeS0hTmldYozX2zQOTtG1eyYA0ufgWR76XbQZqg5gQbqyLooMwiMM/G9VuswQ== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:43 +0100 Subject: [PATCH v3 52/57] ref-manual/system-requirements.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-52-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2348; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=QBPGYheuqDjfbMHXsRiq0a3T5JJqeumGeM8DXyh2rJE=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uRryPCmJSp4pA/u4YrJeY5TInYpBNKuIiYP Us/rK3NK4OJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7kQAKCRDRgEFAKaOo NisyD/97EE+vpUPstHx/SjsmJJ9w6z0cNx4OUXSgGJPMxYWIHXExOwom9KnzRRSN23m/7i4q3OV w9PxsPluMkerqehKs7VNVATK9Nk5p76kbuHW1zvgXYe6QXiu3kqRyU7mwzY0m4FB/X3uLOEeIfM 4yGEgWhk/Nr2CVQrf0KDRqwlEEGbMn07rfAaphX1pczTzw38R5by9EokSkOQpGJ3SfsYvXr65ll x5/Pdt/y+i2RLW3a6o1KhOApetyDI8bEezO8QgcRoGOVlxInIm7nQS12linlomqYJucZxu7VrWJ df+60DB74lAi3mutDEvgFKVQy3J1Il3ux14aGHcVvwnWnfJUAYVPSEl0AILcDz0sI1vMlyc5JFK bBB0AprI4F0rjvaDm/UcWig3UzOmnaycN1iGbtPaXbV8B5379xWieyXPXBv1h0W+mUxyv3Pb0WV K9XXMAGCVD3VDRwTug2c7hJ9mkhyigzhXNkTmMurqC7HHOQgVyQy3lxvxf9H6WAUAlkAjZsNifi ZlzoifGv8CbfanoOtyXCLDKTiHVTyfOktJWy5N9fKAcxv4oJVIH+08P9hosLLfIKRlKmB4Mt/X0 LKEWpxnOmnzA4Iv8T/YZcE9UyL9TdnZTymu5XgSmHEHWC8YF5ZFv3T0ECm41mVi5DDC+QUCnuq7 U2HGf5PGhulF2cA== 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 ; Thu, 29 Jan 2026 15:24:50 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8838 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/ref-manual/system-requirements.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst index a56e683ca..9b681290e 100644 --- a/documentation/ref-manual/system-requirements.rst +++ b/documentation/ref-manual/system-requirements.rst @@ -405,8 +405,8 @@ installer and automatically installs the tools for you: #. Execute the ``install-buildtools`` script. Here is an example:: - $ cd poky - $ scripts/install-buildtools \ + $ cd /path/to/bitbake-builds + $ ./layers/openembedded-core/scripts/install-buildtools \ --without-extended-buildtools \ --base-url &YOCTO_DL_URL;/releases/yocto \ --release yocto-&DISTRO; \ @@ -420,26 +420,26 @@ installer and automatically installs the tools for you: To avoid the need of ``sudo`` privileges, the ``install-buildtools`` script will by default tell the installer to install in:: - /path/to/poky/buildtools + /path/to/bitbake-builds/buildtools If your host development system needs the additional tools provided in the :term:`buildtools-extended` tarball, you can instead execute the ``install-buildtools`` script with the default parameters:: - $ cd poky + $ cd /path/to/bitbake-builds $ scripts/install-buildtools Alternatively if your host development system has a broken ``make`` version such that you only need a known good version of ``make``, you can use the ``--make-only`` option:: - $ cd poky + $ cd /path/to/bitbake-builds $ scripts/install-buildtools --make-only #. Source the tools environment setup script by using a command like the following:: - $ source /path/to/poky/buildtools/environment-setup-x86_64-pokysdk-linux + $ source /path/to/bitbake-builds/buildtools/environment-setup-x86_64-pokysdk-linux After you have sourced the setup script, the tools are added to ``PATH`` and any other environment variables required to run the From patchwork Thu Jan 29 15:23:44 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80034 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 209F6D6B072 for ; Thu, 29 Jan 2026 15:24: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.msgproc02-g2.17125.1769700282091066339 for ; Thu, 29 Jan 2026 07:24:42 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=BB+7eIVj; 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 8B5A64E42322 for ; Thu, 29 Jan 2026 15:24:40 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 61D1B606FD; Thu, 29 Jan 2026 15:24:40 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 80B31119A886F; Thu, 29 Jan 2026 16:24:39 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700279; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=bonL4jl3f7N3DqXO9BiL1YZgqtQ/xWWLTg2INZTB5hY=; b=BB+7eIVjWAyYV6z+432UynPVR6uqdCNasx/vJDcEGyOyjrhiR1eyF+xxl0AxDZSR9DUzyE n2qF3PbZM1hKgJ5WoWgOgmf1G9rWbsb7B7XT/DoZba6AwMgDNXdzgWVjMIOUD5bGuSRZ9+ euaps4mOE3+c2JU+/p7zz+WCKNjmwEGEOR2JesEhf7iCyVMCQFflsfkdy500r0zXjqhN4e T2zTrMgTlLJNM0hjkTSDP1ErFxTwoH4/eSVsut8fNAZgFqbotj2ctVJvopS4wmnCcwyK9K zqM5vEbSOkpsjqvrUv48jNhUcyHTJmJv1csDObuS+FjYs07+7zQ1/H8K/9Xl4g== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:44 +0100 Subject: [PATCH v3 53/57] ref-manual/system-requirements.rst: fix wrong path to install-buildtools MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-53-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1303; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=fFK9PRZflppMlWH/Z6riNUakWEhd/02LxxmZkyx9Tik=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uRt8YFocAmZ7ynA/KpW0goBjOHU6IO2o8yv KPJ0dCyVyuJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7kQAKCRDRgEFAKaOo Nt1OD/9lJbyr3v2VIf6efy1JILOgSJadtBjAjkk2SsrIhNntfEEAxf5MEz5r4IiJ1nSKiT8bP7u uXpcErI9M0UBPIGZ/3GTpQNrMv3YHVk2TlMQZAYSjg2oxmL8erfkkX1cAXHhcwBDGSnZ4sp23Lv yoxSXgI+yJt7xTThzm59IIMTqu7LQS17v645FNN5nmARv7t93AvBDgGJ4D9OZpLCK+x0DRGwRHV J4FvS6leay4AHfaYfzFs5J3JTkWGMQfJyKAmCyROySZvgW5FfCGcwWYo77fYSYotCkc3ITdCe3U MToIWrPeXa+vujfgKaMKjnlF8ow1l0+KFnjuFzbmUwdYRnomh43HxfY0gsfdlEDSt1/yl29weF3 ajfpKSXSUkM2EOmcYyS9fZeOaEEeZrsSZPWK8d3DiK8O9pw3bCEzaLHhYhrrpngrXEExm4fm68I R2sHEecUeC7nC6EAsPRXt2jsJrEFGXOF9RXtITXOvr3xMjtkkK3NaWOrXzB+htU22yjuulObwI0 l14L+UQGYaIZp1FYGb/MbNGsbg8zaL9bEuszYISXfrH7HkN3DpH6B2C3QzT1QKLTbm02KTgFaN/ sVDCaX7FW4AY9x7CnbETO2WkTmYSrR7G9hRFJLyN65fNnjxLBmMoV9nUMAOqwKnHcIAs0DiKHaK jr+RlO3/c9Z2arw== 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 ; Thu, 29 Jan 2026 15:24:50 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8839 Reported-by: Quentin Schulz Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/ref-manual/system-requirements.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst index 9b681290e..f9f32f2a8 100644 --- a/documentation/ref-manual/system-requirements.rst +++ b/documentation/ref-manual/system-requirements.rst @@ -427,14 +427,14 @@ installer and automatically installs the tools for you: ``install-buildtools`` script with the default parameters:: $ cd /path/to/bitbake-builds - $ scripts/install-buildtools + $ ./layers/openembedded-core/scripts/install-buildtools Alternatively if your host development system has a broken ``make`` version such that you only need a known good version of ``make``, you can use the ``--make-only`` option:: $ cd /path/to/bitbake-builds - $ scripts/install-buildtools --make-only + $ ./layers/openembedded-core/scripts/install-buildtools --make-only #. Source the tools environment setup script by using a command like the following:: From patchwork Thu Jan 29 15:23:45 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80032 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 2BFF1D6B076 for ; Thu, 29 Jan 2026 15:24: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.17220.1769700284332687406 for ; Thu, 29 Jan 2026 07:24:44 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=1gJ/eXak; 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 C695F4E4231D for ; Thu, 29 Jan 2026 15:24:42 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 978C9606FD; Thu, 29 Jan 2026 15:24:42 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 42805119A8863; Thu, 29 Jan 2026 16:24:40 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700281; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=la4WWR+CaGbluDjsNtVOnCekxf1gugq6sG9f+o+QLhM=; b=1gJ/eXaks8Jp4pHlztgrfhSvxPrO5CuDXkY5o+nJQxPKru2JQTXJlO7hi3hSphjVmub4Hl Z3Xq+9CGdDrh7d53CQJvbh9+YmKTDb718SHEWKi1X/i7vwScZHHhrEVuHNbtoSZUY8zmBX P0F5s7bvhSREvxpzrXy10Hm/4Np6SwZxJNxF3sPVswCVfkv0Cv1RsiieY8uKy2DmNDIwOD Tez77nMfOOpkbvMaNDSkd5jyZPv47YEucri3onReHD/1Kbg93Ak9xCjzlMqaWvCPC4StiP wcbc3bWkX0OwgdUMunG9x8Pwu07KilPrLeRuZUDyXuw9PppfAmix3alDdYsTvA== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:45 +0100 Subject: [PATCH v3 54/57] ref-manual/yocto-project-supported-features.rst: remove obsolete poky repo reference MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-54-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1071; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=d6JpK2mWZS4vis94xlcCx6Qi81mwK4LaVdWn8Gw94/M=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uRK6PJIudwLCFrQHyAWB/lC7EGkdpgOCoJT Awc93SBBQ+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7kQAKCRDRgEFAKaOo NqYYEACdTVwXatuA3i5ORd2CvDlz71KV3vc55QrEmpU9f0ULqyNMdkzmkfkqc+gclXbC2C43/xz iCsq/DCkQLbT4z733OOD8+nn4dEGnykSV6A8Jx9JY0I4VBAz8YiabDFIUs3T43fQoKmMOHriYcf jZs+6aYUFGpugt7jgwYsAezHYRBAXwtbP5OCqV4oDjOZou9v4XusYiIWfu2W6wtfM0Rb/wosx/x nlMCSPDyUMlGrxVhGVPkhz1Zc4aB3bWaQFCkFGAC/KfQ65oMDlUG3lzWJ34ia+PlhVCC8/ZCOBd DBWDccXhxyKfQzhdkTbyoEOkwaEdha15NFbW/AiDinY3czeIdIHMR6/z0ezyI8qcZYi1KqDmGAF MWi6E/Qij6O8OCko1PHVAxRn902js/FFSr5zzSkpBUEPyeihzmTh5nNs49aEgQMTtiHvF3PuUku A9gu2klug1ts2jwiSSFH9oBmC2aIEY5zEDr+O6/Vuc2/Mgbu5rgsFtD8fJz8UR5fLRyOsKqrWOd b3dj1xMwvYq0y5CuYLPYvnpUm/CbU3Bqnx+Z1npc/DCfX2ait/qpM+vR6/N8wWwYijfL8B4s5qx Jj2Qz/ZYLJC3c/rE3eS9bJJ83J8Wocgn2MgSmux6tRv0wNAatkpDpBc16GKtPnV0KARlIhrZE7f Us35w3PAJhcOz2w== 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 ; Thu, 29 Jan 2026 15:24:50 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8840 Poky -> meta-yocto link replacement. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/ref-manual/yocto-project-supported-features.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/ref-manual/yocto-project-supported-features.rst b/documentation/ref-manual/yocto-project-supported-features.rst index eeae6b24a..021fca36b 100644 --- a/documentation/ref-manual/yocto-project-supported-features.rst +++ b/documentation/ref-manual/yocto-project-supported-features.rst @@ -59,7 +59,7 @@ Below is a list of primary tested features, their maintainer(s) and builder(s): qemuarm64-ptest, qemuarm64-tc, qemuarmv5 - * - :yocto_git:`Beaglebone ` + * - :yocto_git:`Beaglebone ` - Beaglebone image and SDK build testing - Collective effort - beaglebone, From patchwork Thu Jan 29 15:23:46 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80033 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 32A9FD6B07A for ; Thu, 29 Jan 2026 15:24:50 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.17127.1769700284938098337 for ; Thu, 29 Jan 2026 07:24:45 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=XzrrrvBh; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id 4C6E9C22F48 for ; Thu, 29 Jan 2026 15:24:46 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 484626075A; Thu, 29 Jan 2026 15:24:43 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 6BC6A119A8877; Thu, 29 Jan 2026 16:24:42 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700282; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=eYBfodnUQoV6+Z+LZLKCM7b7cl0U9OnMNzUUls6Q9Tc=; b=XzrrrvBhdrdxogbrSxxwjV3KjhXD/ZgJ2fJzWE4Q1k/Ubjpnvt4eu0ZisN+Bv5Akha+a13 0tMytqGRkMfvsFXWIJtVk4lLiLKTU/x0dZcBaXFY2Xs2rlPC2Lww3kHdv2/I8pIZSzWHLy qiqbZNAnlunva2GGviu4LVeWaGX5Do5KVKZvIqOvkt0Y+SiInsQU//LPEpidx4NUFoz74b 8bP/Whoq6FttczYF+mQx1lWnURINTxk+PnDoZfGSJY+VPyaUo4xJuvntNKn8MhI586gerT jpj2AXdxu/fHpf3ABTVVyccW5Tqc1C/FVnjNJ7GI8Z8WZZQpSk8bf3ZgOb2s3Q== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:46 +0100 Subject: [PATCH v3 55/57] test-manual/reproducible-builds.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-55-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1314; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=4eYaAuZsWOi1UasIMen+pwV4EPzRxLX9T1yIFt9WQJk=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uRdrQFSSAhbYwmadHjfo8h3oixTcQpiVOUr jNCmtnbdI2JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7kQAKCRDRgEFAKaOo NsZGEACYPgi9smbNTRDniPttVwA/MktlPKgbLYAi61VLr1XiUT6DSfqjYHdvDoJnAnymzau21+f qn3x+KnS+mJ2kzPoVnkbzDRc6yaQSoUaKeOYOA5KpauQH8ei1fhDnPNLDTy9/7kTXjGuTRR1Xvj 6XJSnvI25ZYjn8gFEzASYIUI77eTMzURPRGtfKA53DlFX/sgiDdIo7/1jn+RBco/GYwQaIPp34m IDB4E7+7znkmuYWBSXLBoywc366pNgXk2PNlWtiHlGTt7bs+cMje+VALPfcW/1GbllSB1SM7HhX TgXUHtBX8lN+i85DoV7wg7BR15ziP8/v/mjEN21nbKolxAbPI6Qh9wrX65tO+BpLZzavPDazdhl Gh6wFy27UACxm8MsukMYj/jtpsobieWjQzVuiWhldRP1AsKYt6NZkCf9Km2oPwtA93Yksoe7Uxl QvWLe+9T5LovHssh1latEc0N8X1ESl31Gok0j50SPNAf6IENPvDrC05uJSFWRaUpNb1yD/oekxq Yf/QmbxEiTQgS5mvX0JrydhBg9jAW0iFDPaGurvvIkxJXp1mGLqmXf7QonuNjdsVaHP/DnRYTdt cy5YBS/pN1eZeztuwJmguykhKZsdj3QqGP2tAXUJ6movkM93fol7gGREFfGMHlP4WYl8NuDwTFf NxaGMfmp69rJpbQ== 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 ; Thu, 29 Jan 2026 15:24:50 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8841 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/test-manual/reproducible-builds.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documentation/test-manual/reproducible-builds.rst b/documentation/test-manual/reproducible-builds.rst index 336bb7f26..84523ff13 100644 --- a/documentation/test-manual/reproducible-builds.rst +++ b/documentation/test-manual/reproducible-builds.rst @@ -81,10 +81,10 @@ it always depends upon the paths it is built in. .. note:: - Only BitBake and :term:`OpenEmbedded-Core (OE-Core)`, which is the ``meta`` - layer in Poky, guarantee complete reproducibility. The moment you add - another layer, this warranty is voided, because of additional configuration - files, ``bbappend`` files, overridden classes, etc. + Only BitBake and :term:`OpenEmbedded-Core (OE-Core)` guarantee complete + reproducibility. The moment you add another layer, this warranty is voided, + because of additional configuration files, ``bbappend`` files, overridden + classes, etc. To run our automated selftest, as we use in our CI on the Autobuilder, you can run:: From patchwork Thu Jan 29 15:23:47 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80036 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 390A0D6B07E for ; Thu, 29 Jan 2026 15:24:50 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17222.1769700285572298310 for ; Thu, 29 Jan 2026 07:24:45 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=AtJQxSXT; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id EE3B2C22F4B; Thu, 29 Jan 2026 15:24:46 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id E6C16606FD; Thu, 29 Jan 2026 15:24:43 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 243C8119A8857; Thu, 29 Jan 2026 16:24:43 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700283; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=zQs7y59B5I0wfvd4GOUBP23ijDMnvK40AbMc0hJXbnU=; b=AtJQxSXTTLzWGIQSM3TM5upBbheM+8VGMePRpSbIi+RlyRXpyhQ5sUwrgDdRFjrPbkhCxz 73QiLFXoGU5SqodJ5Vt+43WTcuYwckA+6oah9KcleXBTinYJy9226vm2HSkCkBbkdyoYwS ITBQOx7GS/i2KUERc38wzNFw/YCYnxIDxjLC3YB9r71kHxG97c/ztahDt74L2VDYIERDGS 9B8AFkBIagrlzn1/G8KqU6lsvTVZGVjDr+1cpZ+gULn/EvueHmNI3OkUoEjEco8l4jKh05 JPlYEjq+dmN6/tPH6DQurmQHPi9abiOwPG5sGgWp8K1ZuBR1LLOcSVOENKYmhg== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:47 +0100 Subject: [PATCH v3 56/57] test-manual/understand-autobuilder.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-56-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1358; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=r/yn+8vjaVjyWxh/o7W0fea8QW3G4j5jczXwF6Y4wIo=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uRFrwG+D2Eh1JmTSnF/aa/3+8unl5ZSchoc pN35XUxNX6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7kQAKCRDRgEFAKaOo NgC9EACKEkA7RAYV3wlbq6zZf3I/k0JzszMGwYJDxOruIm2MfvwiLGhBPVaZGgS/9nasHqRFIFr CZ73x4+MfpmxPQnUxvQfYLQnU34M/O0xSXKfKNxZztJvvYQ0sKHclyTQxKzT477lnMp/q+fEm2E bO3JiOzfyaVexNBf+fW76SIvr4qkwiqk1MWdtAAiS0zHVpxG9+ONrocLGmsZX8MjQhFv2v37vcg Ert5f7R4mUZ9X51IgGBWVajSPlNJNuAtF+ShAYkITrCz1yPk5QbY32cAxshNEjtao0WawUmI9qm Y0HepxYbBiOQLrRcEV7dnYdj65IourHO+e6yN/kPNUUTNny7FOGeCkQR3QgfsKGrvE+f4gTu0t1 D0YIx8DtNlFO+sV+hvVuYBfrkBAg6eyqhgpU/wvYYGND3l3zoSeMSDg9l7l4zFubEiQJ2KgfYyK pyTmz6xPxFRjA/xaArgXe7Myn9oLAjlro1BkA1HWGpV6J01JqACrHP2WFgZB362UmSC6GxaZx7Z gkw9A2e1T6HpDQw4kKVwuGfCBnuTh7vySqCt7CUoCY+z7BUtGy+LG4A67WHJnyVJg4/hM2MFTfU FK91h5vgOuuNZZRKsRQ1+gW+Tby6Lpr8iImef8iJSN2jY2CTrI3HbDCJ5H7mSfwa8Nf7NQDGfLA rgoOdmAO6mfhAuw== 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 ; Thu, 29 Jan 2026 15:24:50 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8842 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/test-manual/understand-autobuilder.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/test-manual/understand-autobuilder.rst b/documentation/test-manual/understand-autobuilder.rst index 23b3ef7d7..0015c2e57 100644 --- a/documentation/test-manual/understand-autobuilder.rst +++ b/documentation/test-manual/understand-autobuilder.rst @@ -102,9 +102,9 @@ roughly consist of: #. *Call scripts/shared-repo-unpack* This is a call into the Helper scripts to set up a checkout of all - the pieces this build might need. It might clone the BitBake - repository and the OpenEmbedded-Core repository. It may clone the - Poky repository, as well as additional layers. It will use the data + the pieces this build might need. It might clone the :term:`BitBake` + repository, the :term:`OpenEmbedded-Core (OE-Core)` repository as well as + additional layers. It will use the data from the ``layerinfo.json`` file to help understand the configuration. It will also use a local cache of repositories to speed up the clone checkouts. For additional information, see From patchwork Thu Jan 29 15:23:48 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80035 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 3DD1AD6B082 for ; Thu, 29 Jan 2026 15:24:50 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.17129.1769700286286647108 for ; Thu, 29 Jan 2026 07:24:46 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=jakYGjbJ; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id 9E3AFC22F47; Thu, 29 Jan 2026 15:24:47 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 9F4A0606FD; Thu, 29 Jan 2026 15:24:44 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id B1397119A8865; Thu, 29 Jan 2026 16:24:43 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700284; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=FT56Ou8bPYYmZWJhKppAP85i6rmOwcdRYuurT3cQJlY=; b=jakYGjbJgvDIQuR6ZG9m3vmDyx9u+9KGMpJPs/Ffcg8d4j/83MDtAJr8nGZN3Nn4OOWeyv xP4UaRbC+Mk7CCGLWQaoYfsHaiNuj94nrXlVRhKlrsu9aMRVoDJMeTWed//tCAY61YdUk3 HTPZMMBn93vqstIa5RxjCeN7i1G20576dF72tRegUq9l+Jfy0TeWHvYh7Y28m7xZSu2Ift HOvTWf3ypXEaadqEKaQdmOslJq6nBysBI9ubvSgxgHnadY4nEVZzP8F/tHWE6VVZeBq2Gn gJI5UeVTfwpoE7A2e2V6XQszA6vsmAHr3p8CMjQEcG8Sp4R3IuUDS+gFxwxVQQ== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:48 +0100 Subject: [PATCH v3 57/57] what-i-wish-id-known.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-57-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1201; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=slsThUKHpnubLsip4+8LaLW34OHKFnuoROqTlMDo1VU=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uS6qZreKolMsoG3Gtu9mUiebpmFaytB2jX4 +J+/+l0X76JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7kgAKCRDRgEFAKaOo NlVMD/9lhD2v0i64sY6XLasfkD8/6gvAOEarNOUTY+RhkHhteraWM7NWhYpkHHCtZdbunbYBnDp PUfCrWDvQwWEIDtiLOIaYk64jKlj9ygosG2PjtTJfd6xEDjvX61Y/FYCNWZMp5+MAcaUANRoOCA ar7ZiAQLS55A3cRqsMEzocMVm2MPm0RfgM7QmfhkSVB+oQs+4Yk+lT0sAymbq2bCORzAeg1JRSP l158vzuB7a3WLbSDerL/e3HCA1yZ0u24ID0Mf2tZ/q+pR/+GP/4ze1qUY3CkMpN75cAu6GGyNWR 6bUbwbanloeVjdyyCRnt7qCMttd9S6G+P2YzXtPTJeE3hof9mhYqHTEKZYvNdyRFbwZd8Vc3kDc tYkf4yRAsFp5nueZumZERxro/GulR+eT2iDnxXsf7oeS7hqAQa2AXaM9BgxkwzzWstj1nnTrvi0 jJIrqmjU2jCjBF8Ojb1BsbYgfppq9j/Th47KUGTdyBM8SbbBap1tpgI1vnE6CJsSdsSUUnI9aVe +LuIjkiL42uThhjCBtweUgLL9ddszb/tyBmeNos9T2qTfL0f8b7p6bZdOPW+apgTg1CTZHTDUNE TQaXMZer4CyOh3ciT8Re1rH79rERr9zksmt7C+mVWvTlpmf55ZhXJXigYpP/73XbMHDBbZph9Ng WY11gPBkH+EPZkQ== 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 ; Thu, 29 Jan 2026 15:24:50 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8843 Refresh the document now that the Poky repository is obsolete. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/what-i-wish-id-known.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/documentation/what-i-wish-id-known.rst b/documentation/what-i-wish-id-known.rst index ddee6ad74..36cf715fa 100644 --- a/documentation/what-i-wish-id-known.rst +++ b/documentation/what-i-wish-id-known.rst @@ -60,8 +60,9 @@ contact us with other suggestions. layers, on the other hand, helps keep simplify future customizations and reuse. -#. **Never modify the POKY layer. Never. Ever. When you update to the next - release, you'll lose all of your work. ALL OF IT.** +#. **Never modify the core layers** (:term:`BitBake`, :term:`OpenEmbedded-Core + (OE-Core)` and possibly :yocto_git:`meta-yocto `). Never. Ever. + When you update to the next release, you'll lose all of your work. ALL OF IT.** #. **Don't be fooled by documentation searching results:** Yocto Project documentation is always being updated. Unfortunately, when you