From patchwork Tue Jan 27 08:18: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: 79756 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 8BEB1C88E4F for ; Tue, 27 Jan 2026 08:19:25 +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.5797.1769501962979373907 for ; Tue, 27 Jan 2026 00:19:23 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=nsnKAXJr; 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 6FFA74E422CB for ; Tue, 27 Jan 2026 08:19:21 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 477A8606F5; Tue, 27 Jan 2026 08:19:21 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 6432F119A867D; Tue, 27 Jan 2026 09:19:20 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501960; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=wjl4d53mc6wCO/qGfxZ93rzrOZHOvIp3vm+zpMsjDDE=; b=nsnKAXJrjrKc0Ud5mzF80BNUxH1XFJKAvns2Y9oFAyPmZNKK9AvQSOzJjK2i2Ep3HsWFJV f3rDy1dWE4PegrXUafDL+gmfEBEWPu7uJ0o3kUpD6IuhemEfzSguC1WuAOzK9H2zmEcx3I 8zn8cPz34VI5eTZnRcfLKldgC7yc2j5khTTEREa4sGWXNKsSjcEHCaJWr8cxFTCQWhNLzv WxOPSQrjPRzJRHEx9o7S+XuUjbjCABViejap/dyTHELRVGEu1llelm33Wrn/N+62x+iiBz Ke2HhETOSs3dOI+w5AR6l23aY8wmknhdQK8vi22H9ROMvqqMIw7uevHTFJQh+w== From: Antonin Godard Date: Tue, 27 Jan 2026 09:18:56 +0100 Subject: [PATCH v2 01/56] transitioning-to-a-custom-environment.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-1-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHT+I/siF6BPOn3VtCdtUaAKD89KFsqp+QE7C /+FNiuAIweJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh0/gAKCRDRgEFAKaOo Nh4TEADApzvzqQA6SziqYGAmiwLwNXJ+MSGEAVZXND5+2hhgebNZeDHbmnTxGVPzzE1HE+YylLM Bo7zkgqnYEpT0gtbYhPZ83b9HNi9SwYAexpKxVlKCfD0GCpWupcIa50qgxh6t8lJKO3/1wM1WBi JosZrHTE4BvspKEerpgLgkpcFB5ctCuZit0/ckjc1WGbA3UtVf9/iPJoRWIVuv94ZYCCW9lat+i eFxcVdrwTue559a0jy0rFsJErYCqJKnQ4ifTPaYSP0aTvxT+HCeQ09yeyuq2AtohKZpY2KYzX4h 6QrbW8HLbm3nDdfSJWjPLKZi+Yz8sQJ8h9lZvWJGNVxxNS5JX9dTrUq/bltHqBeD5WXuuklgANe ZNMEzhJ90OYVH5rqu3b6mavGb2xlswMdsU2k3hTkh6PEIxuffy5HKVAbVXdtrYyHQJu+zJd6dDk XzLjrodRU1L9XSeyAgYPoxXcH4K1/QniNuXIWUbWLEsyuNT5z/toGHtRtuGOTZDm2LoQ7WKh5lo HoVs9t0Hq+fen6zFaebZ4R4pqmaEG/STGcdpm+rUyE3LDGJSj5P0vhpGySCtODKjjF3DVyIitus Gmwvhx6RyPSPuT+LyIEg7Jism5vAY8vrhheE77PcymjI3isOFtvg1WDCloamObsFih9OhAYAntP Ya37E38fw9dPoYQ== 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 ; Tue, 27 Jan 2026 08:19:25 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8661 - 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 Tue Jan 27 08:18: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: 79758 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 A1CD1D19512 for ; Tue, 27 Jan 2026 08:19:25 +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.6042.1769501963520654289 for ; Tue, 27 Jan 2026 00:19:23 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=ShEpgtci; 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 F1F314E422CC for ; Tue, 27 Jan 2026 08:19:21 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id C8421606F5 for ; Tue, 27 Jan 2026 08:19:21 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 23951119A867E; Tue, 27 Jan 2026 09:19:21 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501961; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=lWREOdQ/SsgfmbXYG4okbZ3IWJjnvyRYMk23z4p/v4A=; b=ShEpgtciL0F6zLPka8g//yvVofeZScwEe1NitDHoFkhj6OcUjpvvscBLd2Yh4r21dIN7xw xNiapts2jQvDJdjSB1BgeJsRVxXTXkGyobkdrfJGtvotpFZQ3Cj+7TigCwTiL0dhA08v9j oActRtBYfw5RfYK1d4+wawCyWtdeyqm1YpzVv6HwY2w+7+vXoLbW5gAGztM0vo1IPV8/vK /cXbEVrW9/pAREEDg5+dBgQQ2013iCHahLcYxnjGxO0RnLLqJ7P2ZvPM3XGdEkl43jieC0 zR4EgaESmnD3D6hYZnJCYMzXsUUSQNWSHs7Vyk7cYXzdZdSzmXmEVgNgfIzZHg== From: Antonin Godard Date: Tue, 27 Jan 2026 09:18:57 +0100 Subject: [PATCH v2 02/56] dev-manual/poky-manual-setup.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-2-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=2667; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=7W2zZLNN3UAifWKQ2mPa4sgGKGz9nEtCgf+mCVKXzSI=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHT+4K3FQBLaog8GylkYON292NwovqW8bmxTf 5ldJ2st8p6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh0/gAKCRDRgEFAKaOo NmC2D/9w6ZQNUJARTV2rA73Zy6Nyy6GYvUD31GHGTWnuSRYUFXaM4ocWK81j3+XWl6ZRw12/Z2F NSlxUXfIRJlkat//m7u0EW2O1cGmDmUwSoqKLvx0nATDwf+PJ/i41jsKJJnOd82ShhpoMmWnel6 rdzXeDFJQ33AYBjRH1wLPFFFCsQsuifyZIjKvlLYyy9XRVO/ZPMZAs+aG4txuAaWbiJXzJbQmtQ 8b5lAeIRQUI7AqN9kVuvcmviJ860E/2/EmG2s6p4V0ETC3jqrW6m/9+d6inf4vsGX6rgcUh+foR HUEFWhGHiW9ddfi0vBbI0/CAtPkfONtx2dqZsoxxqut2v8B8OmtXnK9/3cko0FZiCAoKtU40uVo Rv5mb9/QgDTL1blTvxjm/4hKILSvU6kHivRJCL/SHbdowFw00v9mqIRZRXEZXaL4yCaue8R8fWG UUCW73YZGm0R+Axv3DwSrHWl7+rCGzIThwtZHBDALdl+2d4u6ZrUQLMP4By7FFIP/BkaNmJsPqd iaqOC/kGoKUXeB4n9ENniw2Y8XmYTGik4YbNU2PDvVYdqZOiTWuCuI1bU06czDGewC5KAoYtuXF ryrOtbFeTQNrmDwsC/ksZzOw1lU11I/4SImHetkh+Db0iPKqmwFuoUhoSj6wLPge8XSEBHN/MtR 44SoQToscWKQHRA== 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 ; Tue, 27 Jan 2026 08:19:25 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8663 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. Signed-off-by: Antonin Godard Reviewed-by: Quentin Schulz --- 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 Tue Jan 27 08:18: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: 79757 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 93E60D13C1B for ; Tue, 27 Jan 2026 08:19:25 +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.5798.1769501964576392032 for ; Tue, 27 Jan 2026 00:19:25 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=vgJZOzRK; 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 0B0BF4E422CD for ; Tue, 27 Jan 2026 08:19:23 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id D40EC606F5 for ; Tue, 27 Jan 2026 08:19:22 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id AEC75119A8682; Tue, 27 Jan 2026 09:19:21 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501962; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=LnFmUU7AW2t7oiA5ay5xv1TBSl2T6F7R9BwQVSnaDxQ=; b=vgJZOzRK8xFaEGDb0Ij7pys6dl2Y0irg+xMlZyCavCM8H5p94GlAwGhQzhIXA29Q07ozb3 DmB7o9RdeggSKQYYgb6eBS2TOdjyvtjqLOuAxU6GZkWKexZ1AqgNmb6FGgBXsTyPpUhcOP 43fFtakbVpTG4fGIwmJ1ZIlcDWAKqfwwauxD5JKaTDrWPuc5MTnFM7sQUO2Wa1Wb0GfT+y q4vxKauk5d+Os1oWajXzK/oCxbXla0FUdkY2e3vf66IcJJB4Pi2SNL1DiMmQ3okhW5QCoS w0uTYVVLOUYcf6lL8NDQBq9pfWrhEFXaRc1yVwReLCjwtluaMEBxZmUbOX/FnA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:18:58 +0100 Subject: [PATCH v2 03/56] dev-manual/start.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-3-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=27101; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=SCxVYReUUPg86FemjiVp/erohUNLkAs4uY0pkoc8KRc=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHT+Vg8gyCVCuKerOPBgS2Oz6JKxvz/NcD1UU +ZFhh4NqFyJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh0/gAKCRDRgEFAKaOo NuqAD/0eDjaHxfslS6j3hUcHBdLPjQWEgsMTbZFp/Xj0dHzRDNEC3HiuMOgRhNLxyr5ksLZr9DP yCsVetMfOIH+15434Z20BFqsvxON+km8MjYRJLpdQjizqHbfWFpEg5F8V51gNtMwcZf3cv51+n8 lAtTEmooRGI9ax/2l6j9DqokWh0FjAJJ+IntM76rdL+eZscdB1KxzN4b7ZUyC0UoJ8WIDe6NhNl 0NlSNC+K0H6s2MZl7uFEmih1Srf+hfup8KEEjFSppVJlzTzJKUyUJyu1p60c3IZsvslAiV2PC8c juWCb4g5rPDVRLDTQweZ9FwnAXox4RVEw2sHizNT9LDJ95b/lGxk/08OdOfdZ/NKF/TrZli2nS2 BIE+JwkQdEQ2sEyz38MWyQ/qn9UWp7Fp/WiJ4n6E2Sdp71tQXbof0yjHexAwgZB+UlQ22Z5ndXR DBTVm8bCyNx+nA6/AG2UJKTbQOu8F2bjYPlaGGU2+h/9kLJlnC1ysfn8QrU5cxGqVAYPK9RYPkR cR3TjnOUzbV+x3PhpxBM4ovG3Em+lSgora/zcu5XhS5uoIbtqB7840unBIP4ZT4YZxqSPd9Xet4 /56wvXdY4ld6oqWdWTGuWhgRgpeuNZ8gddyVEdHWMH/AffxM5Dp9GblH/+8F6anyrxLU13k91h2 XOvfbGhX2oEm8Vw== 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 ; Tue, 27 Jan 2026 08:19:25 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8664 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. Remove the tarball instructions as those will be moved in the poky-manual-setup document. Signed-off-by: Antonin Godard Reviewed-by: Quentin Schulz --- 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..51ec05347 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 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 Tue Jan 27 08:18: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: 79760 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 9CC5AD19515 for ; Tue, 27 Jan 2026 08:19:35 +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.5799.1769501965151331447 for ; Tue, 27 Jan 2026 00:19:25 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=iWN1rRYI; 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 903524E422CE for ; Tue, 27 Jan 2026 08:19:23 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 6796B606F5 for ; Tue, 27 Jan 2026 08:19:23 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id A9893119A8684; Tue, 27 Jan 2026 09:19:22 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501963; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=3Zd9x4Jc71+rPo8D2j1q8ZrrdpKkb7QMqrcgL3J+tjw=; b=iWN1rRYIRPcn0Z/RN6gRAq529Vt8ILGjtZ9FNwBHudzXgRko86RoKjeXGiVrchnOnjXXh5 AihuCJ27A2v0Ap0Slujv3Pu2tAhILoB8eB1CavrK1uZa2e4L2Se3TLpm9EwVA0Ww5Irk3M KqqxkIyiDxaRBh97VddEIWeqW3E5X2OG2N+Ed8N3gNKak3vSQUs0EKn+Hazpya/uwqaqU3 RZmOhw6BXrDYVqIsXwTPmr8u+pMJCgxeUknZZrrJnwClcgU9JJm3K05r1opE+SeAssg4Ma l0BYxe3f+UyHQ/43/nOVKrFrEi3sqDL6veXNC2Xc4jCGbuAWQsDlsEOScZnkWQ== From: Antonin Godard Date: Tue, 27 Jan 2026 09:18:59 +0100 Subject: [PATCH v2 04/56] bsp-guide/bsp.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-4-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=14077; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=zO0jYYWalvWp9tI+iHOAoAJdLz9pQC9gUFQXiTQTkDs=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHT/cK8mgbkw2SXh3ljm4I3mtmdfCxJV0vKu0 wNWdzNFw1yJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh0/wAKCRDRgEFAKaOo NgqHD/9VsP6LwZibFlYhwXkJpxQBJ31W1wJEn084AppkVo9IHmBmE1tSuk/mcs5DDCAaL7KAscW z4Qb2c6AAmUSTe8WW3orAA5wE7afmHMHm7j03yke3VW8R9q+UhQ2fCpCnciw+yUcOaRJVTmXUfQ 2/9GoWlT4zDXVHqhd2JxxKTLTB9F+D/ByXRGm7KPpXwv00lHJe594yEUfMVBJhqfJlLEUS4yV5m dFfkzANYl6KtnMvgWSqGoV5mp2etzHxv7r5tEhz7RMRLUW4OwBuTU8iyrx7Yv5Tuc/VpJ4JI7Wt +x8ATDD5eTH9BYJ7UKtEgpk1yv8cO2IkEJtfwJ30OOG0S/NVNoivuAIiaky861arHGXHXyOr0jJ lPTmTbtYcBVGMR6yy0oUjSXojJC4U7te8DY5n98fdwzGQLnVhVlrJ9lVkcYVrywqadj4/YaC/id yOGienb6elx3VUuw9lRXmB3+qu3UFDpEqnTCPQXhN2As+HfTECxGH/qeHUuD8gz1J2Qe5g3+VGf RugwVYIDohV8MWnLLp76yig3B3Y8DQObP90/4Jj1XULqKh/GYRfAip3fVDK6FkcJm5nWATRzX9L 0hxTMADL2DaQ5vPgeqLuIXdGJvjTpurpaXImmFgwIMTkKrbi/fKTR0r1maRQ1EYu93QvUSFvSlu P8hmAVt+tS4vG4Q== 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 ; Tue, 27 Jan 2026 08:19:35 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8665 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. Signed-off-by: Antonin Godard Reviewed-by: Quentin Schulz --- 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..49527f45d 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. + :term:`Build Directory`. After the script runs, your current working directory is set to + the :term:`Build Directory` 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 Tue Jan 27 08:19: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: 79770 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 EA457CA6C90 for ; Tue, 27 Jan 2026 08:19:35 +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.5800.1769501965682097119 for ; Tue, 27 Jan 2026 00:19:25 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=w05Lzdmd; 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 296794E422CA for ; Tue, 27 Jan 2026 08:19:24 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 021B8606F5 for ; Tue, 27 Jan 2026 08:19:24 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 4E9AD119A867A; Tue, 27 Jan 2026 09:19:23 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501963; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=89EgbKd537rdLjyeze5aK2ndM2vtlB3f7KYjh2i+uOM=; b=w05LzdmdbWnNaMUaGEKNCgb2b5xcD016yaez9dxzDxohH+l1btbWNZfis3LSPP5bqH6uo/ mqeKAPyT4qNwVTcbOsmQFgqY3QE1zifZsCo5ArnsZ7AvzmFgSWr0BIhQZZN04GphJ4P25k MAlVPioNe7tH3wbzY+dHOXZ0w6JeM598x1earRzppqob8lKOkVZuRB9AjEQLFSPSTE1o4N B96gvs/dSy8SmCo6VyifX7/eLjKzDo/IngA+R0/XjEfwBGig+DIxVVIa4PmFkIFxOUfB2z BxAiSVLpJazZfgTmD2XwLARC7J2jZ6+iPPNb/ZZD/bWVt6wnOZfQN/LphF+S3w== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:00 +0100 Subject: [PATCH v2 05/56] kernel-dev/advanced.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-5-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=2521; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=20p+DU12kQUdyrlwBhgaMyNZCTPAP2A8bLP2wmg9Snk=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHT/MdYrt4ZpmwB9tHMESAmU1r5HA9Zn/F4tT rrnVGOVT+yJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh0/wAKCRDRgEFAKaOo NnUtEADOP2p6Pz7/5nvvWkC0+WgBtKsfa2BHFkBfiY7HmzEITH50j88DjHf95k4Hf1oZ6xgPcEU xSu/uxGJY2DKi9X5dEQ6cY+OKZEHxOS4h413xVp7FS5+KYJ1Wk5SnxsCf51meyPfWxzzKDlfqOg n6AIlGgfKp1yvcJd+X6yvR72ZkTkPJIxoLMkDefbeWDWfpkFCER71n+Pu8ITlc1/P1vs/Wd6lAN aOLP4wS2ADB8Iyl7BWc8dXGFYhAfNdUDuomLYnhQgWwQAKeed7Iurji7k2D/9xt35+ggXs+U3ru fUGq4aPKJg1mavMJYTATHtKuQFFRFYRf6ogaadLTuW7o28Ah/CyUvQIJ091ge33CqKVN1ty167x bCc2nogUtEZluaVGDrzNAuoy+Tysgi4YqYlW6HYyzhGze3jU+cC+GnSYYjhaUO94v9MkU1PQRGy n/FzajE7hdIf9rmp46KCMDR3GZgFIQP5+ZxNkz04n+elDHX0tds89h3cvlKMRdJavJHys/JI8yO Fbnu6LOhFTaNk/K1+UaaSuyjRakTOtFKPi9aGPcIHJcVSC6a/4bczPokUZMWJZiRGG2zksQsZnH SKifPYVxTtXnxHZx/KCuECHz4ztGIa/Urrmtr7UFjbd5m2kapyK3w2iRUkocEClKgHiWM42+Aa8 urHDwjtIiVS1v8g== 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 ; Tue, 27 Jan 2026 08:19:35 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8666 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. Signed-off-by: Antonin Godard Reviewed-by: Quentin Schulz --- 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 Tue Jan 27 08:19: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: 79772 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 19E05CA6C95 for ; Tue, 27 Jan 2026 08:19:36 +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.6043.1769501966422730209 for ; Tue, 27 Jan 2026 00:19:26 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=egKZ2m6Q; 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 D39D74E422CB for ; Tue, 27 Jan 2026 08:19:24 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id A9215606F5 for ; Tue, 27 Jan 2026 08:19:24 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id D8DEA119A867D; Tue, 27 Jan 2026 09:19:23 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501964; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=Xb/KqyYu1ExfKY3vJItZ6N6ZJAxYNUVj9wTw/x+Le+Y=; b=egKZ2m6QggWUjIAQrI4LsMTfF0B9E2ryGSUgE42x0H3kTBL6GHPLg6ZJc5wPE3shf2R9/5 I9NjWcdiozG/8cGoKTH5kAAHHXLFq2/5xyw/pSvdghFbkHBzzbWBrqTnd1ZqRanzdwfTlr x80H09eSF6qviZSxgWIE6uCcJPoVegjF8ekv+ulwIwZUPISaG9BVW5iZ4XKGiLqBGQuud8 +QOZJ6PfEZPmp1ZfvBQ9IY+iYcgqN/Fs+VaILgjDbRAabwObJ3plMfNussg4O1vFaWNtrb jAU+ZA2+bad4kgcTkW19ZVpKxSgGYhXYP7pOBydZDnONG+DW1Bisu3EA63qIaA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:01 +0100 Subject: [PATCH v2 06/56] contributor-guide/submit-changes.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-6-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=6180; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=aicEIiy9GfDZkO1Sop+H2C1lBMphjpLrdsO0zVXUGtw=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHT/qXrBY7GllsZZvADFJCAYsdpE+xrfo0GjU 2bVtqNeTWqJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh0/wAKCRDRgEFAKaOo NuA0D/9J07T4T740H3l+ZOkBqpt5YdxwwkcSdo12wvhWTp2XB6p9X5YcSwCH8l69/tFlVd2zXv6 oKNnUtJNn/ORBRrVooR+3sXyFH2oXGBLIZ38Cb4f3L5Bnd6RiLIsPdi69105Pj34KDpf1Nh7Cri ZAlJsyKU8OaT5Ob0t6OivRyZIwk83QgmeJSRs+T+bTgCDqedl+XIcB8c+W3iWxn2eTgFGiosSju LgWFox7JPyJ2PQIFEictnzaF4i9MhkDmRAZk8O6E+q+/Jb6BTVJzcQLF7UvZ2II8FIgDqE1IoWv yJGGtsx4ZPkHU2KmQU9pvC3juj/Wb4tdjJw/TwpkazaDzWellHvCK7XlFhx+cr/Dc/mQgBhnOHg M2FO7vlNrbOk/NQngZELh3JKIq9iwZYw+rgruw+WKIY/O5oH8PjYvki7ivuOjp5Ji9SHfhPyICK CwBLbIh+Ws978FQCOlmof2AsEQ4nB4oa8D0igSf21yG+wr5gMEl9nJXTMALrkYY2fMKu5KQMNmR 79V+GNPBSI070+aELfllM+59gaTmooCu6ddcVHTPJs9ls9EDBMeSmlO9rLQLy5XNachzDsnSixm i1/iET0VLmhOnvdXsF9DSIfym1vxfmZNfM6zB4sV9f6JnI3SUUPAgRDRpXHMVENy8jD6Hee1wKj aw2HGJny0k7Y+tA== 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 ; Tue, 27 Jan 2026 08:19:36 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8667 Remove references to the Poky repository, replace by OpenEmbedded-Core in most cases. Signed-off-by: Antonin Godard --- documentation/contributor-guide/submit-changes.rst | 57 ++++++---------------- 1 file changed, 14 insertions(+), 43 deletions(-) diff --git a/documentation/contributor-guide/submit-changes.rst b/documentation/contributor-guide/submit-changes.rst index 07989d7b6..4a4c60b41 100644 --- a/documentation/contributor-guide/submit-changes.rst +++ b/documentation/contributor-guide/submit-changes.rst @@ -429,37 +429,6 @@ 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, nor into :oe_git:`meta-openembedded `, you should look for a suitable layer in https://layers.openembedded.org. If similar @@ -620,7 +589,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 +614,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 +628,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 +641,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 +650,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 +825,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 Tue Jan 27 08:19: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: 79771 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 0F8B0CA6C92 for ; Tue, 27 Jan 2026 08:19:36 +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.5801.1769501967196018424 for ; Tue, 27 Jan 2026 00:19:27 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=SWiuCEPN; 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 4A39BC211CD; Tue, 27 Jan 2026 08:19:27 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 522F5606F5; Tue, 27 Jan 2026 08:19:25 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 8EE80119A867E; Tue, 27 Jan 2026 09:19:24 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501964; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=KrGSLod6/pF3KhZZTNTuzimytOCaLoIcbvZ9NCgkBj4=; b=SWiuCEPNi/1JjVRsfcVMqfr4IUWvroJURjORt+fQU/ZP4WCh4opnMgNCSAD3v7vDHfuMhV d8bI7SAFd3TM4p5gD7MilJCWiLcvgLWZ0ALcBD9IN3xV3FhLSBcLxDJor1Bo+k7hxOGMtn Nh1Bj0S9nNc9NcqiJl7Ky1JmvsXX/pWhOsAfI0Iryqy7CW29AneJkhJGouHAguPVo54nDX ZjcoRm4uqI0lXQdLUzKqLkm7VPtABCM0OTzZ41NV+gBoTCguumie8uTPXjJnii8Jc0tl/Q moqVMNgGs5OM/0kJGA24nRE9hjouiavJ1nHEki654AyO4u+j32Z8zqt0GV7tQw== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:02 +0100 Subject: [PATCH v2 07/56] dev-manual/building.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-7-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHT/nDjpd3b7swRhgO3tir+CvIzB1qX88DEfq ysTdWvpmJyJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh0/wAKCRDRgEFAKaOo NqUBD/sEFnJ5FDr1vU5sTtZMXFs91/wOXTlHZHitivQzeKnZd4ulqTOCTxqxhCoI+qD4nT0PUEh 3QbkDaTI6YN7ZB8d4sMb/Jg04aheDrMauE06zraC4aaxlyC2UV3AI774N9mqxE3jbKG9N2Nwedu u1McA8ejsay5Ar2j0BjSgrNRID4dy6Y+ymWjDg2cGRcn0FgL8xXg3O9lannUlJRio4PLQQcHHQE /BBpfSUXJdT7aHT3cEE+KRlhtueusAO5C4YLB0jV9S4A8mLmIVXQWT9sL9QlvhiYOCD5A2Iqs1u GMwT0sb8AfnCQptRFdXRVZ5ONxm0Xz0AtgZKux1K82OYvGO26ljTt8aH+yG3fZf9WiLJcY4Ma30 EtNsAcMN4G86SpZbvsII425LzuyLB9cPX6wfvlSyR0B2FMnCfLL7+EPxEqBqcFpfAHMjMRyE6MI ESU4A69waYMCb8mBOg38HM5B+vR0jk0Tho3kuLI++nNsmjiGgx7xe4lDdCr7Y05w3FgQtBAeNFK fZB2G7qxajfo8TrlVeyTgrGMnmEJcQ+cerGgt7RVlBxjS1gTrBgm/6H0PNZiKpsH+NFEGVMVYRt 7PH6bgjkNZ4ysjueG91yvCSKu4nwQiryjvDaloCUzq6BJ/bYEUs0Nv8CbpDU+UsK0ux4F6BP3fr IpZ9N+45//ah8vg== 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 ; Tue, 27 Jan 2026 08:19:36 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8668 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 Tue Jan 27 08:19: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: 79763 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 9D6F6C88E41 for ; Tue, 27 Jan 2026 08:19:35 +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.5802.1769501967719333408 for ; Tue, 27 Jan 2026 00:19:28 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=Gmd2qojH; 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 360644E422CA for ; Tue, 27 Jan 2026 08:19:26 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 0DBBB606F5; Tue, 27 Jan 2026 08:19:26 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 2F7BC119A8682; Tue, 27 Jan 2026 09:19:25 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501965; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=VpQz2X9a1/mJo9P8xhWGzblvjXHHwYgnSxuE76JQgm4=; b=Gmd2qojHBW7Zz7FXfwC9/l5YfAqUiV2u9e40IiSepQHIlsoKpAdnuEpB7Wh08PkeeO7zcV DAIpeM2saiMKUFPuR4ejGbRgd7014FSOvmoERfrTzOVfsbN9xTNJUQCiDdX8U8IjtVSWM2 UnVnirv2u0qvRiFawoPuz9DzP6uzbedI38Al0dsM/f9WNnk/yo3Wa9/mHLp9i65ZQOJt3w wNP61fxAs4ogMI0TdFfv8ni6q01UNMER5P1gT/h3teJukOTTP5/FHEINFxfXNNrC53JgFE U7sK4LmvRYbwePB9IOaNWuAmdyaSdOU/VCBAXRekM1v+SWIAYOqUb7eHPoPQWQ== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:03 +0100 Subject: [PATCH v2 08/56] dev-manual/debugging.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-8-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHT/C1jKbtmobhkrTax6BHY1SbfkXI4J1lyvX m+GkruJxaqJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh0/wAKCRDRgEFAKaOo NmfwD/49AfsDYNjS3MWwTZi3JY/0aHXdcuGS6DNzEf0a+ALgLGy+Z0CFUAnobfKze+dNtT0/IvC XZq7JS2MRqPWX3qbWWmLC3rZO6fqrN8BRR9lL0LMheVO9GcMluDY3IRvUgu7ncEpUZaemjL837L eVozW/uNUpvhC1SuTQC+G5HCmSHuGG43vYPwYxKEl2k4MEyKriTMA7Nr6kjS5TZHi1zdYWN/z48 6EJHDLtcll6uT7c3N3T+swuru7xtrDq+sbPD6oaS1AaOEyuRlNm46Yz7D5VreAKn2lu2fDT9Z2U dgRu22C7/V6/gNNEGCvbcieLBtGn/2O6gy6IGIdhJK3skqwQtEgpB/W+XWnd/woOFnzM3XkFbCh G9NOpQIZnX816UTcurb1C3gJ+4DQkgW7lmbp3d9uUlhraIqQiJLTVca42c2cOM1+Wr9QgMy5tmM yopJo+enn+kMyP8LOLEUDjbZ4VOzCJRHvo+Ok93xO4glgfmIu7xgMOb/luACfsofk9rFitWgvvX YnPpL0BxqV9h7FoU/djTA3LjveDV595sb3ypjY+Ydj2BV9j0DSLkGfdUtD+njerCqpj+tJTe17Z 524wupFlm2T72jiw05m8ZRXSSPN+kH1aWaonb5rrQqCVvMPEOw8Vu5pPCjac50Cf+ApnlJPrEgS UEu/se5OahEM2Zg== 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 ; Tue, 27 Jan 2026 08:19:35 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8669 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 Tue Jan 27 08:19: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: 79768 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 EA486CA6C91 for ; Tue, 27 Jan 2026 08:19:35 +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.6045.1769501968344162106 for ; Tue, 27 Jan 2026 00:19:28 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=IE86zHI3; 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 C5D16C211CE for ; Tue, 27 Jan 2026 08:19:28 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id CB334606F5; Tue, 27 Jan 2026 08:19:26 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id D8C27119A8684; Tue, 27 Jan 2026 09:19:25 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501966; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=RcoZAVkC2xd1vdNzm9mBNhC9lv+3H3WZEMwCWoDNULs=; b=IE86zHI3rjq5byMRVA3WItjFP1ubpPDMrSghnDURbr7bty+kMSlp4vp5uBx6uQptTyBMfZ vaHDasdIbnihbN8X2NzjJJRAC5Hz/cBx9zlW/9HpCgGcgg5g5+0Dm68FlLsTCHe1BSZvVV aO6IgMaGnb45OouwdKzUYBoJsyYB6nF2B1FR6LiqwwyjU47IPhzGg3MMKbk/WDs+3oyvJE waz3OCrhvt/PXgJuhlvUnq7r0nIFzCv5H32d/5B3bZ7AcfY5kLgou9ZAXpWQvFATHJSy51 5e3YpyWijEAkfCCW+r7pcf8y4jSvKbL4lWQ+D5Yv67QcVoDtDuuGNlm6KloAcA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:04 +0100 Subject: [PATCH v2 09/56] dev-manual/error-reporting-tool.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-9-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHT/NYCQW/HGwEg7EYApi9xNj1NtlqYPWjgBD g+hWQ2mhhuJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh0/wAKCRDRgEFAKaOo Now0D/4qAbpPEETa6fTV8V6YltruhtfK4smNWjN9hTfsZihAX6xx9SFgtFb9DbP9DUcyzorqFZM gDGcRMeM3LqmeOc8/SAnKuNlyw5CMGnrhbWVsr9rUSVZcIlRk7gfgduT3iQmP2Vs8QPGCfE8/Du L4vtGvQXGwDS7/PcLUhGKSnNHBZMvuUZD1eSzCjntMJHz0gHt7KKjt/LZv2RI/pTJHAl3oyP2Dx LStMS/LijeNENLLrgvTM7WvvWA0NRl57EmSz8HGPlPS2lx6RTDugp+D4pQvXo7chfzdEcltkr+D oXK/e6TTQupG+Oie5NTzj0tzQuiN4TVM2mPLB5pzhuXP7WPci4SXBm09iydt7oi3ZdwlJDdUboE jbIPkMkUuh0z2Yq8IYc55Q8oMXpkH6FcypfxudqxwRqfk0vH+Q2cOB6v/BaauNlxl34G4SPvVAv DAU1F+VCplrSTW7VquI1v4pjpz+IO2SRGRi+9DOAGd/v6nuJE7qATgjSBzEx2TDAZBuZOYhwb8/ jflj/itJkbhYDA/Y1zNXICuW8CC/eEd8fmptF409C7mGxU1KycUgTDletkMhnUE+TQES6cVAubc USW6HVwlrdOg/+Y+9epUwcI/47gxHqbmkJIwAgkKiUj43eOxYhHE9DjplmxmxHGpHpuXh5D4j+k o3uc4g4HWF+bA8w== 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 ; Tue, 27 Jan 2026 08:19:35 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8670 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 Tue Jan 27 08:19: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: 79766 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 DE68ECA6C8D for ; Tue, 27 Jan 2026 08:19:35 +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.6046.1769501969135134530 for ; Tue, 27 Jan 2026 00:19:29 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=stTbCkKF; 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 7FAD8C211CF for ; Tue, 27 Jan 2026 08:19:29 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 88ECA606F5; Tue, 27 Jan 2026 08:19:27 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id A5769119A8686; Tue, 27 Jan 2026 09:19:26 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501967; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=VpYKcDTTcogeqaCVbM4jBAFNeloASAcPE4C0A6b/u0U=; b=stTbCkKFuXx4cK8HQez3e/ZcqiT5OwTXkQs1B6sZG5W5wOiciqCjom10s20B8NK6rcjp1y Yj4dpzujbYBHuu8HkdZ0g6tsP3HgvbNVw/YvzkNMBfyMi0pM5wHjbujJ0vBVT4mb0IOLUE fpjSfAsOuF+BqsODFrkEziUAoOEpnRnWH96K+OqPxMFRD6W+nJ3gYcwYrRRJQAgmlQ5vlO 3inafwiEg8grLfrgfxjKjIMXMnjcLqcP/D2cUxcmWMj9eguVjoyAjELZxjJgBw3FnGpt9U QgsZqvP2bR/F7To8JAQGWODAsxPI3hGZ12NH9NgESw7sq+fjlUyH1JhkyzwbUA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:05 +0100 Subject: [PATCH v2 10/56] dev-manual/external-toolchain.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-10-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUA3aKqUhMDrtvdOwBIdqE8j3krzNeMBrMwN 2qfMcKlJvaJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AAAKCRDRgEFAKaOo Nip+EADMXlKBwF0HbBqaMMqjRBDAnKGzmnU4M+buG9zUxwRUyyGAA6y5oTi5D79/nkI/jsAHCJj 9x2qoK65rkXfgsJUQHBUxJxOxLKm+BlD4JdhKY0N6yakqDja9arq80UqKdv5xBXYtQlz04MTu5J eOtyVe0uLFhsaUR3v+8EEY4xsBm90zWXmXfJESXJpGhE08J7YzHA3L1DqEtiChX8qEIbo1DGHpD RRyNr06+kxXeYvS+D0bdQ59jG7mtwRZKlwO8tqnXX6dj/iw+VuZFv7NDtUeXXjnKrR66m5s3hWS xZqxM2/f0taucP+LWOSIVjactz4ycmIgmlcwcDPBIikFhO4zrZ1jhir1mubTflwxq9evUyz2CKd Gk9IEFhC5OzfsY0uXIgNUbH9ux2WWBmOt54UxYorGCIHzhZkCh00/UvcZOmhOO7rhC58IkOmcXb 4WyGaoZpBttqHPZ/WeQfMZYBPyZ0OBTVjqwzQY8/107BuH9emhB6Zf7S9oYff3wee6lBj/9VVOa PAWKapq9l4fWq8KAq0IjpH5cIZkBjDrJs4cZkogTydIUAzMayBYOuIhbcwiJfA7EKxW4GmBCMQK rCB2V32JXrJ3LFWOTgcvg5m7lEQA0EqxZ3Jjbd83A/Vff4ZzYGR5p7AuoS4AEp1s8dcTfWK5qk0 YpOjbJBI4oxAWHg== 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 ; Tue, 27 Jan 2026 08:19:35 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8671 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 Tue Jan 27 08:19: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: 79769 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 DE51CCA6C8A for ; Tue, 27 Jan 2026 08:19:35 +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.6047.1769501970209328204 for ; Tue, 27 Jan 2026 00:19:30 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=XY5W3KLl; 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 7636FC211CD for ; Tue, 27 Jan 2026 08:19:30 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 7C247606F5 for ; Tue, 27 Jan 2026 08:19:28 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 59B69119A867A; Tue, 27 Jan 2026 09:19:27 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501967; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=OzQrupztVInijv7pj6J/aVTic657EiRdHmrAd7y5Y+Q=; b=XY5W3KLl0/9ulPi0/MCaFXaDgwboxZpNk61bFXsnwSgRidq+9vP2bpP1lGar7ZLDNOubhj s9Z3JtQ/KyPk7agNm0pTR4ZDHQIbD/VwFhXhWYzYTzL5KkiD8YlVaqUCszseZzKcO28nbH GFGXDLCJcWnnV7sOqj40X5ybjMbAOlARUkpMgwNGVaPqh2PcS4K9rr2/8uMRcaTwLN2kHe LLRKYSqukNZDqreIfdkPOAyoMcTzZPOGZ47jH6Z4mQxzjbDsmLW8HxfQxUJ8AUyamrsvIf UH12Ln+PnYlDR8FppSHJL6/LSWsSoP39d1VHOz1ERndYokL9fWX4xrxR/jdXMA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:06 +0100 Subject: [PATCH v2 11/56] dev-manual/layers.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-11-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=20358; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=0U903F6BtcvOV0k8SZ9iIA8f88D0pasVWAwq/LXDf24=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUAC0jG2fa7QjBHRi4/I3FzmkCbJ4DFrNwtq JFiITyakuGJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AAAKCRDRgEFAKaOo NipsEACllFl8htkvmWntXi3Z9fRKUGrxvyfcAF7Ik8R9d1bEWXCuWZemOMIZfcSofojJopJFSy8 GuRy2ZcI5fZ/MVo1mHBRr9Z39emcMNxGVWiBSKk+C0ax1ju3yAaZZMjNyin7k0jkvK9AUiYAkbv q1LL96dZwg0Xyx+dr0B6j6K7GsH/7IL4h+PwKcZhJ6eJwZq3bRsOTJuVpC+ReIVO0F9PlDytQ2b K/U2bao12ZQ1n/+FVBzDvzval5xTC0XDr7/J8eePYUh5t7yIoxALNbInonLmkw3T+05U4C46s8L vNDr6NhiB/twat4LTBNu3h8xu8rPv3/EGiRwxfeh92uRsBpXLMDjGKqMLvSvm/B6mC9R0XBOFCM 2cPXMZp4ec80QVPBnEdXlMBOuIJ3XAVC5DLc2r1IqtqdxtVdVEaFdZaChDkdMty6o7fkxqkLkrz wmbSmfJZKACeN0HDaLr4qUdbZTSU4wD9Y5A23sjID1D0CNSV/IcLyMj8HXL4YUyluO1xv/Wvh1o Gp7h443wknWXD7icoZe9OFU52Ud3lqraYF3+lU3ZQhKhpQm7UvT1F44FBlgDchPdcR4hH3CVqgc tW9Asa6L8PBA4FcDCC3EjEtP+nB6qFSee3jY7U/WdQ2PY8vrYvDz2qTBLddUm7w0Fyd7kGoVoNt XCISu9DznmynxtA== 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 ; Tue, 27 Jan 2026 08:19:35 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8672 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. Signed-off-by: Antonin Godard Reviewed-by: Quentin Schulz --- 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 49527f45d1..4c0939ab0b 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..456e72f4f3 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. + + The default mode of the script's operation with this subcommand is to + create 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 + releases ` codenames (in lowercase) for which + the current version is compatible. For example: "&DISTRO_NAME_NO_CAP;". + + This variable is a good way to indicate if your particular layer is + current. + + - 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 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 Tue Jan 27 08:19: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: 79767 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 D06EBCA6C89 for ; Tue, 27 Jan 2026 08:19:35 +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.6048.1769501970553621088 for ; Tue, 27 Jan 2026 00:19:30 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=SsPsL8pQ; 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 0CEFFC211CE for ; Tue, 27 Jan 2026 08:19:31 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 1484F606F5 for ; Tue, 27 Jan 2026 08:19:29 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 6255C119A8689; Tue, 27 Jan 2026 09:19:28 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501968; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=8P7/HXxrqqJIzc0mRWEQN0+WhKyAmUPJJkdj7JUDoLA=; b=SsPsL8pQD7z0GQ+wVhZk/ALDgPgxtZgr5iF63IKCQKdtYFWJ9WSil4yTK/4UZnkVs8sOFv xLeLYS9xI6LG6dXHJcF1XGpPu0myeZPFNIwW2YBEBO6zMwOWJn+0nVQtpX970HtD1VbUh1 y6UnnwgYWgCS4QRYOfqFgy4DjJ1d+CsWCAd+7FbO9KU1kQauhNE07DiMOMSI2Bi6tVXjDY +0brAVvWg18l6Ny3mwRfQ/F96TXTAqsHzd2k2HL8Cb77xp3yCIMKNYeiSJWjToXSaMo+Dv F+QaJJP4HSabj6QVPXW3BLrCXFkB/3hWKBflrKeYhGUjzgJHL4XiiWrk9vzjyg== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:07 +0100 Subject: [PATCH v2 12/56] dev-manual/layers.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-12-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=0O0z3xXUK3PBdiJz/RdxKWh1GNAHX5NoolfAYEKMWmg=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUA59Txspm9+LX7jORxqRd+vcQG5SMuSbEuM +MTNLHnPs6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AAAKCRDRgEFAKaOo NtibEAC/lqTwi6S7WkPjw6mXi24Mag3CccgqrkOH70406F6eJOiKuCn6r4POH6zqlXCvAmuNvYf 3hkfO+pxJbhgPz1MsVs2B/59B2TF9m3rxUo4HNfA5vRUrNPCs2rxpkzTe4oRUIvofkcTVpaQrpp 1kFrcwquWArSGwChHaSw5xRyN4zQvNQQhvoCBPmw3DI/RARrfLxv748qgwCFtMmoGd2fHQ800M5 kc8NSP5iR7sB2BGZAiz/AjUDntOTqzcgsmcDP/XoWSc66Ua/zEedf6KBlarOU9Lh7WFgWl0M8Kf v/4c0on/l1zgurHmmy325LAKDR/IvkAUqm+ZqkMiNf7Js6/cgZPVaH3Zto3rGpi5EOB7yprzLpF Hwbh79UK6L8BbHrw1SfvaONJlRRlxYWrh+O35o8gW1srSUMcnPIVEMoGzD6514KIsJOKagAHynY ihOqwVcku5Ub0RcpE5Ls9NnxJDEb4cwNKiZyF7q3t0ixP0F626RbkmtRzfZx+Z9SJ6xczCLcqKX bEA7ke83bHFONrnezAA3b5cLkhBLsLoFVxEuDEPiTASZGI3nLE8X/Gv91kxmK8MluY5t2jRmUld az5epZ+mCjfBviot/KnojyER1eeh0/GrFW83rEyNNOZj2Jz9PET7ai8kgxo6CcdIubq8CzfxQb7 zrvzKp9CWCghVYQ== 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 ; Tue, 27 Jan 2026 08:19:35 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8673 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard Reviewed-by: Quentin Schulz --- 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 456e72f4f..ab5c258f1 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 Tue Jan 27 08:19: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: 79761 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 BCE05CA6C86 for ; Tue, 27 Jan 2026 08:19:35 +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.6049.1769501971530026451 for ; Tue, 27 Jan 2026 00:19:31 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=n7HOxbHE; 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 080DE4E422CA; Tue, 27 Jan 2026 08:19:30 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id D3111606F5; Tue, 27 Jan 2026 08:19:29 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id ED697119A8685; Tue, 27 Jan 2026 09:19:28 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501969; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=H+nLSLEZ2vBAjEQ1gjOvryk+9enXap0cDufOE5mnwyo=; b=n7HOxbHENVUzaUi1xgjxe/wfyCKr6PBO5+DtSIuKsC0TOH6CcAJCpNlJD8tcAyYQh5KXz5 Sh8JROqHwKKnS3HLS3qc66Ce6hkS3zmTMwGsGcdiKCufehApNwZZqxvuHSzylxBXDJNoL2 3CqonkZF0LPwhBh0F1CJFUBdl5bWTVudMYeUnfKGTdQEFv9yGyc19fSyuKBDFORzwUvVPn uE/rOB+YdgDo4Q3R/4oWlUuNTuyOwWmfbDUAZK8Cs9mjeAMqZNHy1ahfplOpd+bsr8m2ii DtEWDKUL9CH1mp3d+ipYlVoBxmhD2AVfA2YK6meaQuIEXjrF2w4MRT00VJ1Eiw== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:08 +0100 Subject: [PATCH v2 13/56] dev-manual/libraries.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-13-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUA8rshgrurX5uJZnTGpBoK4NfipOHZVeVcp ockxFExDjWJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AAAKCRDRgEFAKaOo Nm3eEACkbtJoJMP57ZvZQsggYMctvyCz2vRk09P3lquchqyZgvu/tY09vlYcyeI6PkDTNkw/AKy nXYqc1feB+K2DWHe2LQLg/InIlXTYU+ebbu+XM7UBICQAbM2vZR0ihY4zTn+WuREFogwB9Tp3aH dtRNcrHAGBlnFJgf/wH8IuQvztCuWii2+qLS+e3m5rdFTe6qKNWEs9tUF8on6TjSubawO/vydPT 2idhPpQ8y+jTE1y1Uhbu7+mVuOxBf3ZpJMWWOmXLUzM1Ijpsybkyyg2C/cl24toMAh1nZSgDtpt Hbn6kuEaowKH1Vmfpnz9U8NtF6tKrMj4mdC62fC9229y5WFKKgaVPNs1rRYtyixyQTl90Zf3Qp1 MW1hVUMlQoYBncl1YCRpp1iou+PdzOVbdRUHdK/39EMXRYce0qr0+1J1PjMBG/UMqUiCTMKAein w9ZvfXFxPCZ3zeORa/n77MNoakHj1qmZafZqXsDfyzEIon7DN1q+fHVxA5bSXqV8+760hSc6vHx T3qwXnNq9L2/QfB/dL/vFNTp0sHU1jdXRgeKUAWZnvAcf5g6L2SsG3onsWjVtpxlQJOfn0LqxF8 QlUmxXoqFeq25mOta0/yh/S7Vx0Zt5IpnY/0l4OQJre/oElAwNfYz1Euf/7m36O+cBGwrCvOeRY 2OuXhoa5PT+5X1g== 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 ; Tue, 27 Jan 2026 08:19:35 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8674 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 Tue Jan 27 08:19: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: 79764 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 BFF3BCA6C87 for ; Tue, 27 Jan 2026 08:19:35 +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.6050.1769501972511763707 for ; Tue, 27 Jan 2026 00:19:32 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=uktTYGNz; 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 0390A4E422CB for ; Tue, 27 Jan 2026 08:19:31 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id CF2F3606F5 for ; Tue, 27 Jan 2026 08:19:30 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 9E4D8119A8687; Tue, 27 Jan 2026 09:19:29 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501970; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=6shhbQbB1+358YB1pgfEFgbL+hjsQFGh+hut2dO4yDc=; b=uktTYGNzZ6ILeX9O6Qud3Wiv7efEGvRCMuJWQgV6TNpnAth+3IsqS7V0rLSaTfUzqViI39 O9NgW2i/MVcKzYjST2+jVkBV78gVFo2HHTK+yjEvEzwA9SS/zGFX/ZKRwBlZueF72bFHdB M+cebf+tiNaQV6kjSkKk11KKNKI+hLOt04pkHn/9YNg3muSvODoGJX2xnnsdioGkTbJCc4 8jwFCdhCS5GFFuH9QssHb+69FY17ylYGBUBWkhyK2mpW2ZFLuutDQM3Yyh9SIp9KwXlcss x+V/GyFlVT1XdPQmsS5GqEpDUJlZ2pH+wlJOemcFwQpa+n53l5Ehi8vOlPuEGw== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:09 +0100 Subject: [PATCH v2 14/56] dev-manual/new-recipe.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-14-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=3372; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=AOAMbnF92uOJnCejUugbDX63bCa7X2wVQ+k9LZ4I97U=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUApgt+qDEKuhFqvG9Y9xBZRPrsblGlBCNMl q49Y6re516JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AAAKCRDRgEFAKaOo Ni0ID/97qVO2UNiM9MDXFNf7stmtDWDkpsP9+7/ljYezsxcfcvpJxNHun2kjAUdQs6BXoLL2fUX 8IN9zJs8ri57Eo2Cn1zOUNFaEhoVeJE4bbPcCikiH9Qapvrx6aZxaOt34ieIxm29n9cSYDVUitt Kh+g8s2pzFmajVwOYkriNRYTM+yBiaKFtIWawypjwTNr/q73W7mU5Qdo+A2lRSX1L+0wuRMZLsN 5RLqZ2B3n++JWDhmjLn/kbqZZOj+UKSIAqN5yTzw7tbspUWFr6xHKdaZxipzQSgM7w1TqbVibJZ YnHg+VsKw/90hzzGtU8i2Kxw6hCPWtTOgfgCFA1s4V7yKgNezCug8dvdVZdowiVkfcGoATut6Dr RS0akCoj/+09wN6GrT+pjluD82q1N96GTf1KvX50tqfLJ5nFM/mXFGGSPQK1Mzs1mtapxbnknlM wuVSpfQNyWW07lDIqMjx1UTJzDVKS63CxFOFs3OhSrujREgmneRMgsw9PusMa3syDDy35yztI+8 4JrnkoWstxaablqmRlU6BkHw/OCfHZnGwQMSVdGkvU0LUp3lWGVG+8dyOSUJfzQq+iUrwP1TN6U C5W8COSwb4o6hb31Q1KCs3nWL3wV0Az2IAA3zkbCwn5EBwB5n5FucM/xYfT31xmnucp4p9so6FP d2gfbzGXjF1H9XQ== 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 ; Tue, 27 Jan 2026 08:19:35 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8675 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard Reviewed-by: Quentin Schulz --- 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 Tue Jan 27 08:19: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: 79762 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 ABA7BCA6C81 for ; Tue, 27 Jan 2026 08:19:35 +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.6051.1769501972986675487 for ; Tue, 27 Jan 2026 00:19:33 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=aly9FcHy; 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 798FD4E422CC for ; Tue, 27 Jan 2026 08:19:31 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 514DA606F5 for ; Tue, 27 Jan 2026 08:19:31 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id B42E1119A8688; Tue, 27 Jan 2026 09:19:30 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501970; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=IcXdbt79/410N5QzzJOp8idRKv1H6tNkByljbRMlI4s=; b=aly9FcHy1G78tmf0fwmhK5PmJsASQP96ENYq91gpyHpPop8qfj1ObFaaojKRxwV0y8h+G0 RY8u862d6T+oPoF1X2jgtEVR32wRGFJUcU2vgDVFgiCCprLrq06Oxw1/ibSigFJBsnBQSN W5zFr0mrg0p68EuD92LDiptoKLh0hs+oLl43d7oL7gBg3jsas1WIHNYQqAl7PsVlm+VklK e37lljwIOJtc4H19pmXLJtWJrkIBbcHf7SA4hfXy6CnO2iOJAH6oWzl355TzaRHe7lxxFJ LQIjpEAaptA5UU6NaaOOsr/LW7HnGHrKck7cqNutUKc3zLtbd2I7+rBuA6pUmA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:10 +0100 Subject: [PATCH v2 15/56] dev-manual/securing-images.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-15-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=1702; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=Ma8OOZ9vYsClPrK4RjEKzyyVLXCuLWYC9wojjB+mWyE=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUAQmEyqhbeHexxjVtz5dBeC207B6xbue1+q G19aEEYja+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AAAKCRDRgEFAKaOo NpR0EACl9Ab06G1zqz0AYli4+oGSHfAjb6sYaBxuKv5o/qC/MyvBEMHsHgV8qPzuNF9B7t8mbrp 5BeerSkDYY/RWlkRkbtZ3rtycUrMJr2pk8LCLeDHQBW86dlwMUrKyyyzb8eEJnZn4Hk1CLxXJT/ PtUsFDxGDjGsn2XrllqpKL+ll9X7WEsILwdBwyDOJ0U7YJh7oaEdLQ/LRmdqcK3ondPErUjq7xC SPRYJwqTzC3QYXXoJoMIa+rRmsglb0FAWZoKyQyfD4yK2Zd6eBeZwc/1mjIGAJhp6GhTKBnhxtH JbhET3UfzVZRrwAjaxRpk+aZPJTlowr6ds8DJQgOPEZwgW92oTj07yeGdhLdsz+nAzouxWGfA2L UWj/Xbjd0MfE5jXU1ALMovTd0xy4bzSsKDvEbEgf4NkWDGjCz9/0MeXryNL/1zQhYWiHSk+i2af LQ+dGiiZGAV8Ij/v+AW6ICEGBRFfL4ymMdx7OFEcowp10rdpVG2Fqj+JxmZWJOhCRKPn3f0GFJp wqk+eLTBc9J9MDMuP8v3NUO2lcTb0eYy1dtxiEkzw4tBofoRCan4iZfCAygq+aV29r+ot4p2wtG mu2wKSdRR2Jd7sk306TmI0u6BtqMe9DoUJPA8LAGUW/r2GxwJ9Dbt2w9u+B7yuV/xKCpCYo6JaB MJk+IHfSk9s9r+Q== 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 ; Tue, 27 Jan 2026 08:19:35 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8676 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard Reviewed-by: Quentin Schulz --- 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..e502f83e3 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 `, + ...) from their upstream developers, 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 Tue Jan 27 08:19: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: 79765 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 BCDCBCA6C80 for ; Tue, 27 Jan 2026 08:19:35 +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.5805.1769501973860785626 for ; Tue, 27 Jan 2026 00:19:34 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=yqTrE8if; 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 4CC5FC211CD for ; Tue, 27 Jan 2026 08:19:34 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 5513C606F5; Tue, 27 Jan 2026 08:19:32 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 375C7119A868A; Tue, 27 Jan 2026 09:19:31 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501971; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=+KIRsq1o9ehnryYo0s19dvtHfW+cKglzZKCzGbR6OmI=; b=yqTrE8ifncsx9oxze4eZokMn4/m4GYq3wo/KSA/7L7CG1pNlE52FxvueqVW9o4dZDlIqvV ovvhNL3+aRdf99twvgB9nFYPpXDK7yytBtUMI6pbxaDN74FbPqutUvXSkb1wLQ1rpzToMj qUmxAMCTjVGby9sJlzugRxzqy9pDc9Y9MqhAN9dVu0wykhVVbpz/+uKBRx8P0daedaiuZB 9MurCWqkjMCFTEj5KAVvesfZlTdzuOy2gPj+bIzg8+WdbkQhGe8nG0i5NanBxeTCTtVNbs u2V0WYqZgyeh8lLuEa9svaF66q+XUoD9gQU6cKz2Ph+IcW/5QORP88eETCleeg== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:11 +0100 Subject: [PATCH v2 16/56] dev-manual/temporary-source-code.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-16-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUAe9gs1P5hpUMGutpl+NnnilVMrFs9B+ETk rTuGokGgEuJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AAAKCRDRgEFAKaOo NqGED/938yqr2DzJbuTZIpS21L7zYvq/rmZ+lopzmuU7WxfQVik8OfalsksEt3O6mT3UNgw7MD/ zP2EsL/QX6fg5HClyj4FDWGnsQoBXgW3qys3Tu2mE/GJ9bYyqEvw0L3otxzP6R0pwjJpvy00WF1 FkhImJZ4cWgl21mBd3cpOvjpu/7tSGXSmF9KPYWPkF9pu+KdUX2ATG5vcsQDx9HCsNmu3o1PeQ1 2UpnD7fMPJ6OCx4j3sTelvqPkWnLCu6hLEBbtpzNmd34cWcdvg+H+0t9SQXZ1w0SgY8IyFPI8Ne CKN/aJYOag63kUy7qNnAWiDWPLqszOTTmabnQXO5kSLncCQ/dsFjKzLlt60tLcktIfrj51P520j 6ZXgxl0u3Q8aBLHd5VWWUz67lt7P/Muta78JQHRt5o4SDacnT1v8VEzeEVWCS3vwLGjuIWXkrrY EhksJlbRWAxLQ4s6omobI3vHLGaaTAk7s2E3lXvew+3DalqIAO+emhVwAFpHBwzIdacSiy0a9FF kI9BMRj7qpK7b6x849C7whPN00V+mtk5sf4SibCA1aaLESGrzbM4NdtAx+blgv3cFBrd19bW/Rs xVMw97PMYDB1bXwzVsvdGri9V5uBWF3L6K/VYFLwhkC1lrH/55XQxeRfYOZF5nR5V2LYO+l9lY1 eBhU1EmhoIQ9e+w== 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 ; Tue, 27 Jan 2026 08:19:35 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8677 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 Tue Jan 27 08:19: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: 79759 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 91B30D13C1B for ; Tue, 27 Jan 2026 08:19:35 +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.5806.1769501974596301727 for ; Tue, 27 Jan 2026 00:19:34 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=Eg1B2oxm; 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 225A11A2A69 for ; Tue, 27 Jan 2026 08:19:33 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id EA84A606F5; Tue, 27 Jan 2026 08:19:32 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 287D6119A868D; Tue, 27 Jan 2026 09:19:32 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501972; 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=Eg1B2oxmTIQYo1XKtECIPFlWWYVUsZDDJJQWraDaFjnje7c+81kMhftWxfOn5Gv4Mhx4+g mYJGiX2DmKEnYl3KsMrIqyPezp1GOpe02bd+TDMx1IYdG3GxSmNXPrIWqYJetnMUK1G7f8 aupTL29ghXqmpxOAM2BQEmvRbjo50DJGideW4f2rLe1h/QJMz3+mlGujHC4FFJ63HbW/Ac YcjJXL6tVrHjZIWlVKIPQJ5eB6ru7v1hpRSwDVF0UEsUnspZbAmaZ8+dthaYkXh1GECk/s +oTC7qHAisRUSL+25BDM++Yz+MRKv118zNRH79ObWyAum5kFQ/zzB4cHpwU+Rw== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:12 +0100 Subject: [PATCH v2 17/56] dev-manual/wayland.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-17-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUB5HtZQW+mKY1fp271lBzGOWe1r8YhgBdNd 0lnspAYTBmJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AQAKCRDRgEFAKaOo NhI4EACaoKC+aj/7PIfLissVUzzxjBSEyoZsT1C95Kn2zgHISa53h/ggghJVlF42t6s9q8rND6Y VNkZSYXa6fjM+uXJf2LtXLAavB23+17sBAA9pZOuXgD4Uh8ZnlA0Byi+ovCYrhUnnwgMl32rQ4N Rk+eYWBa7M5ugDW3oBZY9fDLJEaUqHsUberA4un0dXSg3c7etE1H/4mw3OiLrkdfC8Aola2lqVT FG8aRimgaLyBaG60XjHdu/UlWkHk8g2wbFjeZvTw7WUQ2icJfMEvsFBOc+F+8emBohFDfZIh9gh Yz7+vS08oscmTMCSAbu/ysNu/cG38p/Fu2FIOy/cG7DgQZy1ImF8M/14CdeYUU57ylvRTlOwIq2 p6GGy4G4DxvKdrAinfC60UzoOEbC+3b+babeShp+y3inRPzo3HM4iKvdXuyCBP4LKiKBS0zQp0Y jxDfZUaqIpsp9JSihE2x/xBKlQaUI/v4dJFtC4ffYw8e1c7aKzn+YphrfJWf13lqD7+e5BvTE08 P8r9icVkclsDNCY+KXzSHwe/JCjGlxKuunzKkNJmA+OeDQjcHFs77Md7DAd+0uTw8ljrHWP5IR7 gTwb1S9nlns6+Hgu3IlFw6qb/7Z4eGNpI1FZmwBVHU8uByhwh5EDxDaBHCmCA8YOQmJi+bz5JVw A67J7MG0AMN78KA== 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 ; Tue, 27 Jan 2026 08:19:35 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8678 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 Tue Jan 27 08:19: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: 79773 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 30840CA6C97 for ; Tue, 27 Jan 2026 08:19:36 +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.5807.1769501975418578803 for ; Tue, 27 Jan 2026 00:19:35 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=DgEP4mTk; 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 E8BA01A2A6B for ; Tue, 27 Jan 2026 08:19:33 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id BF8F4606F5; Tue, 27 Jan 2026 08:19:33 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id C8943119A868B; Tue, 27 Jan 2026 09:19:32 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501973; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=19qBEwJxk89ZRVMrPmHizEc+7MxuLKke5SehpzMSZUc=; b=DgEP4mTkHGT5NhkJzKxnjKL/iIHMmqolpm2we2PRHWLuARUtfMw44b94lq+gagvYyiuEWK 7TQ7HILjm5UWPy7eNgTBxsLfE5aMPCIYvjUWG4rFkUiF6uLCQmc5FmJbg8zGogcnLunhGK GKnO63/7OT8Opx9LX2A6lF8fZmSYkJyT1NLfS8+jp+oAiSUAzNVQnOreDY68aBNy61GC63 XsEjB+KVxs6mUJDDtDhkiXWC0Tnl08gzPjYKeAjj86yltrWAfw1eVV9oa479fD2kiArRVd BeSOYp3OtRizBHzXTKz8TiVBBkBRS2msBjenQT9IIEcywHuqmvsY8ISnRCVkJA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:13 +0100 Subject: [PATCH v2 18/56] dev-manual/wic.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-18-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUBpBCIKMWykP7BDyHcK5luuZDLlM4wfMA5k rgH1OIxI2yJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AQAKCRDRgEFAKaOo NsApD/93DTNkYlRv6gb42Jh2FiwdRK/8nLI66Al0lEaccolwpsHXA47GGiDWUlDZEdnYxiMKNcm miKVLpdW8CaHW/sWhO+UBadfpz+VmcXfswZQuCV4F4ijc1VeZ6UuhozWgqNSmzMvwXR4x3HxGbD Ap1L4gc9HWcvPVef/7zYGX0Y1FsdLOgaViRpyX5nsrPMkHgF2/DhFwQ3oF+7TVDLSGCKWgMiisZ ZRrajc7TaAW7/gzAPLlai1dRYm9BEJRav2hptm3Tv1hnHUg1/DSW9DveKLJsIXXXNdireHYgxo9 Sj/ol5XKGaz2RHWX8quvmw0vZgnKrNmn4Vt/5o4YobJ1/0YlCAtSa4GEhIYIeeBpKNp4yaOhqgf DOGbRveRVvy44L130GIMfi307/12Q0P5nyR3iJn2IkN16m/Ji2zj/JVFh3sOzvWp9llScQ81ys+ TlGkd8BEZzqXAmCSewCWmuBnQpG/VM9fbVbT0RepfV2JFRIdwWxjbg3d8fkdiffR+bS2+00iwIw eiO5IMwKFeGGL7ZffuVF+3LMi5t+cInMklqIRRnCp+mRmCPS6yWcT4PptJWovG85n0uAMmNMVdW IBauQeyCnrFrc3Pr8IP2GM8W8Ikp1s8lnkuQHiXZ05mU4UfKR0NPodxJD3ypYyWrMI0VbStPfyW nXzLKD2R+45GbRA== 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 ; Tue, 27 Jan 2026 08:19:36 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8679 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 Tue Jan 27 08:19: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: 79775 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 2E2B3CA6C86 for ; Tue, 27 Jan 2026 08:19:46 +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.5808.1769501976177344168 for ; Tue, 27 Jan 2026 00:19:36 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=V1xrUb7u; 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 9E17C1A2A6C for ; Tue, 27 Jan 2026 08:19:34 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 7446C606F5 for ; Tue, 27 Jan 2026 08:19:34 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 9AA4D119A868F; Tue, 27 Jan 2026 09:19:33 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501974; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=p/7D2Kwc9KAnogfj73kh8IWG2nUdpk4PuKXVKagn0zo=; b=V1xrUb7uNu9FXLVn2Lxt66Kge8xHnNJe7Kxd0MY/jnl1cJXNYYCHFdMBUo0V34LJZmIIe+ u21IFxYj7CNxbwp9Ii5eYmYG8AGT4sWo+B01bUTt6+CPcTV6MOEPj/1DETWMJhU1ldO6DV 5COCgEbSY73jgD/IXckESV6kZWh9r1BP2R2rJdoyO5CAH9Ijb4lR0s9kQpL26ISfrBzB0K YF/NFgZkX6EUFCdxtAXO/4c9ls7kC1I5Zotr7N5nE+SwsD2r7Tgg6r/SIxAp8hik1OAUAH fDnWycZxYP3KuFPuqfvtb6HQ3yHHggSmu4PhH8c1Ps+/KobbGMEtvDk21z2OVQ== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:14 +0100 Subject: [PATCH v2 19/56] kernel-dev/common.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-19-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=14965; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=zsVqUF2yiH0Rvx1/WfXNXEyK/ahT59ANiA1bH1xLuBY=; b=owEBbAKT/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUBZVh6tJOVji/IXXxW5fPQRIDxxunZ9nFQx 8wrNFvRYvGJAjIEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AQAKCRDRgEFAKaOo NpPsD/iCaSVg+1xJvV5S2J8P4ftzyecNS2ZRQV/DsL9B/G5Odw6P+talqIze67JfYITeQtshWXk WEOwDE6znO67+I5jj5Sqsrh7YcKZkFCfG8X/NtNfxNd/R1wEwKFA6wVYBUUKBaHNlAVKA2xUc4P m6htSol+y5IQBE0QB9vMWRveabgGPSp9CNWWAm+xKmpFAoZ4wBiidfff3ZZPchI9lLcNHnvdZ7H +3sDJVMXfOIioLmMcxL8toDhNcGsQzdYayrJh+XuxqEvttuozx6WZqFHx12AViqe2KcZw8hAe/T +RwWWEKtswF4g1QMBrNxkbshGRegVK+zOF1VEqL07fjV5jUOcKm34a/kAK4jdAJfu2jVTi0m+O9 UBA2cwydZo27f+rK+ERA5Me2/ArV8XrVWpVwRDV4h+GBTyLYdm32Ul3gRcW2N5v8CD8FZg0zzuZ NcIC/nREshFMM8C5e9gZZ6agjna+QSuGhS72neMoVI1geZ9psciJ+/G9ZgdBw20l9UOTshrtABU SlsDVsLYeZesEOJtt8oEt6EBfZ9gqf9C96YZ0nvx7y4HGH0nXCnL1lcx0LEAcyINXgDvidd/Xr8 0tBkijgOYxzd3Ihe8Mrj5C+xoRi92QnEBQQYRQHjJPklkWGVprVgTly1BU6HRLeAv7iZ/9qoVkO +xebiN616/xHb 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8680 Remove references to the Poky repository, replace by OpenEmbedded-Core. Signed-off-by: Antonin Godard Reviewed-by: Quentin Schulz --- documentation/kernel-dev/common.rst | 112 +++++++++++++++--------------------- 1 file changed, 46 insertions(+), 66 deletions(-) diff --git a/documentation/kernel-dev/common.rst b/documentation/kernel-dev/common.rst index 2142d31c0..a653d897c 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,7 +69,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' @@ -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 Tue Jan 27 08:19: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: 79785 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 899C8CA6CA1 for ; Tue, 27 Jan 2026 08:19:46 +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.6053.1769501976767665894 for ; Tue, 27 Jan 2026 00:19:37 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=LXdV99ea; 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 3F8864E422CA; Tue, 27 Jan 2026 08:19:35 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 167ED606F5; Tue, 27 Jan 2026 08:19:35 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 5867C119A868C; Tue, 27 Jan 2026 09:19:34 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501974; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=+2xjNaC9b/ELtYqlQzSPG+Jc5NL5biO7pMHI15uRHP4=; b=LXdV99eatVHs+bBqww+FY2r1q60kQj6TWzk5dyKjqNyniaD/JxPlkFJ74FUzph+eguiEwC oX87WV84r1CvGYQVS1cpCdyTKsMe5k90Xcv5W+ghkkz414N8v4lhDf6m7axDR370C85S9y 439hIczGTLQ5McSo/W9bC6joF/RQ939ZPmyvII/ojqm11tr0v4uuFnINiPSclx9E0zO74f jutzTfX+sU998Mv7X2cN26y2hYiclAmZWOZfF0I84d7rV8vMccKQ3j0994kFb6PnApKEjQ FtK+e1yhqDfDwXoodm7XfxNSX/8CnfHGKxKVGRTfevTrXIxSUmfJmI4kQF6a0Q== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:15 +0100 Subject: [PATCH v2 20/56] migration-guides/migration-1.4.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-20-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUBnEJqMjluJuS4ss5TRUEVBifRBVSjk23mC x2WGFyxSLaJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AQAKCRDRgEFAKaOo NmBLD/4yBIqmzCUTAS68gTf/7lGTG3usG+HRtxf70IgGfNureFqQ1x79JRCAfHE9rTa27LrWBLO fegdmFqJ3svfRbIjor9hRscO3PKoDKpBQEgIoIbdL43lYgnr5PdLP/b+Mgy5K71RffFbs/yPiUQ o4pXapbQEEVGGJdUu+FAagW22myHstr+8e84jZyvn6nlDbm70Ft3Y4IPEtNR8gqi/x+LCgz9opv bsAleADIFbcdZL10R4JFiualxO8X9XN8tWV/q7OD+iYn79Q0itV+r6uO7BMTPiylnw6LFNs31Mt iN474O2NgSbeemoKKrwisuSlDU8lhdxcR/yuYBi2q3/ydW632qSeF6oBSlx3TX6vyC2bL4SLRkb /THridV/RbhwpwQRaHJMjYjZmxWAcWFHMRg9erDX97XTdqwkvaXsPvdfAOX9p2LS0aGsSrcEVoz O5y6eJ8VyJCXXdsOtZuFuS59lo7QNelQsyM5V96C6UYvg1yVgvsLiGzmXpKIYEclT1duciFP/eN RrJUZihLeGanlOcQjdjriZJ4jFHJuE0+b9Q++Q/1dKmaFzGXKabHL1ps95DVMT498481Vi+4cPM Bmqv6tEY4k6JpVQrD/DN8QAjrW1gqv3JFHWKjy8/ZH1riOYVj1z628hAYDIz9sLmcwarBdsbkgv ZjOiuFRpYbbqqOQ== 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8681 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 Tue Jan 27 08:19: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: 79787 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 AA084CA6CA7 for ; Tue, 27 Jan 2026 08:19:46 +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.5809.1769501977484565207 for ; Tue, 27 Jan 2026 00:19:37 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=beuv6Pbd; 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 EA21B4E422CB for ; Tue, 27 Jan 2026 08:19:35 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id BBC2C606F5 for ; Tue, 27 Jan 2026 08:19:35 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id E45D0119A868E; Tue, 27 Jan 2026 09:19:34 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501975; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=Pk7uiweiuH52z9GmDq9QvN882iE5EZWWlxWLg73HIT8=; b=beuv6Pbd6IiH1306LcCl+AxROFn6mySVuUfXGI6XpaHcu8XauqClrx4IUgafBIraIKgQUG HH5uJYDq6fd/4trwLW85UIIMCTAYkAvBcGJaS5gc5GsM340XYFuZJYXTKlV91LR4fGgvwC wtGo1N/I49ST/X9BewhNuu2xdEROrR6YFonPiBY5GQz/ftiHfvyF/jIh7AAKC5EjnrcNsb VDSBd9VpBY94yB0pdSZKN3w4XdIATJfbIKtyUNFpALQ5ZHncRo0nJDp8vYpQABREHwo9yw jczF92SbIg8Qd0m+cL7f3HQZb22/nNQtK8Peg5Ic8f59YhSJ3axt5r/qeniKYw== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:16 +0100 Subject: [PATCH v2 21/56] overview-manual/concepts.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-21-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=6360; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=0S2EpHaGIDkeA74ZjeDU3b0lZt5pWkgB+5QUbTp47TY=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUB2QuOYMpZmcsCehb/BsgvUw2wn+Y29brjo ZvCECq9m5yJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AQAKCRDRgEFAKaOo NuI+D/0UH7m9Ciz0LOmoIElU8FSWvidvEgoPCMLZBFQkI3zoPTO+8mWzlf3W3q9wq17K+6klMpE eeyo8uaMdIiMjbW7Y5vBqdyc/8HFCHkJBkAeEjgI5z6U03b0eqPaFx0mwQTkAluxu9eVK4MuXIG Op+SCX09FFNQcx16v+6zBwmuQNIzFapiEQjrJQQ01BuKBstVnCLFfkffglBRJeV0OvtkLF5eLZV qNHoLtgTpf7Vh73xElAVWE1BiWtnuFwaoex8Az7o9Tw+QDC6BfZbZvJmEaCppMg9MW/CO1APzQt bfR5q+PMZqeGUE0QdcfNMAK/f6H7SGH9n/wwYXUwXTdNZDNfs2YOHP0Hs9ZGGKfIakRQtnYQNWe EKOigrRuBXroFtfy9aA5459RkuXTwhzRTmz4BsFY3ulKxZPEn+qoMQEMDmt50g73R3I/+68IOMQ +Yx4URz7BASmwF0+yWNnozN9MOY7Q5c1K/97y5Ine9bWsU930Ua2vrtWbOH6HNCq832TpL5Gt9M YvjaLU7l+DHVzauONvnvunuASJehOyfrcf0N7OzGTkP5tW6l0y045adiIzCRrXvA5gjGH/dR4nW XjbCKpUyFFTS6UoSg7jpQPm3k4yftD/FDvsXJn+blyIhLVWRCOvX/R6AMaBi2f0SqN9kcg1RY3w uPSaWMB2mt3///A== 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8682 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..757ea05cb 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 set up the :term:`Source Directory` to be named +anything you want. -.. 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 versions 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 see 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 list of a few: - *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 Tue Jan 27 08:19:17 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79788 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 9A184CA6CA5 for ; Tue, 27 Jan 2026 08:19:46 +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.5810.1769501978047604639 for ; Tue, 27 Jan 2026 00:19:38 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=MqvYbMBp; 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 7E8354E422CC for ; Tue, 27 Jan 2026 08:19:36 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 56177606F5 for ; Tue, 27 Jan 2026 08:19:36 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 9D79E119A8692; Tue, 27 Jan 2026 09:19:35 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501975; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=yprqzKUJqVi+aeackUxxBOh1gHLWlrND5bRwnFpgxUA=; b=MqvYbMBp+KTbP+gjn0t2+/cPXuHothDa30oFNoqsiIsYNJxyJ8vWDk9Xpwrol6j/O7743A fEASvCQWiM2BBA5/tvzT1cNlqffFSpYBlVBul8YC+rMyzVHf0xCbhvQwHDmZvnuLD3W0YB fEGy/D6AapqxYCRkdD40F1eFdQPQ+H8MyO8mUEg+QNA1zsIeECZVwyW1zXRZkV8Wm4UQaY E8tZ6kno7YAWf6pUzcCyjZzlP8ks7DS+htbZ/k3TJYrItN91Wcv9ZGbVR3tGCoorLs7R37 U9K7gxUU+glYdLb774i8m3SIhUcIh0GQxfmfaO3Kirgv3RMS5mHO5PxiCKalzA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:17 +0100 Subject: [PATCH v2 22/56] overview-manual/development-environment.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-22-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=11672; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=hsC5qVnDETT09avgfyIftj+Qw8Tl5/PMnS+xtt+zNcQ=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUBTlUFCM1tM77RiNR+NafRe3XoEylNMFqdj VZKIUbYYS+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AQAKCRDRgEFAKaOo Nl3CEACKqxKPyNVtY60/izDk4uA3qXKgyyIY/UvQ1L96sZ+cezR1TkKCqdYSfI8Omk8MJuIzyU8 nMrtEj7wmambswumLh3Dlk5xuJ6UlhIlwkWKw4TxEs3QxekPaOd0Jl5SPxhaFZis8qiYFf8PmXC yHpiCG+T6Ue+KtqV7z1GJw95R/E2z38+Nmbbc8CA2AWR25o0vZ5AlTQcddO6MXdd436cablhV5J ZuLV2tOQoYaINsvcuJK0s3PNH25lCL2RYqyMJ9mYajc/3E6Kr6sUdgoFsg6i0YiCwWCPgwpQpOn AN9syPiVlhyP2VgiDEbYoLjPv5eSQllAUmgtr2KuyJ6le0vVp23kVIql2DzPNePf3h96Vky+2Ab lJsip5gcnaKsOd96bX7YAfXABCUClRgRnSktxXhSLONehXpqNCWNXBnAa3PmZvihXMi9rYnAe7z KiVqVdtwcRE/AVAROcQoa25O9RjhD5zrPv6++YxjLZQQ2Cx+HEUd/zNJ61Tk36tvao39spAZWZi F+QBiR7UIoJ/qvEuYZEA6totAI1jKZEN+LzW3xkfZPjH0vPgqVkYePYzn44zEKfrjlKAgKEBaPi PubRyUPlnOSzsSoetWK0VFi45mv5LoObwhSHjpKXRjDTuQQsBYyQ3SiOPgJhwipgxkw1P7n0UiV uJwR36IC7HKHZcQ== 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8683 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 | 83 +++++++++++----------- 1 file changed, 41 insertions(+), 42 deletions(-) diff --git a/documentation/overview-manual/development-environment.rst b/documentation/overview-manual/development-environment.rst index ab9bd084c..0402e3456 100644 --- a/documentation/overview-manual/development-environment.rst +++ b/documentation/overview-manual/development-environment.rst @@ -148,44 +148,42 @@ 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 +- :yocto_home:`RELEASES page `: + The :yocto_home:`Yocto Project website <>` includes a "RELEASES" page accessible through the "SOFTWARE" 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 @@ -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 +The Yocto Project Git repositories may also have upstream +contribution Git repositories suffixed with ``-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 +: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 Tue Jan 27 08:19: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: 79783 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 40767CA6C90 for ; Tue, 27 Jan 2026 08:19:46 +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.6054.1769501978861621761 for ; Tue, 27 Jan 2026 00:19:39 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=0Td0f2OK; 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 4B43B4E422CA for ; Tue, 27 Jan 2026 08:19:37 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 21599606F5 for ; Tue, 27 Jan 2026 08:19:37 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 3BCD6119A8690; Tue, 27 Jan 2026 09:19:36 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501976; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=MEzIPMOf0+U3AimmmL/syUpw4P3VDPb6gElTHl9jgKk=; b=0Td0f2OKZbuRMTdP2QHr7rPGXTQBWaGGDrT/yWLVpg95gXx7MhgmZued/+aauKqoN+yrHQ ii88rKRPiMJKy6Q3zP2FEn7lRjL3Fkv/0o4po+McT1bwoPIKa4MT5ZIsMWg3IAr+S3I/LH EW9lfU/eWp2w87Hgg8l6jo2En0jC82Z5NbqJBSHoz9p/pi+SSVK8wP1X8R1KGL6QtsaKRX WO70h2L9PynQc7E6/bjKLMvfltIzkVAwFG1nert1DeA9k8RZEq6AClC5iaWSQOpXdqs4vE 441WCclxqKUl/Vr0bxgsfVCOqm5iwttkKir+sqyTbz9YghPWoqv6pr8MDPlE1A== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:18 +0100 Subject: [PATCH v2 23/56] overview-manual/yp-intro.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-23-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=43571; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=LxibfBDKpfuxpDGThRely04nRpi+ttpyA8egx30gCRk=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUCYk5wpI3cD4XeCHehl7oEejaiycsVl6F3+ t8EqvSbrZuJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AgAKCRDRgEFAKaOo NjCCD/4m2APtb4ens8q/YDp2rj3Es20+NvbeMg5kPf11Ayfn1cZMx/ao2jtc9sBJINmpXsjNLNr EriXYTYtJVKFSf5ae5i8KBvw1pv2u0FNwTFuzKiENw++Sxenwf3XbKTIje/ObL/gXQo22dj+pGA ewOEkecS2V1Ru4jlTWsYtSC+Bnd8Kg5USrBFtg8idz3FWOpYN2EXExb9wzV6LOI8v2gP5mI9hO2 ViDghA0rVVWGQJBmIhzcpiup1DLBqyUNcQkQReb+DsJElpdSzMhW0H3+iXhDJJhYNMsrR1QNEHy SoJzZruVfPnwyjWm/ar/T3nUdv181Cmmyhd41dvpokFBg26oCRaG1cwpLQZeL9vDj7rLO1rBAiB 8Xnz5i1gEzV9LuwnPVtpj696eb26d6gdXW7vuxoo3ESD1qC5z7VXRjlfHZee+EPFe936CJ/xcrC eZAUkLv2KPFJBtE3Kp8YGfv11BlqsSy6yks17EpmVkKqc//DLm4qsD0znpqRzO5Du63+rlrQ9nk BrLHiO13GH5V3jToFj+c1yVI181/jzZMYGvdvvtuDtaZ9xC0jPFqZWHSgmKrnZ/ql65ndC0hWSi JSKgRbI9x5SuOJ1oL58S5ROXQDCrP6kxrA4K1X7s7T4tC1TlmjxQEF+BSjyhAbFk6knwvuCPLF6 T53F5iIGfpQGLyg== 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8684 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. 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 757ea05cb8..86bcd5743c 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 Tue Jan 27 08:19: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: 79784 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 864AACA6CA2 for ; Tue, 27 Jan 2026 08:19:46 +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.6055.1769501979648793188 for ; Tue, 27 Jan 2026 00:19:39 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=U3apCaRz; 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 1AF4AC211CD for ; Tue, 27 Jan 2026 08:19:40 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 2441E606F5; Tue, 27 Jan 2026 08:19:38 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 06F8D119A8691; Tue, 27 Jan 2026 09:19:36 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501977; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=NJRoEhvXUcXqe4SBxQDow6KNXUmkJjx3x5ek92NyWic=; b=U3apCaRzQOQlxQ34pu4BuxTNNjjexafWVeVZNybI+/r9RfaPEeCdFsG27orALXHW1s6CyT 5Uotgs54fv+J/qSURe/w+15TKR3fXydHaLmhVoEpTtgrX8hQmTR5ZdWRKjKAnUJ/ASBTnV Tx7CsiBULnSA48bDn8E7SnGBtxLSnZY9OJn06eCLEvRVyKyBvateS/5sTFLlSHPjwsXkiL R68n6SI4BMja2mNSy9RxsE1uaGFqQK78Ur/5Dx5WwHlZDIAUZqYdXio3oaClYcehVdloqu 9EHZSALBqVCvjoCGhHBU3vciMCzicZBFR3RPqAESgbEGP5kbnFWLKsaYiRFnqw== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:19 +0100 Subject: [PATCH v2 24/56] ref-manual/classes.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-24-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUCeyd5J5juhx2ijnbeyje4DOKgaFFYGCdCC EOgoUYM/1yJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AgAKCRDRgEFAKaOo Nrc9D/9AhrfR7aZNpWRKq4e/J8Wb+DE15wNNAyR7f60/CpCxfrQjR3+9CPw7Ax75hquBqZrOd7o yJnTkX8HvQeot6N50+wR9S1zYS3eyPItc/iUupI/DQykdLh7bdRHzd6w0a+dYnd0WFlv0e6ALR3 M2xo1AcEaYUUrcd0pTqtNUd/sYkSRvHWCXHAJV8HhQ8uw+2M+aD1HvWFipnZbDEbc1Yj+oYH0kc rOTNFo1FykaEWmz1D/MrXLq8mM7YADvPWmlHk0m+/kkCws37SP/ut7YIeedc4N+EIpOL2XUBI6b xr6ySVlYH3UlPBWfWQ3GlxnqbugPIadbrue29v/+TobJ8D7cHN/9MGc6pzmETU8vwSuBMHQLxAu Bggq0WBDxMYbXmyqqTPujJccgcR7xLTE5ymblVbX2ej6KHIlucJa6YcGZf7+Z0DDBsDh3y7Tq6E 91iPx5jNRxzBlHaZVZGbjMOPpgpgHOWQKbfU4EsooIBBmZvtAlMebVa4kvqYg5O+ENGZ5SNWCrw F68dJy+lWIWX8NAlXV/15yONAbjxFtPvNlsJTPHgy2Hi0VgLBv0WJuKVV0xj1B8E4F1MbLJ7ROQ m1enJaeK/UWLW5+Pa5n3lg5fOMbWAo42t6QE65C2D/dvQQOLtcyturr7JU+Pz6SSoywwKBlnlZT dAjD8v3QHiM7vig== 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8685 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 Tue Jan 27 08:19: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: 79782 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 844EECA6C9D for ; Tue, 27 Jan 2026 08:19:46 +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.6056.1769501980417837644 for ; Tue, 27 Jan 2026 00:19:40 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=XRVgq8KW; 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 D650A4E422CC for ; Tue, 27 Jan 2026 08:19:38 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id AE029606F5; Tue, 27 Jan 2026 08:19:38 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id E681E119A8695; Tue, 27 Jan 2026 09:19:37 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501978; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=nwZAw1fI/cU7zhrCsIvB3YieEQIhPoU9tsyVTd7R/Bs=; b=XRVgq8KWQSw4HQigK86zHno6RyJpbcelJr6GbHjtVGqoojetXbffaNLsJAcpaJcTLRiqPL QshE1F1F7GgRy4RLtcugk1OUqLUnPTsUEA7Nc8nmWgukUKyNe07hAv8z0Ax+TGj2lzMifD sPW4nd1jONYVSdBxANo22IIu1IJDVneK67dYfuu9kAr7D4+AX22WqsnRNkxpw6u+x4KJbJ rsvFuoZklhmTUf5oK5TfEqXFmMIxOB/xyzTpNOJDnP/XHgmfqa4bj86kHSUnvCEpyP7SfT c2SH54MqaMv+YvXf4ghG7Y/AQrVcm1lk9NS+7+qqIgCfsM4AXmTksH/+CIhxlg== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:20 +0100 Subject: [PATCH v2 25/56] ref-manual/images.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-25-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUCePJ9NvZ/9S9yrlyRMeSe4TGTRUCzKISDK fFfD7I7ctuJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AgAKCRDRgEFAKaOo NmoID/wPP0skMIM64qEu63doZYvrYHjTHfgWhEoRdkI/+RE8JDfkaUqozMYQuOHaXH/9GIjuE82 YNovlF/Saa+GZcP48ZHl5CmiPWHKPWm1aVc5xdwlFOe4vnZhBf/94/UDZ2BaYP6GTR/LrTP6+Eb mFp//IDukiOJYl3HQ0ObAemWnTTPsYQqCraiSzIHJXspQVM03atg40n+glnuLRlknAMO8RK2RVl LQ0RL4be2t4XLMb1XcKujnEfokR4UWgwTJrbQMfP+MuhteNJc0SnmkCiBWVzTb7AhKsyRlzM1gF i1yYUHgY3ClrcThvKSsdTgZlgJJa7094IYndWorw9MLbrz9FwiyYQ6rwSN3JwT75cIkpxUFDT17 CC88qxB18k9q0z7ApETygsAb6f+03pT5awYOob6qDnjLpalARG+K/OeU9EL2hwXJVIufjvOFaml xerK6QTwyPi1iARbM7mo2IohigYc9KxrVco+N4JxqqaduIK/TLKHCxis2BIFuGXqk1zT+X7PPhN 7/G7Eo2jG3sqktzb5PL90F0BbrcOyBQhrWxk6PbDAMody385nZSx0dnNGuSA7DraWw2MqYv2wJF OQm3y6ZXOxet5ZN9H1dXKvf0ccyy76crUtTKygu/T0Q/EwJr6SFLpNls5DdnDtbpmwTuy2hNzFq XO6qFb/Urz67WaQ== 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8686 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 Tue Jan 27 08:19:21 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79780 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 771EDCA6C9A for ; Tue, 27 Jan 2026 08:19:46 +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.6057.1769501980931976013 for ; Tue, 27 Jan 2026 00:19:41 -0800 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@bootlin.com header.s=dkim header.b=yL01k95A; 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 5F9774E422CB for ; Tue, 27 Jan 2026 08:19:39 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 37FF5606F5 for ; Tue, 27 Jan 2026 08:19:39 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 89012119A8693; Tue, 27 Jan 2026 09:19:38 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501978; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=ZoF1sPPHHwRFe6EoL9wucp23JWNhVAsDGE7NY1M4qPA=; b=yL01k95Ari6+k33wq+T6QzptNaVPYaMObojRgk9WLshS0/vTB1aRy4WdBO+Gpkbd7gagQs n44eUHu7WAlDc6iLqN72x5Jc9meGVteUboJIhfOh28U9qoQmYi66Nmi1+gzWH4JOA1OiI+ t9Wp17N2jO4sYujpggSuHZeqBDKCtbJuKwu5+VIKh0RMpD7iFS4SfJRQd5pL7GKfyqumOS jB1bmNN6B9fgJBU46sr7sbIius6XzpLFxBWN8ogMKzBx6uvTDdn59UL8KoYXyc1zI94kq+ odshUNV2C9OMLWFLWS+M64AJr+X5KfGOvrGCuni0K8o7wOC76LSO+xqf1TZnZQ== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:21 +0100 Subject: [PATCH v2 26/56] ref-manual/structure.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-26-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=16251; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=Vzw4kCBx53zjuXaBr/EgWCDsQCNyh3rI8Z5Yl+phl7Q=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUCkJd3wMKrz92BUiyIFgeZUIt3iKZVuITfp 4C9VSER0UaJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AgAKCRDRgEFAKaOo NhoID/0ZRJPmhpn8I7JxPD+s2iERDnbz3HH84FuvndkSWEZB7TvgRxJZk2vk4tWs/m0OiDXSWkJ 73YNfgsJ3L8wBy9Ha2gl0xTZPvjdInoTDFQtynCJ35ql4BycmOo2l8WFnccKPnCEXDa7cdFAwKF GPZX+hAAwv1pYcORQR+ujcS9GI7T6yha2c/anpgVTIzfI1/beyMW9lxLZYKsLurB08h/4iGRwtU /MbRzapHHrwQmFZ4sREGhLLvneemXfStYySp2pv43rXY3dzMuPs+zfqhhx4oO00zdx4df33/fEq O3gcefZ8IDv6JHrBvlqrl2DSv86y9nkE8xlZh/6GbeS4NBIfah/bqSmgZdalZ26Lfb9w9UApByY SZAKePNjs1+51Kj/2GoLGLPpvGHdOxLmYI+5kg85sGVqGv9MSKaaje1oP1XppYWjPNpVfZMdNoh N0mVFeaJ2HDJrCpDRJZXDWleZ+smliGnNMxmMmTj9iCeg8MPoQqufDYI+rFAjDbNn9pvEF4Hbsk ebAiIaAupGQkvsyBHnaIjdCFsgEr5JdL60n2Z3qxN2Lf5RxIQx0x1Le2SU3iZw10+rbzUotfpv3 FLvUEfsMFLgevh89VdDUYmiPPrTmvWZ7O/CcekUxFA1kVZVBgMj1AZuabXo8vpefSod4sUWdCVj JUMot4yOlcCWMjg== 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8687 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 | 169 ++++++++++++++++++++------------- documentation/ref-manual/terms.rst | 2 +- 3 files changed, 105 insertions(+), 70 deletions(-) diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst index 4c0939ab0..67f61b7b2 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..86f3109e1 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,8 @@ about the contents of the :term:`Build Directory`. .. _handbook: -``documentation/`` ------------------- +``layers/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 +89,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/`` ---------- +``layers/openembedded-core/meta/`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This directory contains the minimal, underlying OpenEmbedded-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/`` ------------------- +``layers/openembedded-core/meta-selftest/`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This directory adds additional recipes and append files used by the OpenEmbedded selftests to verify the behavior of the build system. You @@ -115,15 +119,15 @@ want to run the selftests. .. _structure-meta-skeleton: -``meta-skeleton/`` ------------------- +``layers/openembedded-core/meta-skeleton/`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This directory contains template recipes for BSP and kernel development. .. _structure-core-scripts: -``scripts/`` ------------- +``layers/openembedded-core/scripts/`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This directory contains various integration scripts that implement extra functionality in the Yocto Project environment (e.g. QEMU scripts). The @@ -136,8 +140,8 @@ back to the Yocto Project, such as ``create-pull-request`` and .. _structure-core-script: -``oe-init-build-env`` ---------------------- +``layers/openembedded-core/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 +170,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 +203,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 +213,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`. + +.. _structure-core-meta-poky: + +``layers/meta-yocto/meta-poky/`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Dependent on the :term:`OpenEmbedded-Core (OE-Core)` metadata, this directory +adds just enough metadata to define the Poky reference distribution. -``LICENSE, README, and README.hardware`` ----------------------------------------- +Namely, it contains the distro :term:`configuration file` for Poky: +``conf/distro/poky.conf``. -These files are standard top-level files. +.. _structure-core-meta-yocto-bsp: + +``layers/meta-yocto/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 +290,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 +308,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 +331,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 +352,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 +362,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 +384,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 +791,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 Tue Jan 27 08:19: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: 79779 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 6E964CA6C9C for ; Tue, 27 Jan 2026 08:19:46 +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.6058.1769501981836833507 for ; Tue, 27 Jan 2026 00:19:42 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=hRCLcEoB; 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 5B33C1A2A69 for ; Tue, 27 Jan 2026 08:19:40 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 32DF2606F5; Tue, 27 Jan 2026 08:19:40 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 1D799119A8694; Tue, 27 Jan 2026 09:19:39 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501979; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=gen7EeYXcilSpgYmTb6X4TomYS9sEn6doy0kRbHqf+0=; b=hRCLcEoBbWhZe+fTXyknjX70DG2kwcFftTmPmqABCFRpnkZQUhdwQRmmniP4DcZR8sfJEV Y24cWhzeDsEToKgBJ2MUWRyrbyxFNGvTKFs1frDQJ26aS5VnOEwKRSE+xDK7c0LPo9aPZN 0MDwxNdWTRDtJGEDChp+FmdUQw2wdlWlPKbr1ystGPaCcbHZwxtkuKCHEYqb+UWrQc1nSR 9NtnZr2zuC+BrClxOhCxdy4vAxxl2Gwmre5bmILdFqcHW/Z7EYIB70p6jt3DQgsCqOT8eX npJYK0TBaXcFU6Zy5dfx8DTNoSh10vgOR06FZ553fr7bWQ1bjFKAIk2bgwZv4w== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:22 +0100 Subject: [PATCH v2 27/56] ref-manual/tasks.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-27-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUC8LhWH3RdTVeW56rNAk8EsDcLwXmGJ3Hfq a5Zo6Sexb6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AgAKCRDRgEFAKaOo NvH2D/9pcshHiscGoiJvDEMqR+BZrWDOV2vife+ePYvEEw2ikb2U9LIJ215jfjR/VUdneGWB0Bw CWFLGoQ1tj7vorXyj8YVlDpHT+zvldt3w+4Kfr5wrhTr1FmNQxKxaDD2KN/6uiuRsKBZS1Smb9s l92sJpBfipc19/hLXycPHLdjcyDTV1xXLUjS6jefiYkoc0JCNw59lW8CYZOdQrAopGfxTDRvTvS w+CekfbNed0jYX9pL7P2n1LO6nWw+dIv55UD+q9NHqfWg4AXmu4YUKrpyKRXRuPD1XGFIcYdSA/ FOYxgo333U5T47yWsWvYDIS56Afca2NI2TQlyn+nq1IK3ZsvM6XlHhkAqYxxBXEbD1ItlpvyXxQ SLGjs9AHVl0ZbRMxeXE362ZSpAsZ016uJnvf/PErIZd4hSNB/OBzpsYFkKLFchfa4xLVQIvsV+z WmT8Umy4AT4ApDYriRTZMpl9urVmVv5myyddyVoNR1oCBSVN28cnRaspsYavlzdiD0QsAUsFmsB cnTw3X2GCxq4FixDFJU9uB+7YwvoGSZAQJbBzQixKIwl1RJgm4KNXV4KUAWEY1cZjIk0UKSlrEr Dnq7qL/KkYttvVW2lRJOt5+8EkEdJ7G/QOrQquulUOD6cwStuZbrTKEtM+eZDPueekZqu1+iMFc oO90WNN/Myu9ctQ== 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8688 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 Tue Jan 27 08:19: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: 79781 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 5DB87CA6C99 for ; Tue, 27 Jan 2026 08:19:46 +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.5811.1769501982674049786 for ; Tue, 27 Jan 2026 00:19:43 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=h6Jz4ihZ; 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 064E91A2A6B for ; Tue, 27 Jan 2026 08:19:41 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id D21F1606F5 for ; Tue, 27 Jan 2026 08:19:40 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 0B8D2119A8696; Tue, 27 Jan 2026 09:19:39 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501980; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=uxd08NKrJixDGzkppdDyhLRkShIDtsBAHhCaMKKSvcQ=; b=h6Jz4ihZie+CxAteouF1SRc//YjcY5b3pH0geWW6aNPZRtEWEL7wtYiduTktFuNSU3NrP1 iyT8QD3fPf3/V3J72qgh0u9MSTVID8NUn7oMn4rm+ea0MCSWcLAhK+Dn5+hSG72yiYGEQA q9eFjD28qnpvwY9cMJYsXnJ3QJZ7Q6QavlJKTIj0CZopiaT6AjsjlliszMeNKf2yjBCRAf mVt7zF8i4pLigFN8TuuzCS+NzGMYa8MsJs4htm42LI1G4xHANB2iR9wJ7BYJ8rFRfoNM1O pEP60hhZF85/uZYs2L//91D5PnElAvNMtQHlPlfUn6k+xuDy+ol+OUOR2KezhA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:23 +0100 Subject: [PATCH v2 28/56] ref-manual/variables.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-28-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=24746; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=Z1MFMcXkUYYRCJCnCGSE2aW+SY5XPMNWf7Qxmf2edw0=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUCdwPlh4Y6udZ6005uWm59JjaJ7O+eibzFc uYsEIWD50SJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AgAKCRDRgEFAKaOo NnDWD/9eflO6+Ibj0is/lL1SA75sRnBptOsoWa0o9FK3xGjrF0JS07sOExTfQACosB+D9PKhuNB S0cMQR3dBMD34cKJy2kgnup7yLniuFjzmbOSupwMjQHFnfRWNYVHicQ+bsnl0rtQI+kZDME1onW isWNuRXg++mPrwDPwV6A2QPfOGHvV40LH6zf/8h2kAuD7c3tjaxOipybX5RNTzt24BywZm8VjOy 85Po/lC38QaJiB7jSY+u0jEVrlRdzCA/mHPANPu4TOCNxkZWhhSehxYctxs863kb0pjg6/LzUp7 i8dM6Lr5xt92J3weUGC9RF0DT0ZXfdRjsta77mjK+3v++AI94FY6XsDl0JV8MDVOmOUPgXCNbKN DySMGs9jh9viz4Ds6hf9TfTYSXkVj7WfmYqbQc+u4L2DRqEWf09hF7WblrZIxqTFW2VPhzOxa33 9KfEYYrKFR9Rukr19T0n+tQdvUDZjG9ljNcMuuXcAvflbgZZpl70YijUuoHABQReyLDimmyQHVQ HvgQjqw14GSELw1+h7ovl2LL32fH7QRrTn8dx0wWzyzmiFxh6gI90VEOYQ29XKsVHabgyG8axrv 3DSv6TrnowjeQP7utMKE+vwBxYGQtDcG89L0fZQsxM+A1QlcYBDHzeXvm9rtx6I2dkbOpV6L0YM sCJIsIt/E3M4ztg== 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8689 Remove references to the Poky repository, replace by OpenEmbedded-Core in most cases. 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 Tue Jan 27 08:19:24 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79776 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 532F4CA6C96 for ; Tue, 27 Jan 2026 08:19:46 +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.5812.1769501983255501920 for ; Tue, 27 Jan 2026 00:19:43 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=IXIsLPGc; 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 C1B941A2A6C for ; Tue, 27 Jan 2026 08:19:41 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 98936606F5 for ; Tue, 27 Jan 2026 08:19:41 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id B7E5C119A8697; Tue, 27 Jan 2026 09:19:40 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501981; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=lkEy0PxaPR+LwxpzkVpE3/ZzyribVSkVxGoLLUwCGJ8=; b=IXIsLPGc7BeoX90kTaNbyyOtlFuwfg1AwKN5GQc4ikkoIDxVyDhL8mUr8IQ2fTcWa5Ygyv v1ozN4nbJwVp4VxjCk/SWhOYxtaWrSmPhA7XICfPMY+ofwmnn0LCwy6Gd/2uiBMOV1IDbA LhEFf5zyUg8yIcQgw7QyTwlLi0Dm/5Z7x0EPVeBXrMnod1OhYGZ/PGOEJlyL7+mcGDoGKQ sTNgauVKhsg+tCa8MReOktd/2TGYprdbz4EztsyQs82GmPOo2nFwihzFMEvDUYiZdmbvP6 3vgVMsVjozOZZ6F2hQtoDlmeK9c0VsHedJWLf+mwJ8lB/ebNCgWpaP3vCYod9Q== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:24 +0100 Subject: [PATCH v2 29/56] sdk-manual/appendix-obtain.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-29-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=869; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=X/BIoiTT+/GGUoOER2zxv1EWsJPMSLwH5jZVnADstus=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUCKAqa4knJaS632tunDkzHOPhFSRA2xvjC4 NndpciWTYyJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AgAKCRDRgEFAKaOo Nv+eD/9Ingtfh8ZkTUaJbZl/+hdeU91cD4sCve1wxu7TJi3mmuCKUTgDt8YwyRv1BFw9Pc5MdYu gJ0ic5B5WMWKNl0HtLufAqIXgpxtvdrMxMh9Ff29QeB/Of0sw3QBZaWLTofW2M4aTFOWuI9HxVu DsmDyFRWNuO/08ZrgLvWi/T2S56vTLTPOpFiOVtKzj8/RjGiPnoFy/HeRoXiX5js9HyR5Z/tDb8 RTDCtlWWWLlrxP7ANXM+FaHkHxo1GBIVXh83ccTtFU3aQnG9cVLiVR5Ky2B4++tMc2KH/LT6rpj bRjTcOJgCZIH6ohiowc2sWgHaF66vIKfiOraTeUj5lfPI9waN1EPVBypAYiU03Q1vv/7Qs8vemz KVEIkBUISNxlIIeYI4RHE5Sqi1VPN6nYlaivAGqRxCC02Qb6Tow4bgeZKjL95BK+LIDBDS7re43 j6qpKSoCSPuSwjCkSGgS9wCkxfNXOC1mYYQPc3aeTy8f9LO75eO/QniiBZkb1zJJ0SvjVE18Xh4 xi1Jk4QXYQgNNMS/wDHlXazhmW9p+1UfxWmY7we76pCZgLf3fwtWHoRHb7sM8vGnpUbqMAMFx/A 4XZVVWWQqnLtxOA392pMcr3kTPt0ezKJfGc5qavY0BoQvvTGunT9yzMUaWolwqj2ETy3tY+T2iB ZmDwJGAYbEbO1fA== 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8690 Rename the source directory to project, as specified in its new definition in terms.rst. 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 Tue Jan 27 08:19:25 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79777 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 45A05CA6C89 for ; Tue, 27 Jan 2026 08:19:46 +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.5813.1769501983997683113 for ; Tue, 27 Jan 2026 00:19:44 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=udvtUXCE; 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 7B2851A2A69 for ; Tue, 27 Jan 2026 08:19:42 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 47692606F5; Tue, 27 Jan 2026 08:19:42 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 7D2C6119A869A; Tue, 27 Jan 2026 09:19:41 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501981; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=n5OaUNAOptAFyjAf6DfEXgFAFCGJ+n3HltCfdmRu0wY=; b=udvtUXCEKV3pobpj0g3Ut+8siCG/Y95Gh2Q48A3TRYqWRLf6zOmVQvBBiQtcZAY/7UFFt0 ht/X52FGYtaGzR9waR2Vvh9MKmbrpycdwb8JNNUxW29SnbYJz6jmqXn0s6/+cRhTd35Pbi ijPwOI3x05fiGepw29LI3bXNjt0ojrq8SKglqbE/TpIMAbzdLDzVx+yRYZUMYuaXq2twpW yqNVn4oHSBVfrf9PunUuMDCi/6Rq272P4JC43DbK6sL0epp3FOUiS7ACHQHcFrO3qzChJl N4+9zp91dnHMqdrpojDPPrtYRHuQqku+5k2ueIzMoURwN0FRGUj2oZ0CM06wKA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:25 +0100 Subject: [PATCH v2 30/56] sdk-manual/intro.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-30-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUDlq95/v4lEYgOubVUgsD6meHHDHZkJ1rXi /pJqNEA+nSJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AwAKCRDRgEFAKaOo NtD3EACjRAK3SEQBdgZ5jwct8bocgiAQN4bQgxjDOJARDqiY0vIsy+JzgZIwbpp2G2RjlF6Vbxw uHiMESChISxL0v95u984iUho3kLOAPzI7wl1hM+zYBh+HEj3Kqke0mWDhGbQNdO4W5lKr7xaLtE 13HyYmRfSaX5SLUSskXLll38CJUDDeunr1UsqsO2HHOUcs6rIKlwGDtMlmbS6aRJnJ+aT7MovH1 wtu/Bpsc1QWHLvUkIHIbw4+JY95C+70QvxHGAh/gHL2l4VeRiON8kJgq6rADU5PiDFvMeX3MBze L51bhvICYKHWe+X/I5CuMSY9U5A7hK6083BndQl2/s3PMmSodkerklVxi2K1kYJhprvHFY40jlL b6Y/oNDFAMSBtJNHfjoCunOcHPMkZWmRgZaYjR6+4ACLlHejueKGRJrF4J1eS7xMWwVR3muKTbu EUZFA0EsRSfknh7bLacoqWNcsyWrOuEdQpvuyF7dDmHx2TtQLybkOT4nAzemoZXQFjFxG0E7DII SkSVnBJaAynNnHMZgKTecxCgkykAmlW3f8addz483/5J6oQvGdiNrKLKyx9S5YcbHyML5l0arvU 9iP3aEdAvhqYA1RLBDcr33jeC+8h5Gz2kyKmtttmGR3+B/P2Estt7w1U0WAM2JjXPfN7fIKkYea j0xSPoMy1v1aUkw== 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8691 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 Tue Jan 27 08:19:26 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79778 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 5B3C1CA6C92 for ; Tue, 27 Jan 2026 08:19:46 +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.5814.1769501984721948335 for ; Tue, 27 Jan 2026 00:19:45 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=mgYza32Y; 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 30EB24E422CB for ; Tue, 27 Jan 2026 08:19:43 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 06FE4606F5; Tue, 27 Jan 2026 08:19:43 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 23AB7119A8698; Tue, 27 Jan 2026 09:19:42 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501982; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=RHi7A92HtD+x9RptsFdqPqLKhKHW6FqCplAHQVqJ1sQ=; b=mgYza32Y2aHvPJ1SPKViDvzxGeCCAjPa99RzXIfbyt04xKfYREBBeX7Cu9yh5W3Sxjjz8N Eq/O9WcKu9sDSKJ1VK8jBtzIN5C3DXKBl+AI+BP/GAfIYIALQ9k+b8a9gdAieOucsXCHeB 8DkQuqcxAWiRT8mDMVtmToGO+XrcXL6Qf7VBMUMwo5eF04tE7jNyqHG5b3W03H77KP0rkS Q81aEkVK7S0JzEC6FUlne/ux/ywTZ5F2MfvIAtO5g9nDO4Omg4aglb6ra5q01uy1XVzlSc dMnOI7eoV1wSN25ApK2tP7Cyjc10miNUuOJFcs3PLTzEbTMiVkSyh66IZty1cQ== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:26 +0100 Subject: [PATCH v2 31/56] test-manual/runtime-testing.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-31-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUDVqqBX0K12JKNVl/bVtjcOckNh1trjHD5q o2cV8QuwumJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AwAKCRDRgEFAKaOo NrpAD/92vlokXsd+3OD2xqGfwbAzyPiZiiZTDqKAxlqqJ3t/w4cYbxn/QpaEQJZDLe4KQNCAtlM W2ZyvbXbjehrfjPN974HK6vjvZrPT/RQ8buRvZpG94cyctZ1H2v9OMhddNqDz6QnxgJ5E1tx72h 66CJqchdYeetCe3CS2G/6LZHSHtCmix2rZ9w9+LrCPmSDyY6fUDtEdykYgCBeTr8YRygfWsrk5R wcd6/PqX4RNPg5tw6Y+TAXP00ZiYRp/Mk7jiNOZ4kFiRZABlaR/7IbgxmJf1glSRnuMafVNNk2M SuPDXVM++VBGbXk3Y/micR1uLITOigByaZZ3fkILs+PZ+mKlWQx4dGC6Zzj9J9eHXRgxs29uAjM 0IzBPMLeGO9DJ4O9HgzeMYotHlGiGBlQbS0XaXACzg3//JX+qEnoL1Q98lIcwYbhkBNW50wtr02 xa631el5fEkYyJRu1veufeM4K992uYQazuoBnz8TmG/G3NLCK/f7g4bWKfOyh/pnaS923dav1tU C8E6m2qWmSDwBxiG+nrW0sY65qDLPrEHHNnQwLzFrjHhiZMEKdQuHboaRPnm2yPtx9DGujDXl5q faOMMxvuJBDbstReKOkSDxUcdS94j3llmHU5aur6zY3pFUPRK9/KmLRIrqs/oYDNwru2vc7PHCh 4ANp3gTSEO6SbJA== 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8692 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 Tue Jan 27 08:19:27 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79774 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 3285CCA6C81 for ; Tue, 27 Jan 2026 08:19:46 +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.5815.1769501985495239392 for ; Tue, 27 Jan 2026 00:19:45 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=CZEDfM95; 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 F013A4E422CA for ; Tue, 27 Jan 2026 08:19:43 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id C0A11606F5 for ; Tue, 27 Jan 2026 08:19:43 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id C3990119A8699; Tue, 27 Jan 2026 09:19:42 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501983; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=jajIpWDZlGUclhlvh/EgAOBX40JyBzYYZtTybiL3Cs0=; b=CZEDfM95EKEMHMI2LvU13K6cNmL4zvVIWIOvL71AZAjF/bIadkawvikpZ/eMUb6CQoUvE+ DtWVT+wfdVTkSZtlpXBTmhRP/ESzO1piewdUTPVU4xM9bpPDyt3mBz2mqiDQMTqaPOnRtr ZTBQS9NDDGkmuQ4ghjoyvP5l7TT864fbJb3TRKgde0WFvuwxFjUlEsP+B4zbfBaBGL2NLt 8gZGL6n7AGu6DkjZso5LqylAoPA0nm8XXiE03ODkHcqjwaZG9imzK10GC/tmu3fC1yBDld SQTOI+MjKINXY6kXS23x7cq0xrqDJFMhegyVfeAP1zCyKNIyxDiiDQpilzl+5A== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:27 +0100 Subject: [PATCH v2 32/56] README: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-32-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=3031; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=5KdFo2gcbmMdcCsInhNNVrp6JPxyeDLGGtC7b/dEX6s=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUDRqWpFYyi4uSN4xGdzaa891nO93Cq+V+iV Z1iPKTXH/SJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AwAKCRDRgEFAKaOo NuY3D/9V5PA2onJoaajP7mOsV+NnjOlYE1B3Y+YyyB5t2+lq+sNYGGQsjDZmpEcU4O11dhVOnUx zUzhOAiE6ApelXQYcBpFAzWQ3XIjdkGFSdl8QQ3FLqKtqV1EwHq72gFsRIbN8VEEfzi+f93QDC3 ZhzIck4W2HPYNoV6nkn31/XkWp+qXAaliNlKNaIShRy0t4xYJc8lAJYBdiV3NZLZUux/cmzMtki 4q6jfELHCm9OkSp/lVH6JD4N44yPOwXys7SViHEmU8r+GKKcmvl12cPt7mqOEGYjFdpkBJ2gum2 HKZuloc+6UzCeHnayoT6V38iUlJyNi2SPXpVN4h+jUZeS7H9qWKOFWF+RtvwdFHYRAePdNaRG4x d/hm393LMFGIakbNxXxT+HtYm18GzlXTIGFU0FzPc+h8U4kxNcOB5e06KR7eNlD6FbEuBP2iMLK XsX6hE7LXod5csbaUP/kbla+zQgLUs5JD9Y5txIBVhhI6Y8FQ3H8iJBssJB7TvDiIwwK2wKfok1 smsCZpUbLsdLmXQ7lqVInE58erWAgXfroEyuy6qGIgNEdMe0rSa+XY3P2cthgCGw/DZfHmin4Zz 6hn35lXbCdhU7WfVJKKnGwoFX4jM47l1KWJ8IwjkEjRaupT9gJ+vB8vaYWlZsUyDjptpGQlA2so zGpsGCl2oPWabig== 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8693 Refresh the document now that the Poky repository is obsolete. 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 Tue Jan 27 08:19:28 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79786 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 B4DFDCA6CA9 for ; Tue, 27 Jan 2026 08:19:46 +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.6059.1769501986192419592 for ; Tue, 27 Jan 2026 00:19:46 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=UhyBenvr; 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 8E698C211CD for ; Tue, 27 Jan 2026 08:19:46 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 95FC2606F5; Tue, 27 Jan 2026 08:19:44 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 9FC42119A869D; Tue, 27 Jan 2026 09:19:43 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501984; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=NCqCo/b1MZa4OC5vrY9VUA8rSKR0GZNy/OoKZ7ZGSD4=; b=UhyBenvrZ1UAvzN4dRs/HR6F+D4bWNTutva1YOv8A0cVYU/Kbp43WNy5BSWkGGOmNMxybm qxLU0cAX5F1SQbvvfD8AEiYKNsRjUdhTfs/kcgvnv2CC9uPxK0eQGzUJVvsyuXIrSXWQtt dM5S7spAn/K5M0FUGjiTbj4x8msgNsf6BlOUCYE8rj6U72cfANbrQ3/qXlOtVLmn3kWx2v RSvd2l1N/aB0f0EVZPIKLGqZGje+r1TlMDCf2wOcjKpllPiB+uEuO/HUNigHqUP15fRVIt RZMgGMpxBhulqTF8ny8FTBVxd6/FPw10SjywrGLcEaNzaPSogtSFE/6+uyagVQ== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:28 +0100 Subject: [PATCH v2 33/56] README: replace obsolete substitution variables MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-33-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUDmzcr/D+YaibhmG4B/TWNONZiz+HprDH6M v/uKKAbskaJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AwAKCRDRgEFAKaOo NlV8D/9McnwvUATzkaRwt7CmgpUdVlCv/e8hFLiYZl+JTL60W8IUvsZmrPufAH+FSMSUpNBldFZ VTuTwzto8jMZFKJMmGZMri8e7k/sNdO215uJ41YYCFkDG2wtJjAnxJCpoiXuLZyaVBwT2B0K3W6 T/HvbCVh/xoU/0P2/aypEAqar24QrCY6Qud3Zss7rCewUdhWGRnwraCUwiJTYGt+1WhaTu8G1BL S+tRmLtcH87UKVE8Sj0mXhTkZJZEeb5aVb+k+XSHctKeRkSSWwCsWGVPIyS7+OHnqE2vKPDE1+Z LpuaAewoVB16d+smIDqb9DOofxuk4NnICOTDUp2Jk8sYg+RD8+e1LzrDXj/h04cy+GT2vdmzl9Q c62bIFHnNBqpwglgiXJIh+hSdQCXh53XBsh00HfDfQ6KuHEqAnhvk4OKAwx9ass4+4pgG7FITCn fFtzzw1TnDv9Fg0DXAM/N/UO5idLGhIhqwODq+iEmfd8nmQdEM9yvqOsDL6ztbbFoJBJu2PeMwp m2i+gBznHVLBtNNlThCf+xOdMKeDRm6EE0Mid4T/nD3e8asDjcrn/RE2PeFPlog3pUWoKqP8wK9 7cXVfpPL8G9PTVml74WPDgG47tBsbrS6foYod6F16zfMuPQAnPXE0//VEeXSRljbcHY4QviaSfQ iURiZ3v7P+/lV6Q== 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 ; Tue, 27 Jan 2026 08:19:46 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8694 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 Tue Jan 27 08:19:29 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79798 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 B414FCA6C92 for ; Tue, 27 Jan 2026 08:19:56 +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.5816.1769501987565829591 for ; Tue, 27 Jan 2026 00:19:47 -0800 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@bootlin.com header.s=dkim header.b=aJsZKwys; 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 0E4674E422CA for ; Tue, 27 Jan 2026 08:19:46 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id DAD76606F5; Tue, 27 Jan 2026 08:19:45 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 62838119A867A; Tue, 27 Jan 2026 09:19:44 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501985; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=uMcuMT4dibcWtAqrz09O2BtxBgPEYlHDEBdt/vUkqWI=; b=aJsZKwysKk+3mg2Abfuu/NbxguqeMv+kiXG1YaggVed5b1H0ekI52ysEJpJVL/aOGd6g7G iMvsGJ17h0ThjZ9Hl54+nykIi0n0p6fjZ6z3hYebYWeY9nIbKIbNWQy7Yu0Sne9TUgS2tU 9HhULR/9C1JYyGWYCaHRVhMvh6w5eXKHwhcYgaiCeNQwnRlsn4ieJoudqEyuHnX7kt5t2r QZhllw5e/lNpVGqwGvYDidpQR+HdaAsIg2AuK0o1Q+IhOqzOttRgKUCi2LmTDuvlaJ4pRC MfY3JqJALf7YhOu05fwKUx/WTE+FDvyT5oET+2wrH/CAOEYroY2a01RtYZC/+Q== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:29 +0100 Subject: [PATCH v2 34/56] contributor-guide/identify-component.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-34-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUDV1lwu3zPO7kmBM+YH1ycHUni+9O/r43Tr +X81yOTjGiJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AwAKCRDRgEFAKaOo NhBDEAC/6nJDStXxMmjTLZnoOGi0hrcFuxQ+g5wY6foEwZwB10MPxgFeGFk1kLwddjCuaOLVEG6 BzvIRoU8IYa0e2KuO2roUBfzwSBwclddbVMZzS69Lq8x6YNaFq2/ApGPjOmUCgCRkr8GT++3L5l l1pQX7T7bIKou1dmm3SuQ9nlNWXTrKZ8npvZWrPBis34Obmn+D/vNFuuu6JvNhd+13b1pHJnxZh Ts9+qhr79eMBk8Q1YysY3PnrbAD2cKtXv+ueorAr6Be4uVfTzsiPNeBklHsDVupV5966pKP/YHZ L+kT0tQida5YeUKWpicdoDCusWxbY+a8aeBIyyu+XB/NiV3P5YUWXwcpcGxDoaGE7jX3B3yWbeZ yJbLi26fWJxaRxMtZoQpAxkTO7igzor34nlOfy4NBuYWua8bp3naZAE5a5ggEIm+77e4Equ8ePA XPxGI5JUMPr5uGHHspJnD424CneW6Py6K6wG4OSIOnlHtsAU5//gzT9ttvlrdL6IV5F2sJ9ELID 7S6QCKg+EUhlB1cREa4MhCMBr49fxY6i8EPi4InC4CYzXM3RZd4tm02+TR9RlOb+6iZc41wO4VJ ogSzizlXv82Ef9pMbYbK5nRvtGsAkKm4AY0ejz+ZyyrjxU64rpfwewkVK6V48iyZCTEjMLGtmyV 5mW6k/G9siaZxVQ== 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 ; Tue, 27 Jan 2026 08:19:56 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8695 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 Tue Jan 27 08:19: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: 79792 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 19D6CCA6CB6 for ; Tue, 27 Jan 2026 08:19:57 +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.5817.1769501987792699467 for ; Tue, 27 Jan 2026 00:19:48 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=e88KM4+S; 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 44A264E422CB for ; Tue, 27 Jan 2026 08:19:46 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 1C6996071A for ; Tue, 27 Jan 2026 08:19:46 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 5B99E119A8682; Tue, 27 Jan 2026 09:19:45 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501985; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=rvI6BtaTBCZI1m1AOSY0EeYyeY0GdopMJVz8co1Ba7s=; b=e88KM4+SDlwio7c3m585noYVd1WGMyIcpb+Di1zsn685MsCz4UT0dxij35HzN5etNLaKbX 6vQ9EY/2iBzjF2XPvm6Gbov/E4HzCoqxM9Xfwcmfmc395aOUZYgcBRkzI8RTvpQl8cDbdj kqiXCCr/5ylujdz1kR+U1E7qHU46Yld+JvEeKZBHoAVZ9ImzVDe3a+Nyd7hlpElZF1YvjH eGrNOrHXQ1IM30MwyLxWs+Wi13sqBjnR73quuCQnHvYp4n+kj4rEjv1txznvklOkarC2CP tEECn2cp+XPXIfgvHZAReOwh6kNwW8YyB1H2CGlDf7UxGz4C1xcPKXs9mu6EeA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:30 +0100 Subject: [PATCH v2 35/56] dev-manual/build-quality.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-35-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=1002; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=s7reeGxnHXNlGh8V+W9g0m1125ZGX7k8kjJ0HyWghns=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUD4Caf/7FzfeVRNUdvwb7C9+B3lh8MR0qef 2vLy2Iz906JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AwAKCRDRgEFAKaOo NvQAD/9Jv/yG8WP2pCPjzhEIt2S1nXCvvtnyFF+SeyYrBpVriOhutKpCDZK0WDAduAXqLS4jhbp PyNPTB9QKA0AZWQhRYmp0HFdMvzytGtnsbtTU6pToj7G9gxjFAETdSxlYlfHHneVZmf9BgK00/r CSusn56T/wAmvAE4tjkLsnBsaQX/y0+AtAhVfwBy1XoZCoWZ/3WkEOIQZtGDiXfxnQ2s0FRiaCv 1IvDHOPYMp2o4CQy1alb+OvB1OTWd+tKXutqThXJlA4cyWnjje5XM+Nnzc1n5qoqILzCkIWL524 Ml3yCfpm88KVvIesIraDhWcF5RVgS/nSj9uQxAKdaCIzLChBpnXqWilmKJ/UH0ukzSM3sIs4btB xU5yXQ9oWl2UAqsdhLMEr1MC1wFS2ZfBkZ5xP7hn1Bi+vCyKoUQs01CiagRG9WiCFzEnTfqayrG YKruQeoIOYiZ0epkiJYGCHqk5/hfhq+hgtbnmHvp+RaCrIV6v+xLAb1YZtfgTi4PFODMcrDNwZj x+6Z0ay/bZGgBbovNtgFPQ7JzfvMYzQhDhTL+DpwO/KF8CNTcATty/ZxkJoCyOuMjh74T4XMTDe sazCTXCrvUHgxxfJdFFDBW55ZzEG2svWpZpxmBQufK6F4nsoCETJn4PsiE6U0AhL+4q8q4eebZW ptK0t0v04TA52uA== 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 ; Tue, 27 Jan 2026 08:19:57 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8696 Refresh the document now that the Poky repository is obsolete. 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 Tue Jan 27 08:19: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: 79802 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 48011CA6CB9 for ; Tue, 27 Jan 2026 08:19:57 +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.5818.1769501988723403745 for ; Tue, 27 Jan 2026 00:19:49 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=Ht6dkPOz; 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 429DF1A2A69 for ; Tue, 27 Jan 2026 08:19:47 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 13B2C606F5; Tue, 27 Jan 2026 08:19:47 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id ECCB0119A8684; Tue, 27 Jan 2026 09:19:45 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501986; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=5lWGedgMp6d5SJVOVQvGB3V6zoCnioUJVv95zER9pBU=; b=Ht6dkPOzVG1SJUp9GaYllYSyaC5LJ13crSlBhCaPbf+mBaEpiHAZDa9kuwd/fDpyU5ABBN psDnHv+ZAvUmv7AAePZXN5+j/flq2khjyRiM00R1EdtRSQHD+g0xwAgLCItWMAHCB6MtOj 0rS+61He2RK5TBwFdoCivQt6naEV22eX4lX+tXd1he7+kwNCaptV3Aa/op7lhjlFawaAYP tvdHz7sebLsv/K+rKXB8dWzKL5x8N2RkBUKHcR7AjH8A/6wVjFxTJeqwtf+obhctjQX36U 9iuFW8oDoREZRH+y03igU3XzOO9YiwK0QllRxMhaw/bVjmdJMZuxB/yYTz+V5g== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:31 +0100 Subject: [PATCH v2 36/56] dev-manual/custom-distribution.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-36-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUDYNSVxUdTqE2M0BCaIWjb/+n+jXe77WggV rMIWZX+NdaJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1AwAKCRDRgEFAKaOo No1ID/4gspN+WcJZ8TdQgHjoqLLO7hx0gGAziV7OPuR+hILVAlMIPFKK/J+cXVG4cYqJ6MieZkt ks2E8FKW5auTs8pImq2b0RxMvYBNT4oizVSvwsp6s4fM+8j1bWdNBIGDKGkecr0XU0Xtgv6FNNG KUBjbh2u236tTA42QXTxewYZiQbcbICzqXqljdZeIkal3IlcU6KeXpUuNzzi3lSTs6bM5vWHjce BPkrN+ehNv0xuDE3PNFRQbKhU+ZC+SFNhiqfifVUsfMRp+bH17+sUsjKQTylscccYNuq4dv8itu YrQPpE0Wr051stP5Mf/P5Oila1FgTayZl1PWie0yNtQWDxhJwyF6sXGzcMozuq7A+3Co7JoCaHD JQMkrSOJhC5MYjw6DZi2Zue7SQuo3pD4yNbv/ATmYw2BKvJUT8c9RJXT7ajfKb32FgGE/WRQela hCpt5hELfrGHgrM7v5J3ged+d5NMbjQ6N87Q1OCxwwZtcc3Pxd2WFSsypz+XZ9WFkSJTKsJj0Gn TXWXXW2UOu/jJ8XzFN1MN/z8NJSAYSdPSmls4IPkYLQqYhbpTfSAWdvTVqbPQ+XW2PT/cJB+4o+ j+0PYathjdXu0q5tEcnyZkwiASzkdnbOu0XTkCb+WCOqllcjgj5eyZ+2bGlqcG3hJBV9kUOWhZD ss3FapyNIyFNj+w== 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 ; Tue, 27 Jan 2026 08:19:57 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8697 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 Tue Jan 27 08:19: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: 79796 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 34D6ECA6CB8 for ; Tue, 27 Jan 2026 08:19:57 +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.6060.1769501989179240084 for ; Tue, 27 Jan 2026 00:19:49 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=VZd9zLJ7; 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 AEA971A2A6B for ; Tue, 27 Jan 2026 08:19:47 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 85FB3606F5 for ; Tue, 27 Jan 2026 08:19:47 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id D2D51119A8685; Tue, 27 Jan 2026 09:19:46 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501987; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=oyjzWFwxOFwXDJCyHWuSLkynDOU/YQHZZGmDhz6J+ls=; b=VZd9zLJ74lvp86AnLuqyGBPpub969sCcRmN5PjFfgwAkrF9c+JnpOrHmFYa3NQa1DZx/yQ TLMoy2lsc/RyoowL0cdcoRTxTMRKoYKqqMz+MdP7aTCBrUEPWWXDjSoC5vzhNfS4bq6DgK eI8iUNRf9sOeAfTlX73KT1nFQqon5gwwQiTCNFDsMd5xCuGchj84j3+naKFWIiumPKi02u Xo6uxjqsKsJRqrBC3Hb4d6Op7I+7bRZP4OXfX5BZ7Ar1xOYe/ACreCHbSU4OLS5YX3Bxah 8YUja/NnnDxxzuWbpwhs6J6Bp1L7QFMIMwc23pK+WOHbW0gZ6/V5QwUJln9+Hg== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:32 +0100 Subject: [PATCH v2 37/56] dev-manual/custom-template-configuration-directory.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-37-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=2582; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=fHbzqqSx0z6x0a+wmezvdHMmGxUQ+QlxRKc0x+UPFCk=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUEx+E5gCF5uBW1wQMyLjwwOZ9C8lXiPzH59 9FdHmSunXeJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BAAKCRDRgEFAKaOo Np6lD/9BJbBJwJSO7u9u/Bp9gcrw8j+OfFLlyOxi3H7f8RmdZeXazDRmp4A/zlxCrf03yd9i/QC lgwYw7GKVMmtH+JdBZdi20HnXDulqe56fkudV5qL/fkJeIHKyE6mLGfAwJnrTGX1c0U+X5nsxc/ 6j1Rp+/COeCGJjcUdeEqf8jn3ydS99+cUdZKf+sc4uapOfx1Uki7OMKkuSEazZqTFugccbTkRHH sbxHVazzFQIkf/hn35CXH0X3dMEOkdFDRp7Goqp6p+ASqCFTtSiSImCqR1jp3Q7N4d8XpYY3P5a vg1mWGxU/nguVYNVu6FtoF8jrd5yAk2MwDlDGSjAdwMT+6K62ergWyCsvCo40RSjp+0B7/mHXl/ HRLnx9hiSVzYG761461pyH2HNfxVvRUgUth5pPFB6uZad/+6g7EAiKnneDLcrqAneeVKgarsnkI Yb9H1QfC+iuZON3fM+qyznaahiOcic9N7SKwjPF7hCpBIDG/pXM3SsYaz3ly3J9eRxqqt1fqHMu 2Xpb9abANUgd1XtFI+3qZuY7G0B+APepgao01wfFAkJzby9HPfWRaaiczkGI2D155DuJi7G356C YlXQo1DwpM42Bvfsu2+VBTDhj6oK/u/5SMbbb99gGON+9EQ2bLjg9K+j4Q+sqCMDWuoe6oQY6N9 6s5ytcpLewFLfSw== 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 ; Tue, 27 Jan 2026 08:19:57 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8698 Refresh the document now that the Poky repository is obsolete. Adapt paths to match to encouraged Source Directory layout. 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 Tue Jan 27 08:19: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: 79801 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 B9D70CA6C81 for ; Tue, 27 Jan 2026 08:19:56 +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.5819.1769501989861796070 for ; Tue, 27 Jan 2026 00:19:50 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=ksDqZcdZ; 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 59E2F1A2A6C; Tue, 27 Jan 2026 08:19:48 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 3007E606F5; Tue, 27 Jan 2026 08:19:48 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 6D1B3119A867A; Tue, 27 Jan 2026 09:19:47 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501987; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=/y1DwQWWC+bG3sAfBh0BmLJxIsOeierLVS+gu8nlvzk=; b=ksDqZcdZXFIV146EGnsSU4WYosl8IocyyZo39Sk5he4jTbHSX7KuLHMSx2j73sipwc/CZp HrnVGABsY3pO82x/yvQ0sQcCJkOPkigdUt65h5xJ/gNY+0llQgzzbCywiycs5QFLciFVTz sH2jRYkcjEmbY1esYiiwRo7kUrc468tk2DRfN/J64h3BPoul6c6yD9mzztAWBnGeSURtwh rAu/pn8r17711BMVNwVq8ZyIiNIKb0k1wBgFH1y/FgSoTcBZ3qPDef7RITHB1ohRKDdF7S KEiQxzA2NGC0JKZYQtkxs6w54wRuYBQdkj2yOtFRchip2mopp6Dn/HedeV5asA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:33 +0100 Subject: [PATCH v2 38/56] dev-manual/init-manager.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-38-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUEZAW68QsH7hjq55TCi2ER4Zq/w8ibrbl0v aSD27hMuyKJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BAAKCRDRgEFAKaOo NobzEAC0rHXaEAq/wh8BdCFu1uYWFGzwaPTZOsdozMsIANv3Y3yogD+GRctWJ58Cf6j43YdYvfK sGSTFsL9zp7TJ2BK2M+xAoS2hdb3b09TqbkoubBmc5D6LkKjdiIjDW4JIg180j3nLFTBUsPbWfX 52h0ajtZry+IYzvdamlYN03gSHkKO/oYidVcd3soLfKvC++6OBE0sPK3Ngi66qDeN694DRtM21C HzyCv5mMmDaypAL6qaX0kLHCBRyXQEWHWS+X7MqbxahGwsYOJcGJXibm7K8YRGE2g+soFXlDusS nFeOK0FbGakj7aIz6mz1frzRmnkPbd9oIW0LOoDQtlp/3Nb3RLGK+QyqSworqclEk7DBdOmsWnk cN2VH1pm35mTj6c9aFCZdXvHCJfUr8BNa+srpB7xgEVdbnSuKK2yjJ2JdEnApNSC8Npqi3DWrXa LLVuK3Xz03oOhZXAS9FMjbaJrdNjrRwyUcUNcwa/U07O/vzNQc5tqE2773rxrxqnBG8m0erd0uA HrMF+I65OgugqLhMRFOXHGPTsIyhZ3bawd+3c1fr31cRh3/O6Yag/YA+eP7p2FKh6ezNMlUDBHU /z+cRE6F9vkYe6Q9M7bzvm5F9FWJsK3Us6DQH5a+zO8C5seKktxEvNMdMkRGMHGzwDqnMGVLJNL 6cMR7CB9FlFipuw== 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 ; Tue, 27 Jan 2026 08:19:56 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8699 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 Tue Jan 27 08:19: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: 79800 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 175BBCA6CB5 for ; Tue, 27 Jan 2026 08:19:57 +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.6061.1769501990838460730 for ; Tue, 27 Jan 2026 00:19:51 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=TmRJng1Z; 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 5B4151A2A69 for ; Tue, 27 Jan 2026 08:19:49 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 31DCE606F5 for ; Tue, 27 Jan 2026 08:19:49 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 08AE1119A867D; Tue, 27 Jan 2026 09:19:47 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501988; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=ZfgzgbQV/dkXIh2Jq4Thch9vM1ndBVV/vVu+v1hA5Oc=; b=TmRJng1ZyL96n6A6/8jgwjRtZGxMyQIcQg+Xoas/8QpQIyvk8ejkgG93UUdkr/K8UcT4Lg BGz8EBHnKrTv/dT6tOFs/1t/oiDYECqjJ2jCUQK/vDM+vQQrKtKfViVfUIT64nrapniZwK /Xq/fjLu3D2rKyqbXt290s+UUORCz0BqrzQrx+7F88rHJlr05yR6pRPn4JSSZR9fzZh20E /wzBlA5oSII1LsDh9FyBwRZE1zFtrNEH7o2Kv5CLyCnBqtC5+z8vX2v2V3cdEkc/ky4pIx HWT7hK+PViJiLffchnV5xrg6Vt9hQ7K9Rlt/kwuI/Ev4tmnsaCpb9VwAGLUPtQ== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:34 +0100 Subject: [PATCH v2 39/56] dev-manual/licenses.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-39-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=3659; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=KeBVoxdmcOAD5Y0eSJoGP4aMIFJx9WWSPZPuiT3xM9E=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUE/ml5XszyhzK+faHJQWChVjXeeO8aRGe4R HxJdfU4IaGJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BAAKCRDRgEFAKaOo NsJ1EAC9oxxnXElPFpSE1vOkz13bSqsVY4g76e2oQkUzHX1WRttfXQqeZQ+enDNOBq8GADtXQQi 9B24kFr8+vMpTHC9gh3wcGTNe0AdxM7oXC0Rh5H1659p1NmFh5Z4MSihwpdnhYvTaa2HQ+U7qyC 60E3F7QtlUPKymhsosgWICOs9mTfwxbc3HGjM/yGn21cagMeLGjphKVWx62A6UwLewqA/R569Na AOYGIc7lD5RtHAAwIPfeju/6IJlWQAfQL9Er15SaB3Hfolrw3D7mLnOMIFPaOtnlqSUSlqmxmd4 7SvIorq35aDuGf9ix93JHSZ6yEZw2tbcR4c9s2V9obi9qyNutbq2UEFT7xcWtGABN8qFtwO7Xlt d1EtY86XygSQsOCkFRE1pPAYNUVluhSc8QmapVTu+qFP47wlkFr/c1Iz/36vQCpe2xanbTBbHAB Fj8GMltme+8L1XdOGVAJ3Gypsv0S/vjMOiGnRt3Pvakn8P7Kyt7bOAkuAqB1X1Kn4TrQ1NeDZ5Z tU9tS9rwlcnptPAFpTsajSDGc7ATKDGSwsQFz8IItaW1RC/anabWQVvlPMySemr8w+RfF/PS/Cn gqe9dbwGw0TwUsWvIMcsSDAsl5L5aGl6S1rzAxzO5jnTEt0RpSajxdjLqbj5nsfdTBPPLsQs6ez g37AH5OTVpSx5hg== 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 ; Tue, 27 Jan 2026 08:19:57 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8700 Refresh the document now that the Poky repository is obsolete. 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..1887e8e35 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-poky \ + ##OEROOT##/../meta-yocto-bsp \ + ##OEROOT##/../meta-mylayer \ " Creating and From patchwork Tue Jan 27 08:19: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: 79795 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 0D5E9CA6CAF for ; Tue, 27 Jan 2026 08:19:57 +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.5820.1769501991563215736 for ; Tue, 27 Jan 2026 00:19:51 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=KLYFmwfI; 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 0CF474E422CA; Tue, 27 Jan 2026 08:19:50 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id D7F0A606F5; Tue, 27 Jan 2026 08:19:49 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 16C8F119A867E; Tue, 27 Jan 2026 09:19:49 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501989; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=NP5wtYW3GOOeLJCnGPEvh+HZe334NHxcZaiTHgqDEAw=; b=KLYFmwfIj/kGOX6311sQlaRRq/NYWuKlx/+2Ee3Ivk4io27+HPcbmuWJx+b29cwlf8vpjN 1ITFx+BH0U8/3rPC5yvORbWQcs+TLsjk5tg1e9KJvHCT4qz4v9aJkNT23dFln05Dryo0BS IxQpHKflVLMD5y+oJBIW+joeJsuDT7/L+uweVoTEbNMMNebonlkAY8ZrCuzcObv7Ob/0fI tEDspb3vvm3eP0C7NtVhb4YlyULR6QKOVP1rVdqVSMYmLP5QJ47TuO+5Y8kP8z5AsaKL+l xWXNxSkYiejkfYlXmiXGJkxWoE6JpM0UcfKFiNHGPjLbE7jZ0GAO+FhAG6YptQ== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:35 +0100 Subject: [PATCH v2 40/56] dev-manual/licenses.rst: instruct to use git-archive instead of removing .git MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-40-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=1306; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=RvzBOHf1wOecdmTFzVG6QU5n8wPoLUgljQd+ivVU1ZM=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUEyX3xn9dvNiQbLko4mG3h7gau5WqiWXeJH /6lLaoYGlqJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BAAKCRDRgEFAKaOo Nn1rD/4ums9HP+dqApVeX4dhGVkPsPkssJ7fdmNrV2JncOEynTwXcDeqU191bXPCPwM09lnohDZ DmMAU53h5NimMdMgiushvzqIqSZ/w49eVR8Yh+vShXDMlUczLZ7GIqvBxxD5WklYwaGOHIdSLbd BHFeKHB5fHg1NIIG9BP8vzq/4l+jFNyuAireVHco2jkoOGwaS3CZnXwlgcckQyIjDSX9ncTJQKa ts7dty+n8DX2WA2KmwPMGlCJ3X/4XTYWzOx8aUZA+uTZk1HQ62AGdLa6HJI3RR69JAwmctYUop5 vVPGP/2FnwGOOfPvgtAgHSI8uRvILqQ3XRM5sioANV7/80IqiU9590kOWYa1gWj/N521IK41oXm Zyh35xKrseq6Vak9Cm4E5QqSUu0uKcHzcc4jIu2aL5mNEOhHfhHTZgI5TkN4g8UTXtYt8ATjoTY GD/yASmV91aLj6U6FSPSB2VLZFMBVaJsIx0dRaT64irRP9jEwf0djswY0PUtqpe0OTHrU4RwC1v L+4nn5Ruse2ZmrF2Lji1n+wvLaV/wKvYqQrf6nStHQ7iSrRsC+Z9YjIZVfUvd90oF0UmYdg1SFQ 2BAS3mK3nZizLXJvGHqC5GO3K8CUWsxFQ/iISL2Tj8RLD5l0jKGQDhWg6O/wAtbaoNYK9Z0sFo+ aF0vd5NMU+3KPKg== 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 ; Tue, 27 Jan 2026 08:19:57 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8701 Removing .git directories is destructive. Instruct to use git archive instead. Suggested-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 1887e8e35..3d0167e75 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 Tue Jan 27 08:19: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: 79789 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 09D85CA6CB1 for ; Tue, 27 Jan 2026 08:19:57 +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.5821.1769501992449855087 for ; Tue, 27 Jan 2026 00:19:52 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=AoY6XnTW; 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 E78684E422CB for ; Tue, 27 Jan 2026 08:19:50 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id BEB9B606F5 for ; Tue, 27 Jan 2026 08:19:50 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id B72CC119A8682; Tue, 27 Jan 2026 09:19:49 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501990; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=uc5naPPC/jFgrosQJME9DT6dVMcPNGTuPvtdILwZFD0=; b=AoY6XnTWG9w5QOuohLX4np8LYc/f8oO+VnXNLBZX6U+qlK8tzDwZiJlLBPXWMHTP4ig0x+ 9U5e+ni2/efcIZMaZhpRI8MyCTVl+pJKL0f3I5MwQ+erdBDtHxISf78qE4F702ykaPd+iB o17pi47+oopHTLAa/+OaIAogDPtq7BxI6APR5aYc7F8EgBYyiUDDTjW9WieLS6WCY5VM0s TFycorJd59X2B5JrHnv472drW6tjfGzcLumLmFVh6JpehBcB0PEYMDQ5zxtIUtkhUQ99Hp bw/qUiMaOVxO6laDiBLB2AEWoOU75S705+Z1+4wZiypgOVGgVDaFTYCIv/ALdg== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:36 +0100 Subject: [PATCH v2 41/56] dev-manual/packages.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-41-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=2214; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=8PWtVlmNtQAq1Q01kEuUZZNhbU9Q9LdY+pg7hsNWEVo=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUEabGEwn8PWeWmo4jm1dcujMmuMKA7YIlfn RH2/nTe5WmJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BAAKCRDRgEFAKaOo Nh/4EADEQ8ei9fbKGM/CfUK7573yQh/0p/bC4ROES0Qk+hOlpsDLLHQggp1zyGAQ090lXVSNd8x 1a6CGJmUKfAvup1RM/rc3IoovXp9plxnJgs+l0ZgwHLA5rTQSbn6UxSmaVZNeEIE/LrKTjqCym5 on+ss4OyAXwggaIFUxWLQKUOWgyvNn7tw5C0dpS2ZLzVG2FRU28UFl9KQ03H6uhNJQv4XBqofGQ g45e1W1bq80TiYxXOFsATdC/s9fN3Ziq7UGGGj/quK7Ff7ofhatUASOOdfIb3rrSLAhvXqNFDpY 1ti+29nxHMWBZS7NamjPEI2842kFcxjLmR1lBZhIatvpJQdbxlu6H1tN80jLBuqYv41r1Lg8i9E RJD0LJlwIP8OPwPIWIE0HgCe96FkLUVGYMnk02x4FcNMLnDxbcbinUGszwWB3NMenuG74nNoNSk LLuCEcaRK9LZOlECjOLEhDRFduz9tvm6Jd/TYLSomI0JOAedhpD1kjS+P+eU7euRyDoP2N+wHyb 3NQA2ana2cbX7mF7qVC1e1+QcOzG2r6CNNBkVK/IH3Llk4pF5ka6ZaKiohMLAU0ceAxoBiCtk43 1SSGvPAJsBqx36bkEw8bMbwz7SakyvmfbbkgBwYTCassKbRTTuIEGdJggwVl8JOelpst+iw5OHq 7KY2x5LhJD7zahA== 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 ; Tue, 27 Jan 2026 08:19:57 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8702 Refresh the document now that the Poky repository is obsolete. 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 Tue Jan 27 08:19: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: 79791 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 EBBC1CA6CAE for ; Tue, 27 Jan 2026 08:19:56 +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.6062.1769501992920081424 for ; Tue, 27 Jan 2026 00:19:53 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=2E4vDHjm; 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 695344E422CC for ; Tue, 27 Jan 2026 08:19:51 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 3AD7E606F5 for ; Tue, 27 Jan 2026 08:19:51 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 94609119A8688; Tue, 27 Jan 2026 09:19:50 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501990; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=M0fLa08feKQhMrd0tmQkq6VIDfOPrb7vas9CtJ3N59g=; b=2E4vDHjmd9Pau7zE7k7WT/e8bcz7KPK7o6mUZMwmVPDtz3rXaMRurNJ23SEJq/MOBeljbM bcWDW+BsmSk546yUhLeRH6jgNyhH4861jPi7BgTi01tdNqAXpSJOy+w/niSImjoYv8wJES 6HaAp9xgvoh6y4dl4hhQUaXNNjmnRwUDAqwBqdKmcWWx5zDbx4WBUE4yni0CZ8D8N1k4zJ ROQNLIULFe1OjJ9z/xlCB2kY2zHEdZtSdDXhpEtDBKPs7dqpOUacZETgHUyHnTcj9ccyH1 KgIjxWs8s4fEFmNjNciZ/bK7dchkyJcz8Ay1rAJIdlWUyOFJNHKtrDarc8AbZg== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:37 +0100 Subject: [PATCH v2 42/56] dev-manual/python-development-shell.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-42-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=900; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=80Dphat1hwGYm+CQl51ke0fwJG4JFBd/awjFMvyNydQ=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUEJpFJOSKrnyL4nP70Ag+p42MMPhsVhRrGO EfN5Ri09eWJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BAAKCRDRgEFAKaOo Nn5PEACcggLGhs6A5zPdAkFIVrRK6iAW67vuN9SVonSIQYMwhuhjqLk1xhljNnxZS8ch5K4OSCT oA5nFMkty7OL+v3YRNNZTL7+PpVGazuuAo5MQVUT2EOyrclovM5pMaKsMu2iTBUJfFP1+iOYjop EXJhOdktoCkIDhNOmqpd3AqYi4jz9dhgD8seRyx3tcxSnPpubakjAQD1km4+95JxHsa4g/kMbpv gY5RPvnCOlkT3PXlVhgBSSH/mELYLTaiRG6OU+qBOu+cEN1DZnler8pGmOEESBKeTUxrsexc1Gm 7WzfZHttxjBwywJ7YxTpeupJLR7NbNmBSKxlrIj3YBcqBWhsehHhj7nhi6LCqsPSaScYyKn+5WV fBYntpYfv3lJCWLe8/zW5/BMWWe7DDLq0UOi2F1mmvkwGWyrdPZHjD0SeyU+w8xOmV7XWupfifH 80L4401orJveZAYLbM4jg7PtKpue6j1A093YAJrZzyqdPlaEKTc7RSohY+Kh9b8/GaCwUOo8Wny CKHKpHl4PVyvNFVtt1xt5dsFgnGGigzQlqGQqMUxx75stciRmAd4dZylz6UkXwQi1HRrGMHR/hy F5+zsaR3EfYykPKHXwV3hAthP3LAABHQQPpcXTlxuufCRsTTqoXppF351eyMli0/qXiBJy9wWOh j2sH7gfXID1O0Hg== 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 ; Tue, 27 Jan 2026 08:19:56 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8703 Refresh the document now that the Poky repository is obsolete. 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 Tue Jan 27 08:19: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: 79793 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 E0AFCCA6CAC for ; Tue, 27 Jan 2026 08:19:56 +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.5822.1769501993364638573 for ; Tue, 27 Jan 2026 00:19:53 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=lv8KSoXy; 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 D8BA34E422CD for ; Tue, 27 Jan 2026 08:19:51 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id B0056606F5 for ; Tue, 27 Jan 2026 08:19:51 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 1FC77119A8686; Tue, 27 Jan 2026 09:19:51 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501991; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=yo83wQacKCZeEuudTJd4SsKFItaXQv/N1qRVjspbC4I=; b=lv8KSoXykaS2asCJ4chwlz1Uc3OPLH4rOiHlbk3RdyDX2FtX2F6r9ap2nHduqwOJYeTKKe TGbKM9Td451bQYkSfBZTmEfvQ7Ys4PTY3TUIqV54rIHWfZiscTOHiwFZclGaxSM8f0LCL6 WarFptsQms+SinxdosgAbnYLbRD9eU8tU3abEXAiE1YnyPauJMJASP+IvS8p9BlG51H/Lz B63krV2pYssaoUowtaYbVPE3LjRXtxmWXhZbUXr4v7/xi+P7lZKsmbVZwMylKVV09mKn9Z MFkbj7sZPvTek1Go/43cYQOXNvtFn/qoxJ1/Js53pINOYMaRpv1RXqI/NvBhrg== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:38 +0100 Subject: [PATCH v2 43/56] dev-manual/qemu.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-43-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=1324; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=XuTnRqelezwL/g+cykSRvm5yAQygV+npZg7w6+FeFbw=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUF+3xufA6SWLG5jRCPYAsbrfc96459y3Szo 4rrkE5j/f2JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BQAKCRDRgEFAKaOo Nu6xD/wP26qHSGrbVNucRbGP10ZvjJBrVjJFWmRqhgg0BuuMepyWIdJuuIKy3P4IU9vLzpjv17p Yp3cft8SZKMvwcx5XzFDS9iCHwgjpas81pwzDuTZF0A0Q/D9UFZXZfaW6hbEkLdKUoDPnWLY8Ep IyN8mENh4pzP4WckKxg00RE+uzO2bKbYsMmnrNlwBi770KRZ3DaNHJiH+wkMstgsfSRX8lAybBy pZLeJu2NhNQEv4YNrVxHhReGpicHmjWQgEAV7qOdAEy+L2cbE8QxJrj9OVu0vtJT70wmDAcY2d/ /mwzrs+IAff7DtzIfaRje6rXukwoYodYto6tO3zm9DBYkSf/6IoKDkfL4ubq/gwCy06h7dOQgb9 n/xynp0AoPd57trUzEO+hK4u+Q0vqKUdkCTQfoOdpSyWgl5q0q4mijafUEZL00/i4ib9xRu2mwd zCH8zGolwtFkSgoM3HLkxj5/+SF2pcJaIf0c77vk/rS8ZTwcbGuO7J6LEJhJakBANeCcaYhS3/9 xUktdGZtwtxN+dFpOFZP3d2rNGf9c9DJh6cjhvKyr6LLG7PCZbQKofIhwwlb1sgbYT/BxrgmIxl r6ez3fUy2cgolIb7NxJyZnvjf3No+mtsOg427TB6xwnFKTdGKHTC3wAu2ZjUDURnAM+siCSFuqh cCmPodPPg7np59A== 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 ; Tue, 27 Jan 2026 08:19:56 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8704 Refresh the document now that the Poky repository is obsolete. 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 Tue Jan 27 08:19: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: 79794 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 DCD7CCA6CAA for ; Tue, 27 Jan 2026 08:19:56 +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.5823.1769501994205221099 for ; Tue, 27 Jan 2026 00:19:54 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=KQ9iF0kY; 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 AA4D94E422CA for ; Tue, 27 Jan 2026 08:19:52 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 82003606F5 for ; Tue, 27 Jan 2026 08:19:52 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 94664119A8687; Tue, 27 Jan 2026 09:19:51 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501992; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=0+tFm9Gu1XW8SeqW3KOxWFmk7sMMH3zr9I9/Zki6aGQ=; b=KQ9iF0kYF/liwcI1aJbSWgJNtV/7lrJLgqJDzDyuDXz+jNU8Zrp9CK31WYBP/UiDNtdt6t 0776dJorpTuQdjzACnPW7+kIz9JG3o8Rg/j7/OvnCKdtCN+Zg9EjJjwU7BzIzFP9qBjQOh D38BvJUjgqLm3xASZQHHXTWx4HkRe6Bq9ZewIXamRKWXR63LPZLyG8G4NiU1Tq97OedmZz LxbqJsKw2lnl16EKf89/UowFRnjPcWOEEOTOcEwVe0XT3TuurSnrhoHrBvfUHoc2pRWq/i qByxraIQbnuiZa/DpnfvpzrNp8jj4sfzuVH0+UmGU6M1PIMWe0vkVf+66bD8bw== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:39 +0100 Subject: [PATCH v2 44/56] dev-manual/upgrading-recipes.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-44-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=4928; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=BQVc/Vj/Z58qV0jzjSvi5UTviY9zAPjJOXLYgpb6ULE=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUFcjhvs7FxOIzcHnLn3CrtN54TsO5jazt7F /Hi+leC9xyJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BQAKCRDRgEFAKaOo NiU6D/0YhPnCx/H/8xLCyRQHKa1UAj7Q9LvIiV4jVrd/ecGbZfw/PPsaiOOLgq0dfCA/sOVPldp tRpdjVIwJx1ojTLydD3Te/MBFeqV6HJ0yya/R6XshF3ZFhAgmawQ8t3680GktWVFlxqoAyzVOCy CK4HHfzoW4kQFX+Vyo515HL8Dq1StIo9EkRzFv7yuaHSAoBkhbHRDtxyrJjfwWrPf+NVJJDvwVO D13Uxg+rFFjuCn7hXMNINvxhYQag+K6GSQhDDnl1Q5bv6stWkqI2yhVNakoUOYcseIgQqHZTp/N pSPx7Uit1YMBpnCklrJV0sNyRBtvd1DumjbwIBNPruVKzSSGTNRRTHrj1E8mxo+u80wdHH6TPwV U3PfEggdw8IaNlAtxBMefooRnnEyvCMpLKCHcpuNRE6/c1flAY0aUawI9qjkR0cCtyd7HQm4JKd 1tWzzI4WanWkzkavPCmdjyZB/oCvs1Q5WMMhsBrOyljSRahw3IOIie9t2uoxjia6mgWjqURoOFW jHVx/09J3bIECIG/00oE+OQ4+8YtFTg0+zsICMeA6JRdZUJH3vVbkAjoOyz4/PgM5d4IecU79du 3ZFpD5SGTdtX4YdaCGe9r9cwGHMJtQnP6aHsNHnttHVdYxe4t/xjr0conSDSUzmNz8GFXwo6bQX tnHDCfv0Lz5DEqQ== 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 ; Tue, 27 Jan 2026 08:19:56 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8705 Refresh the document now that the Poky repository is obsolete. 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 Tue Jan 27 08:19: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: 79797 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 CA770CA6C9C for ; Tue, 27 Jan 2026 08:19:56 +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.5824.1769501994894816478 for ; Tue, 27 Jan 2026 00:19:55 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=o/2hYE/b; 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 605DD4E422CB for ; Tue, 27 Jan 2026 08:19:53 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 37D83606F5 for ; Tue, 27 Jan 2026 08:19:53 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 669B3119A868B; Tue, 27 Jan 2026 09:19:52 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501992; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=yrWtpzn9Ia2OPJ3220Me+tg+TuaHUV4PTp7MV85eTK8=; b=o/2hYE/bvrVfrQabFKC319osKrlD/F+e6YMT4CHBhsVh8riGjS2ZKrqvq1Ws2ly6evxLro KpHPTJ8JLrwycySqpOLSPrSj43WB+58SGkNNX8eNLZ6rA52/xWdFiufdnEU4ariSndN8eQ 0zChlbrYpMUVK4uPhvbes6WGfBa5/mlFeoOptmaQcIhjmgFjIsvdHiNtuhfnZ4/baraJJV UGeBgPOUpG/hk6Cc5uyoQvWItuFpfBOQzwZhwU1CSYKHfnKyOTSp9OUjduRKdUbOlMu0/y QGgg9i8nvzI1epbTn4tXwKN3gY01zPCa/TLezO3fMfB8iu9C0k7uLFTNj4FEig== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:40 +0100 Subject: [PATCH v2 45/56] dev-manual/vulnerabilities.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-45-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=4479; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=eCamXmssxLrkvpPYS2dB06tvfV17l0tCoj83O2f1LG8=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUF9/nOpu/nxupwiCZQIe3XKqki36dJU7S8Z ZNHp5xJ+nCJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BQAKCRDRgEFAKaOo NvK4D/9SX2SiZhyApYIx1DUlvx/0qLRt5Bh2/ATEs5OBcE4AznjzxhY86qAPgHB6cgvSmHwMhZx AtADJEwg9qetlNgtD/bChH5Dp7gafrai9fxbxrZVQK4QYgnq5IzV6A2pdEGDf4iT1dQk53iPpQs XOVL1lMQqNbCag3tGARGk/L+e5My/ngDIgNuP8+tNqVMAKK1X4865CvuEB+IFg73E5hbmHkvsXa Qvp+9QetmICnCuvz4YLs+OAAmkoTxhYCII4kE0EggG2AEldc1QKQC1JZ9lXACkbGIhD/MZJs1Bf 4Wsd97Htro1IZrXaWkIqKbJYIcDy0duO5KeVfGxzG/f0U7O6bkJiKAq9MqLm7XmCEuS78fFR2Ef Z/GafmmkHa67bgQ3ZZAHaFKci4e6t6TUc7V4517Dk7ayNgaS8t+WNFmsS9bj7JJ7UtcDYlokLxi fBHR3H0PUxkGgactej+3pAeRvl7Q9NnHUUJcTE8HFR6mzUwHYen7Ch8gm3z5TTXZoW/n8zSuCUP qIKBS2zrc8GlsAvqrAdiS9hBYYAcLsS1w23IgKBs4vcRvq3y1i51GyL3c4Mop3qq/UhSmkYt7Qw RLZ8p3oWYtwQCJ8d3o/liniZbvTM4wfVHqiCQvOo0sJAWlWxcoNSvin8jgz6z0JV1y1bqca9U9r qsYHW5GLRAjypWA== 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 ; Tue, 27 Jan 2026 08:19:56 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8706 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. 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 Tue Jan 27 08:19: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: 79799 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 E04C8CA6C9D for ; Tue, 27 Jan 2026 08:19:56 +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.6064.1769501995459286196 for ; Tue, 27 Jan 2026 00:19:55 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=u9TP6aiY; 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 E55B94E422CC for ; Tue, 27 Jan 2026 08:19:53 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id BB9AF606F5 for ; Tue, 27 Jan 2026 08:19:53 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 1CA45119A8689; Tue, 27 Jan 2026 09:19:53 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501993; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=rmIrF+MW7Xl0UUsWDwOrLpEGoeQV53EawFhd/Hpkp9M=; b=u9TP6aiYw/EaSwpFW61YrYlphR1h1R1oJOOnFzmMP3SyvQik/XKfkuGtQvetm0Z/UCsif3 AJR+h9vcj/nXPgwdoFI37RvhxtKYcxq4LlWJAfujDC4BGTxlWOMkDmH6HhFpTPfRy4tO9i sPWnL4fCiVBcHKSSVi9GZJ5W5JceNHlosYAvxwyIfakISGp5tCBG16vD26iOQzNkaZnlwZ zOjQtII+UhKE1mQj3Hzz5E2mRdpFiQo25ZtNoaSkNBq2JN/cvh1tEYG5EkkSrgeCHBIDf6 ARlnRtQccWJResWLQRarKX+emgyrcmLNQNMASkXQgzzJjWeS78KZjZj1r3/NJg== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:41 +0100 Subject: [PATCH v2 46/56] ref-manual/devtool-reference.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-46-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=2677; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=LmoVfPFNrfoZkufD4cmmhlGk+eTaezCq2C7zHOj/NAI=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUFs0ljp5d+R4Dl5ZCQ9ODstGzhdDBJOJedU jAqaRi6EA2JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BQAKCRDRgEFAKaOo Nm26D/9/cQPWA7fHmxo6Su3X3EU7v6sAdgM3Imydi4tWIQzfUA0zkySpOFlSf9ch+r9x5BP4Mcr MelYRZ/dfcoZO7EqmVHSJVL2DTvfjd2ar17SOXKdFF3qHae+3E2Mdrl0VA4OyLrb/kXy6xR7fmn Qruq/rgwBTljeArSy1PlSrTznPaCDAHEAfKpr70j96h1CoawJEARFD/jAgpbCgIXRF+x6w8XIS+ 9ZyC5amBMsRp48jiZjEfWTadUZhNYQTxsbuJc8e7eYBhSZyhngetXWfoM8bb9yy1KfRZS5cewft xJv4xgeawkwl1DT/VD32Wl5M8ViQ+o8hVSSCVULcue8gp7296e0Vw20OZI8iQuz4azo5XvPK0Pw Mk2bo4f1xS4sZmZsGnzIfhCkGeF7JKq3qxRuSHqmgh3mDGyeUwJWlaCyJHKcXxQvsr4DDR2jXLi U8R0Gys7cSbZ8mc7gVdoNrsaPi5FV3nlxtwq+OSnnFB2qSCZ6/DxP+I4eOq5QUlDE6MnsLZVQXb pl9bru13yBY2QocnmTcN72tQU/lbmpYE8ecDq/yK3Nb9COg+FiUMgvedQpuQxuqE0j/VpPn+880 TJgr28JDCHT3wp88tIEebOkNN7g8jmmcHozoODhOWrFRnfwq/BjoP5j/EIDO1NXYgI0HpFvyTdk qyXfAGdROk5RbWg== 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 ; Tue, 27 Jan 2026 08:19:56 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8707 Refresh the document now that the Poky repository is obsolete. 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 Tue Jan 27 08:19: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: 79790 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 B3CE1CA6C90 for ; Tue, 27 Jan 2026 08:19:56 +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.5825.1769501996300039424 for ; Tue, 27 Jan 2026 00:19:56 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=Bg+X3BNc; 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 BA7AF4E422CA for ; Tue, 27 Jan 2026 08:19:54 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 90AB4606F5 for ; Tue, 27 Jan 2026 08:19:54 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 9DCF3119A868A; Tue, 27 Jan 2026 09:19:53 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501994; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=66iQ+PB5OGc6tH5qBAFMXldPWFmYShS3p/JDodMBpK8=; b=Bg+X3BNcQbtndqj4tI/pCqOPEQvwPEFJqLV2leq62Jhnj8RrwuX0hbQLvVYnVDw36JjeR7 Ubm6Qx/b0KooyF+QqZoGAAtI+SaAHEX3CH0lxzsW8MXBHfa8+7xoxzTY38PLxf+s0ZSgnQ litBawe6J610mu9sEHfChXGRNiBUsTfUu/UfF+PdPH9P1i+6Ko2wK/pZsLA3BZMN4GPNZE /BZdhc23sVFYDvwL94bElHZt0pb07yG/PpjqfoEUmHFVCp45ZoOf44cqkviJOWHPcSWZ0I asL50xtLRPorTOeOcttL5U9sZ29AG2j0UdajI77P7TlBguhKovtqoMqO7G4VTw== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:42 +0100 Subject: [PATCH v2 47/56] ref-manual/faq.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-47-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=3877; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=u1Bm4CJRIWb/thHH56tz748Og6Q8FY41T76ip2x2D4c=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUFIvWK5IY2EKe7vGXSbL+LPyJ5nr5xu7842 cgByRjYi7CJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BQAKCRDRgEFAKaOo NjvID/4wC7se8d8JuFW/oFwHMxRhMmEtuIPT/KIHnnMxvy5K9YNnr2VQdEcdM321KdavVq++nqx ITU7lbc5MZIQYmDkj9jFxUDKw5KWhC5Up957SYWtXKgc/eUayy1Q9T7EIFMTPepnmOESuJqP49K yAfKxQ6Q42Mu5+gtifQPCakGzjfwgHdVph9+GwPPY4WZ2G5ByNW56vlJJBDUTsGQ3+ECCTT97Cl DYqB+edoXjL4jQJimD4MDGL45MuWMGSmm+7iBFhYWWuMNRFugIvTHpxCKmx6mJc9jE/dB/B27ki NFw+hknCFKnrZcO/vo2ZmwMo1T+uR9KfSh4MU9Er4xL0Ly1qqaY3izlTFTj7Nu3qz10bfL2zr2D PoOt/H808awFFawcfxNDkK2b1wktL5uDzN3mj6ytd55/IIljDZO5ajX/vBcmKde86UEJkys9BzX tLMJ+6n46nRdj3YYIY0Zyzk7d98x2aagsoy/3Lqg2H9YgN26PNqq74r2xU6LkSkLkg+bihCSEvV s2F7hoNYfykh1A3srYR5JjrtsSI2/UaBkeXKXiCBvT2wW1dphB4Ah4d29vujRVpRB+fLpcCDOc8 Vjj2EiRQQr6ub4a1SD/BT96sXxmlRIGXScgpi++snFcGb4q7GRWGKgBPPaKqn7LJljglD/LzNhp GQJzkiVIbX+IF8Q== 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 ; Tue, 27 Jan 2026 08:19:56 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8708 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. Signed-off-by: Antonin Godard --- documentation/ref-manual/faq.rst | 43 ++++++++++++++++++++++++++++++---------- 1 file changed, 32 insertions(+), 11 deletions(-) diff --git a/documentation/ref-manual/faq.rst b/documentation/ref-manual/faq.rst index 6c5b9d4e7..7557a7269 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` used 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,8 +108,8 @@ 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 +download directory. If that location fails, the :term:`OpenEmbedded Build +System` tries :term:`PREMIRRORS`, the upstream source, and then :term:`MIRRORS` in that order. Assuming your distribution is "poky", the OpenEmbedded build system uses From patchwork Tue Jan 27 08:19: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: 79804 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 458A7CA6C90 for ; Tue, 27 Jan 2026 08:20:07 +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.5826.1769501996896870949 for ; Tue, 27 Jan 2026 00:19:57 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=IftulSMQ; 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 3B553C211CD for ; Tue, 27 Jan 2026 08:19:57 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 41A84606F5; Tue, 27 Jan 2026 08:19:55 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 72A2A119A868E; Tue, 27 Jan 2026 09:19:54 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501994; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=vXg/YNLP+LfPpBXis64lD1mq8jE7D6DzEyqc3na0N78=; b=IftulSMQzCeYUaGuHzqEJggM1fXKu2YkdN3F5yEU4h3ceXlMeHpmLPbhhJPvEZfSoPsqUm UxDYko8FdL/tS5b/Mvad4jKPyN6NLd0d0qfGx7mKlC597PIhWOmuObcmEJaorg6Hla2jpp n8fXvSrd+w4Oi//cqNICYHDFQaWKEHpNbuMBElGTHI1fMVtmQAv0BQ7qpBmAqOFAv/AHov I4VRFZk5bGceqpgzD5Z7HaQsd1tdNA/GmfCnrXiE7LmaPzK5FLWStmXKBpPOdgUi6S70wW KSFx0tL9O217x/CIx+eQgxy1LIuCewCGnUseiF8R9jX8PvYYHdLnAAH1YjlbyA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:43 +0100 Subject: [PATCH v2 48/56] ref-manual/features.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-48-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUFsaLZ14d3n3ecNMpnqwPrjD7iAEjLcuUj1 0ibJ1Y9zL2JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BQAKCRDRgEFAKaOo NiA/D/9SRDv5kZysDzbIUDKPf5lbLKnLG0krTkjok+Blel0IAo+rHLNx0cGHyzXpC2Sw/b1E/pI iPsbzWjw3Mvkg6GzzS4zu+wuejmq66wHQbr2iXaqv098UUy8PRF4GUX8b2iAb0We/PL+Ic43SYj irZ/ubWqjGvmQ0DQb4MVKGmt7d+H0I5OnXL8cvD7RNgpGCfRCxnsM107cS1YYkw+aqgoWZzJJQV U9H0Of8l9xbACZtjEiawVGd7KcBcWMpdgY+/oB6Cx2ZmYh2sEhX061/wRhHfQKZ3cULPpalbhg2 pWeqSP02M6TN70Rz6b7DsUis7u/04ZAh5BxXPU2uzETMSfNZpqAv+qfq3Pu1ihXUGx1KL7lXFdh Cz5DHlQd2LsU+Mv47lX+Yq1gpe57VroSBKC1bKha0olg1o2pxN4YxQZnxWkTxWE0gxEahV6M+vi W2xdbuQwfYN19zP3Vfjb4f+vDewR9sakTBXI5upSSH8S3Lk1aDoaK+d1z8v66cqr+79wJyDUmhU 0ULtA4p2BbScAQDefcY2gTV5pyNY6DU4jOj4Ft4PD3pd1Upr1bFzRgRUKzr3Ym+5BUQqIEsSlqk iKn9sqCNqiYNQkGHN1Ymsi9J+iqxKsjGxORItS682FcyWe0XtdtcJ4DXacOvOpK1qoCIYzOi7Gq T97B1Ytnq7xNJ1w== 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 ; Tue, 27 Jan 2026 08:20:07 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8709 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 Tue Jan 27 08:19: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: 79809 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 62485CA6CAC for ; Tue, 27 Jan 2026 08:20:07 +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.6065.1769501997892698160 for ; Tue, 27 Jan 2026 00:19:58 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=p3qzfshM; 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 5DF384E422CC for ; Tue, 27 Jan 2026 08:19:56 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 33437606F5; Tue, 27 Jan 2026 08:19:56 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 1B666119A868C; Tue, 27 Jan 2026 09:19:55 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501995; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=3kq3+hxUz9p3CM01s0RFmZ26oyNeHO2PGj/RGKNndIM=; b=p3qzfshMkuwPjz1y8pD3/JnM2uJnxlbEit9Xjft7/7FfjY+vRBOPxQa0pzaFMvbl0GLnQ1 EuWTnv965zkUTDvaRlK5PHt3ow1lh4wa+9NhJxKpnSMt+5N43SODjxcfioH7XEpec3/N0e wP+i+Bg4yuYt5Ilbq9wom6pJdvEgqzUAyTMVaoFiokWwy0oM2XVkb3jhYo6W9y69ZgOJAD U9fCSXOXX1mWVrK6M+etxF1QQxgTUFQ2FDiMA4uKhKBwJONoKHnhNK5uCp0hDVWtgCeLp6 GYPq4b5qtF6BQhMmG2+AYoSWMkgqmUsVVGRvLjfm8WVyGmzQ329Tc8n0J8eZoQ== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:44 +0100 Subject: [PATCH v2 49/56] ref-manual/release-process.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-49-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUFacE3a9Uc55C7jOh8rETXVzHeXsypGElh/ GHTjFXRRfaJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BQAKCRDRgEFAKaOo NjfoD/oCvHHoDqk3MQUBauWsop81xLue7dZDz7Jd0xX6HocRG+TaESRKb2+NJ7+pI3miB36aA+8 nBNgrZvr7/Pk+7ehXSixFPg6pwnoc7mCTth7YMDc74sySKn7Z0KEns3qhJ9mUqNq6ktE0agHJkl puO7RytMsD/PRhOr4HK2sfwFFRJje+xcswe8TotP/S3k93vhipSpcIw/FpEvT/MX+W7nOagNwv/ kD2DjkRATV+J6booebd0I5W2dkTxjNO9kwVLfFX5w5D7JTQ7m9XpEXtTHqwWlFyswn+0QfYtt0z qiDtqekV55wQQwQRoI9CNMQ9BkOQmSxJxdXMPSiVuZkVqD/MfLRzgKVfI/pxa8R6e5SujYsAzjJ G0nuknByvtzPX9FqRVe5qp0Mn5H6UKxuiPPaMp0SOFn9dHWztx10k0/swYqbVZElm2KnuIFE3SQ wf3SCxQSX38kLCJZW6VPM27ICpIvl+vR+MKOc7L0OcoBatBumpyWbtsx/1rhiz6RQur3TV9Pcbw XBO1uJLprZKnrPGCXXdEcYf9/38lyJm+siufLwrw9qEwhwVol8yWelPfiYjbLzqR3LCg/9dDHpF vcg3MtKKfxx95thsxDaRTO1b9ghk2fUiHVkjZZj0KYcDdjQhpNWsx6KmbsZSqgdWR+l7ErvALLD b+3GYi07QqXLbCA== 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 ; Tue, 27 Jan 2026 08:20:07 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8710 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 Tue Jan 27 08:19: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: 79810 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 8DC94CA6CB6 for ; Tue, 27 Jan 2026 08:20:07 +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.6066.1769501998333793544 for ; Tue, 27 Jan 2026 00:19:58 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=hS3vFCq1; 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 CB66DC211CE for ; Tue, 27 Jan 2026 08:19:58 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id D43BC606F5; Tue, 27 Jan 2026 08:19:56 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 09F31119A8690; Tue, 27 Jan 2026 09:19:55 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501996; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=6UsqJayEQ/DFMti+zf19QnfTHQq+Jq6MrrERdL3NCk8=; b=hS3vFCq1+jv00TBvbypZ5qnfiEA1WU3PA10oCrbKe7rIETYBCJblPBXXEHULOiy0QfWQGO cY3BZxJQVuYS6GGdSKg7syOcI01h0/HaHHxiiXwJ0pnw9MW/27Bntlf6jV7hjO/qbZQ02O fI8BMiLtkSu2zM2xEpkdgWQPwLOdUmtv5xl9snZLVOjVicjQmVq5h6wajo7YtCKGJwZWUq 7kFgFxu6sl/EOXuqMkVnn6FmmDjT+cAhdqg68ZsAh7T9tepunEgHm8tlmLEbHGnoVemVce touckqWrcvvt8KdQs35ZwVdKvrTIiTV6XJ6h/ENWnwWnWCqMfLDpyULtFljzRw== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:45 +0100 Subject: [PATCH v2 50/56] ref-manual/release-process.rst: remove repeated "in the" MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-50-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=1150; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=zcJKqoZQNKQ/t7WC9mjWtxkM+8/LuydoFw1SQ4WNO+I=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUGc/DzrdfDI1g8OCkkeqKujSsRZIE1lKPS+ A8prALOio6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BgAKCRDRgEFAKaOo NtCwEADMSSwPR3BslgRgOX7BcSHqVOZSKG5ectQ4LfRUAj4msjVun9vGIZJ5aEW12I8iai/46yc Umlt77uUPcHHy0Uigeqbhx+PJUKHjpA76hAm2jMkqBKPUnpnXUUMHidMKLxpD5pq7yIqSuxVSlX k/5PTKpz4FpTdyd0Vq5isPk+T/k3SfhsgZSJn48RhlguLrGW5DI4/PtSNy6VVNrlY7RADKCYS/X xfP9l+nrZpVuZxGHEsul5KjroKWKwq7OvmIYIW9xBxfg9otBAOduR5sPG6cZuleeT+HFNEHxi6B hRrE7UbOcTAyZML1LQnCJu3zHlnobUvy63t/tDeo4ppnCFB5nmF2HAJfzQpXTW1lSxIO2qt5Svq bShdJ2NfUlAVMWA2s01tWm5UdB2YkOT9PGNWX4hSKo4jBGzTTpxZeRJS/S0A1dHLK9LYrPFLJcV 3LK+bfisaeawDonX3/zy8pHqm9b2INTKv8hQ/WdFw5daZi8DD5gKIyFwRO9yWMEk94Qp+J8DK75 wSujlwTsxMssTrqKgDQDZhKrDNqRe15OeqRlMKT0yy6a5tVZg1KwgboowBaJXxTufBptUQPxAqd 7jy4OPOuDH6iPPRjfyYeY+SOlFNENAoddF7pBCFgoX7DDZbhkeRk1GXDve1024ru49yvjUgYCoq E66pP7sHmM8u3fg== 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 ; Tue, 27 Jan 2026 08:20:07 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8711 Reported-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 Tue Jan 27 08:19: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: 79811 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 79D8ACA6CB8 for ; Tue, 27 Jan 2026 08:20:07 +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.5828.1769501998925661170 for ; Tue, 27 Jan 2026 00:19:59 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=OhVYgJDT; 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 6B4DCC211CD for ; Tue, 27 Jan 2026 08:19:59 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 735C7606F5 for ; Tue, 27 Jan 2026 08:19:57 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id AEE2A119A868D; Tue, 27 Jan 2026 09:19:56 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501997; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=T9jmZ4xTrvaDONoh+2ttyhTAw9st8sDCNvIswmAHGnA=; b=OhVYgJDTVVeL2JZoiS+XEd7t7lxf8E0q6qjzOdWFKXAzz9MiXH4OymcA122RZJ7Khu7uOh ZVW+SKYEFvvxKEjjFGkxtmXBiF+RRSM7tFZ+GUkr9H868U10S8P2G3TkjNFHIjH0vLexoO qXsIS7PkPPJJJU+7ze6IX2bAUI6USZ2HYLw6jpVddv3WNrBavQa0gEFDrGYUleuGBKtnU0 xrn93qmd7CEkIGGJh36sJEB1IWaAofAmK4fIYE15BhgTDIROqXaW/YKawMTa26PIdEMXqI Q1FAznPul+vin07Y5MNZ1/Go08VEOUsGcdL40PA+iW0fIqlqE+WN41tiL4GBfQ== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:46 +0100 Subject: [PATCH v2 51/56] ref-manual/system-requirements.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-51-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=2292; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=RuGuem8CoQ014zvS1Lnnz/oHgoyKrwfCi/dEqiEtPEk=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUGF18c6gGxWyqx0PKzjh+0aEpY900pVI3iB zPkAYwc3v2JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BgAKCRDRgEFAKaOo Nrq3D/9lPQu8TvWpVexBySotBmHJQKImn0/YRz3tJVUUzHc5BqHCOa4kndHDP+wojayTbGLtGed 5uZ1PpJbfV0CPNl6HMuGf7GlECYl5i5T4erVln/U0Ii4SWr8I84YFkpm2hqNBfN8YNl8wfcvPFF wDRaKTkHmmPpq9s6Zh7PtABlz6823oriFQMlpvMccW9tmDXuSsQZOwpPqRhx07eSQMR3DKQxMaf n1lBcIIYYOqJofGS0bq4LR6Q8Th70qVPWQERqjFvlMPAc7CDJDLOTLVyhMcwK9JPc8R7IiBz2Gp nR7brnHE74l91d4Yc+d311D+P+6U5QWVE+supkNX3E4uYc6zLkW3ekua9V00qKpVjTVfO7DXswA v4Oy3zICSUnHVdXRAwjenrwAMYfL87EkFkcTbQI749wby8Jytoz9NqV+nG5i+O0Ej0Qxamgrug6 DImOUfL3nw7XcEPJu2h6WcIiEpl7/XWHzDjuJvN5FIJRj3Tpv/XfK6YFR1qEkZuGmgtwhiq359Z EfH2nz3CGLN9tgiNYNncWQ5kDFSoMYlUrcbtBunz0dPHDyPikWmCrgO3+CzKaS3+tk7IzyWLQIi 5aPawU9n+8DTO5uItFxBJw+kRZkpmllWDAGThylJs9G3ZrA0ejcTsYmfJfhp03grOAEkoShdBRR ZRVL60pEd30PdcA== 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 ; Tue, 27 Jan 2026 08:20:07 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8712 Refresh the document now that the Poky repository is obsolete. 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 Tue Jan 27 08:19: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: 79807 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 4F8F5CA6CA9 for ; Tue, 27 Jan 2026 08:20:07 +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.6069.1769502000162837943 for ; Tue, 27 Jan 2026 00:20:00 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=YfJ/nKjX; 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 ABD261A2A6B; Tue, 27 Jan 2026 08:19:58 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 83B52606F5; Tue, 27 Jan 2026 08:19:58 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 527F8119A868F; Tue, 27 Jan 2026 09:19:57 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501997; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=KwQa46a95k2P5xtQgi4afysib5FX1pvviAgQavHYJeA=; b=YfJ/nKjXVw2YM92dPZrccEm2KsEhbXQ50zZcWYGnVojskdI76MmslrX8nOPCFqeEcAezMJ FTRRk+Qm3ca1HzCe9NhkmnPB+cCYJ5TqEmqNkvrG7Wg+lgLx27mi4ciKOuyKyeMkQLl+Pw Dw5k7REY9TAEb2cm4Ie2waR47ehaIvixZK3dh4pzEti+hyZXqx5L5mD5yqOWiDiiLgA4FR d8kOn5M43XDNSKUXdsTm3U/3/V1T5e2d9XM4RxIlGi0EXzHkBXteB9ywPBxGMlfE50N3Xu ZPCzKgKYcl7hRnH+mVT6HvgEqogQOBEwZu09vrsoWTvaZSynvm3prLjRwCI8BA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:47 +0100 Subject: [PATCH v2 52/56] ref-manual/system-requirements.rst: fix wrong path to install-buildtools MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-52-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=1247; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=yG4/Qc0oHy2mGSfxF4bE5KAqx+EE9T1iBGknSqxApSw=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUGOH9qa4TXBR+JEvbKg0ZhdP5jKEBewpCXX hgWS6ghEcuJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BgAKCRDRgEFAKaOo NgBIEADEUNPwJ8r0A89DztdRMySGl+kP3yu5uMDaL40CN7KQ8gZrNSyBU5/dWUtxujcxo+SCY4e jW5wQ6fsLD7T1XImYhu4Jes5fdK0n++NmMc/W3BYVANPZKwZiUZp/1xfFTlKfVOG367eB1lfOHr QFm8h/RCenCmdNRNFEUNhzVUr8ZidVM/feBkdg9tX++U+vDu7x/KIub41jDjvAZE6Pv9UCJBUTa IL449L6fiXWcOeKz4Iiu94Ee0s2U5/P/tHe6u5RcmDtz47cqLZOgVKbuXXV4xgOaRLaqKsbtLyS KaITlmQYJ3XuO2Jzxn9Qv/dm8nJLUoOqVraRc+uakG0DwKSzZmHeupkliXnFWiJRaSiS8r0k5N3 4KpkOUWhKWRE/YWXLUkwK9GS/ouNJ0IbyWDklgzUlyCkg62YEysddu+5bdcl0qrRN4whtwWvAtQ IT58kq6a4wGCBh2yBelX0178+ytbxZQsGsiTFzZqbXsPeobNV00ZWZ8Jm8oWz2hEpXk9Auu/wwa wiMrmUFv8xqf6Cp4jaodDAS1UAgdPvk5TADqzKsFW0AEf0nWnmDpCetZFs4Yj22WEvxMrUiLxXs 3eZXBZ3rYKgnZh6QWMF1F6yFvHQIM5GMNGO8OExUg2KJd/OoAo5jTBrMLq4XZFhgnP5BDPgYmQ9 Chh4nxugeVU3vCg== 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 ; Tue, 27 Jan 2026 08:20:07 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8713 Reported-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 Tue Jan 27 08:19: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: 79808 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 5D814CA6CB1 for ; Tue, 27 Jan 2026 08:20:07 +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.5831.1769502000811505229 for ; Tue, 27 Jan 2026 00:20:01 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=hzgimWwy; 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 4A8864E422CA; Tue, 27 Jan 2026 08:19:59 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 2282E606F5; Tue, 27 Jan 2026 08:19:59 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 35FAA119A8693; Tue, 27 Jan 2026 09:19:58 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501998; 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=hzgimWwyPXBsy2cB4Oa/r1YHoXaaunx1Jop71Ve9bHKOQ4rGiCEW13PtXuXZDoPbJxdPV5 YjHs0viBHGp/Im2R3wkptPx2ZtJtxdm6mla2XItl51I7mkfi/u5D6Nq0fBetQPbQsZ8L3F gAJuN+80b8jA6jpym88P91hN1G5W9K1zisE3XdgHJjy3z6vHHgyAkdvaNvO60LMIoOFBnZ QS1EzGAnXeTv+S6zQJVNkhYySiDuMS5XzUXt/nQRhB4r1YLyj62DWccELa7zeKG/f0lBbp OPlc8YjB6v6SP8njLxRRIQCqSZI091ylzBAT5VYjA1WDq0X+y8fJVXeUZxtqvA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:48 +0100 Subject: [PATCH v2 53/56] ref-manual/yocto-project-supported-features.rst: remove obsolete poky repo reference MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-53-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUG1V5g/xN+X+hHk2HzkIs+1hCjrXI4BeyiO yZyT1fiKwCJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BgAKCRDRgEFAKaOo NnWKD/9KUdI09QS5Z/rOSRn4Qk3OY4OpghMDKpunl/dM7oiUgC4xGRjJ/dRx+5Uf02Re7xqrLUk +b3q+ZYD2sS57tGz5mSz+AS6b9JCUM3nfxmx6YRCRiPfZqNViIPx40JHuP6UzcWIorXWnqahT4a h+GU0T2Kr3MoRZk7F4Xc8fYs1mYfwAfKz8nQ6lN1nmUH+Zt0vV62bQQX9GocAQ+Ouwg83jOTYVN bZoSEQvgkE/ceNtEstbCk5Nrild2fUkewtTtAcsQmEDx7ZF48dTii7dSOAmaFhnLVrT85U4Y2s6 e1pfXQ2Z3TvOrVX3HimFcth/BRyGYOkff1159PG2mprcfj6Qvn1ozlpVn33h8q96QTTWiVy4BiA +qFtCrqQa4VdZ0CqayEknshnXBiG/HSrg03xpqR3dU3JvED6zAhdptKQpyaxDLWiRNl30P4zksk Si/DMwRIQxxCij2s+y2XkAtC21yfs1srtuUS3/+tfTxyV1odSllpeKnHTFD1h+iGpcNfz+aXP/S rLDbRG/73jlJs7UxZEv5/U7icNbHOfmyVMjXmG8psJT7pIWIj5BTwZJ2xPYmMmgZ/Q9yjSXDy6G uPywwucWYF2BWwLikLNAnJk4+7CHOySMOy0G2AIwhm4OdxmBFR4g9vELGUqPyMop9WNvr400U5h f0D5ng/+vuYzkJg== 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 ; Tue, 27 Jan 2026 08:20:07 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8714 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 Tue Jan 27 08:19:49 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79805 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 54D78CA6CAA for ; Tue, 27 Jan 2026 08:20:07 +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.5833.1769502001901383893 for ; Tue, 27 Jan 2026 00:20:02 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=TYuKK2RT; 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 668301A2A6D for ; Tue, 27 Jan 2026 08:20:00 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 35F54606F5; Tue, 27 Jan 2026 08:20:00 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id EFDED119A8691; Tue, 27 Jan 2026 09:19:58 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769501999; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=eYBfodnUQoV6+Z+LZLKCM7b7cl0U9OnMNzUUls6Q9Tc=; b=TYuKK2RT0fqqI+RDODvZC84csbXgyYKB4O58duODAxC0SKOrogX45sjQxv7msFdSTBkonC FMPe7Ozu5AO+JlWaqXbpM9TVT+n6Nl5w1MZYH0HNB1iywu7g5xYuorHoy1ogk2TzYdOuER WxgZmRlpV5b2p7jn/sIhZF5uWyKx1jwK6sS1TgoF47XbiK3dSBXftWb/V1udLEFwg105vJ PUk12yDiK+4YDcJ8A37C6z+dJ/5SVFq55CbqmNjZ3JQEoszuGCD6Wv+7aN5df2Anfu7mIE THM+OY2O37Ri67CKkSxfZTcfPJ1Tmwr66naOYeEASaFCEPo18jOtNmy2wE1eqA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:49 +0100 Subject: [PATCH v2 54/56] test-manual/reproducible-builds.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-54-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUGX8tFm2rg8CLVYfrBDx7K739BWUWMorvEP HAxgI4iVTyJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BgAKCRDRgEFAKaOo NhZ2EACyE7BAQvHPA8n7vDVej+MfhNk9zDvPl3hxQh0Kn+uO7WwnKND7v2dEWHVhV6/+h4BsIAr KnVrRLlBwYLNiUpPm2nYaFpZGkRFt+sllZnBlD2k/tIeLLSa7skYO8N1tIou1JOep2/0VdFT+5U thi6WGH2Nnr4xSRkzWW0+UNAwubdmlu4SXIX1OtBrBTS9LyxCgGDBCD8hY9OtGTgALYqVyiBgu/ HCF6F2o9aKlloIBA/62/t5tM4iZgm5tbMLlluQW/GoGLnKIL7mGrqJN340tRPtBDe+ddRPhjiZt fuUdIr8tkkQY+HMwxEwdkRAr0uSlvlB5t9igOEl+u9/9az3TH1wjbHSjmz8uos2xUcB92BOJqpU 2q5/YrPNnoRhL2Ma98uNAUF/XIUABxzwHSs14dof7mjrgAT+5KNieUtkY1Xkn83MJSrdaqUR6R2 KWMaA4z4Ojz9T8hMg8kWmFFTzPYmV/pk2AZlW28fDyxYAL0U05ATHBQiFHFRdmY70lvlfmiAoTY bQRoN0KNFSo0HH/VRMck9tC+bgt2+CbTFc/GrydyN+XL+jbICtcddFp93uWRpSZPBrl15cHCqkH 0pnHE4o69e4UKHHBn6u0pWpd7PcV0Z2OiYmb+LUyZExi45YmmTCETUBPdiF8zIjGozG8jY0InqV xU2DLAm2UjfVOxQ== 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 ; Tue, 27 Jan 2026 08:20:07 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8715 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 Tue Jan 27 08:19:50 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79806 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 50033CA6C9D for ; Tue, 27 Jan 2026 08:20:07 +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.6070.1769502002316480482 for ; Tue, 27 Jan 2026 00:20:02 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=hhT6Xnpd; 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 CC7411A2A6C for ; Tue, 27 Jan 2026 08:20:00 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id A51C1606F5 for ; Tue, 27 Jan 2026 08:20:00 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id E7158119A8695; Tue, 27 Jan 2026 09:19:59 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769502000; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=wFnT7awETBxudAI63zbSBC+LPFCJomlvzlXHZnqVdGY=; b=hhT6XnpdS74H2neynR5T+3QJCy87EDG74WwG0XzYf31A9QVsEE9GpQ+U30lHOz0q4AIi3E vz7mp00yGp/NGUWmLzxylDSSxFes3rD36+D6+Dhiafr1OGF0dg1JgGU7plNRKgKmP+F7tQ ZWTD8w4+6BL09kr2FSiQvOT9+PX+POHU1McDSaq5foYXFcpLO2IFTqrtaVgkiAFSQTbyCI TzUzbDJggPDiVro2wUTFrAb1y+O/t1uIcUVnoFY6OMn0e4CDW0HU3g5IuGYhlbl47PMx6Y Lvy+a9UY9Bqq1Bq5Eig0N5fpjitdzBCbTqtr9mrBlvkqd+BJrX0oyReJ7Tu9YA== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:50 +0100 Subject: [PATCH v2 55/56] test-manual/understand-autobuilder.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-55-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=1302; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=XvBdEYiud49lGvLgPKSz7nkVP2sZSRZo1cSsu1lqEeU=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUGHeMCc7nfiyLja5vurhgIm9d/kdJm4QYQF 06c1OG8UL6JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BgAKCRDRgEFAKaOo Nm5kEACn1adfMLBi+2tkH/wxR8dIwwdHr4v93uG4cBbH6PIu1G6l4FVqu4pdhaVdu1rezinNJWg ct0ItNDdEN03pwOlxwitaz7ydaD/3htowaBEa8nDNy+qt6r/yhB48hDxVu6fGhms97CI2fNnZcN JbNewBQNeCegmHafpI2kcTYasBhs0K/vSthHKsgbMINjCUvWjXM4jufvTQDShrj+PwO031smPBb CxHx1VsyY9erOzuYbGxEZ2HQPLWK3QZLhyvTNdWjnZuRQDznQdBBZhNB0quIUaHmS1i4ARVB3G1 OuZdWW+bqS6CFcAqu7xNsMSYYsHvjdfFW433GwEiSMcho88yCjwJqF+t25ofzh5c8accyFYetuj +foNYTfmWcze4kyXvZHf9ZzFoK/QW5t/lm2QA8RF+Mm5F4QbB/PAJvgcYRikYzyLzvHl7mahgQ1 JukTxl4IQN4ErRyj51MVvB7FCOiR1l/HNO48tSOOTD9l1Db064KBErerCYjzEQfOG93vxpWC63b RweA7jXBIQZDRCz/O5wQBaVXDubxMOeKb/OICVmiOIcQniufJa5+3Ym+1nJOJl4fjGK+YNywvgP h8RlSdReE+nQF4pl84X4dSunRwlNzghMr4gjVVQcrEwEwtZuCGopkx4L6QO3efWnt5EHR7irULV RZPpEGogle1++jw== 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 ; Tue, 27 Jan 2026 08:20:07 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8716 Refresh the document now that the Poky repository is obsolete. 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 Tue Jan 27 08:19:51 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 79803 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 41D2FCA6C92 for ; Tue, 27 Jan 2026 08:20:07 +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.6072.1769502002870920830 for ; Tue, 27 Jan 2026 00:20:03 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=dUYzw0Id; 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 64D671A2A6B for ; Tue, 27 Jan 2026 08:20:01 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 3CD31606F5 for ; Tue, 27 Jan 2026 08:20:01 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 88439119A8692; Tue, 27 Jan 2026 09:20:00 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769502000; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=RZvA3PoQFjDryrOstIxfnm+KlmNzfk3C2wq1m8aqkQM=; b=dUYzw0IdNEgFYGEm2SKM8LJ5g/8fuAg7Ab3B+HdfDjsJEEs28sPMsarTtERYd0tE+MDbUq 23bcuFcw7bo9+NPIj+eHpQVw3jRo3ngKpyVWkjZH2P7hRVCG/aEoQbCUsPiKjfD//W5UZ6 203VVC4rfe281S3pZxHAP9J7yCgkk50VRFqpEaemQEXL3DscjyR9lQ9YLx/pb2rP5n5Rxu bEj0q6sXp60VdCFm90GLOE+KgHM4ucU/DyBlU7LGF03WaH/tSjx/UeC+aLl4KwJNPhU3Bk zRT7Gf2i6ORky0fL082hpw+J2LQDNZyZcaXGBGvK770s6081MnZq5/KCrhhd6Q== From: Antonin Godard Date: Tue, 27 Jan 2026 09:19:51 +0100 Subject: [PATCH v2 56/56] what-i-wish-id-known.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260127-remove-poky-references-v2-56-74bf80cc4e5a@bootlin.com> References: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com> In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@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=1145; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=s3WvyhDX8KtW3uxtea2+VTPZ2vfcQBfe33v2pAD43a4=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpeHUGSq1BHMrvi6VYvwj3CCZEldZaRZ5fye2Yp TG0gKgPo7KJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXh1BgAKCRDRgEFAKaOo NmEFD/kB6wBvLdCNprg45aLxM2aiz6Kihbg8Kd69prq5HSg+yNleZEMtYczznt7e9VRJfoEf1Xi 6WZi8mY7MAfxSQv+1ZtxitwTEMmOIyyltC2hBMkGgwNavEx2IYqumqSnE6NIzNzHaTAlcd2ESk3 WY+NeE+QnBuGfNWYm4EC4LGFdvg233o19br/x43ST0hKRYNzl+/ummpehTgZiXsHAkZXQ0o8PQL did6+Ct6Yifkgi7nfVw2fI8M9hXX2Qks5xwC2c5EVGgxwx5z30nv1bRDu/VqoAC0rADfcFFyCu2 8wlwyvaDZjJwrlkypXVsC5v7QTvP9v49vB02qwn+BE+3QJD1jc2N4NK+DztRcdZAywk68h393Yd n4PqokHUHHg0QyEDXSvXO/KN8WaLBIBLlzUuJkJ2Wf8TfFT3DohW/XnIXEnYmZVmVUnIV6EvuqR 9bikWO0FLzf/SJ8Zaiaz1AlgD0o/VOWdgOeKS3wFnB6ffJEg4Lv3wYbTIQ8xez2/VYgBRVvdEAM Q1FNq5Lzz2IVogbdhuY8svM9i1DUdIGBV7cOm55C6iwWN8Xdem9riq9Bx7bOvJ9GRrPC6bUGWP4 OC4i4UUxgY20+qZUmQY7PFSo3jCCqFPsI5dw6k22NvdnnyK++M5YMs2bVcf2vuS1pQgW8VMOF7y o+9pcn+BX78GkIg== 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 ; Tue, 27 Jan 2026 08:20:07 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8717 Refresh the document now that the Poky repository is obsolete. 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