From patchwork Thu Jan 29 15:23:13 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80009 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2D99DD6B062 for ; Thu, 29 Jan 2026 15:24:29 +0000 (UTC) Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17198.1769700259996853148 for ; Thu, 29 Jan 2026 07:24:20 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=LD4HxvRF; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id 784A9C22F4C for ; Thu, 29 Jan 2026 15:24:21 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 77434606FD for ; Thu, 29 Jan 2026 15:24:18 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id D575D119A8860; Thu, 29 Jan 2026 16:24:17 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700258; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=lRJ1dKproiVYX5jbrtY4m4y/HA45997KLd+7u19TcGw=; b=LD4HxvRFBxbxeCTHti3TFqW/9AIPCHPkTwfC2oLhRbIG3KVfo1TIAv6vsRxD+JKTzwunOB VjPdAij1eelQNuIEfmxTwzOiy0KSzdWv9+24/x884bVi+Nn6CbQsUMfkCjOCv+rduTrxAh +a9eUZclXTslkUayK1khvkqF12avX8XYrB47NmkPUMhwCf2hPWLVnhvbgviZ40Qb9T/rew seEzOIFLnTvsBjTQwyZcyQSh3KkSUpsnF3/JGx0pUt7paTY/txTTLihSDQCwc3L131WiYe SIYCrMHAGT+iQ7de9J70eeD40g9KO8ch3zpVircril/OhBCdQ5Q5wO94ywVRIw== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:13 +0100 Subject: [PATCH v3 22/57] overview-manual/development-environment.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-22-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=11845; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=Uwf/Ve7ZsX7/9Z8x/I4w9QopCFlWlEBx+ra3Sc+uPt8=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uMujrw+xivNlkerzyJtSkoFItYpV/TKFNxn 9AA1mJjc0+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jAAKCRDRgEFAKaOo NoDOEADNNyW/a0sdT2NMPVblzIYTdBAtZLzqsEwsAJX92HINolcpQhXjABF1e8G6BI/PdtWICwU +RKwE6vLZetO0QjdAgpYeazWAGXadgBBVjEqSZ3hV9FJz+CYIwxm96oQQnpN/RPPAVBGLyPqv3C zbCp+IgK3y+MGbV3pRg9oz9XOVOwrKcwfyR/zZb2A9PcjqSW5lpeGJFIKPM3oTGz1Vm7e+++RSf 1e6rqQBxvAqM8bVSXAlXZ6YTjAI/JFw0LchpVIEWeAMT4bekdC3iDVr6bVIbgKRRyu7C5FbQY9n ZbzMqGscbS1yq3bdawlTm4l1RRp+VZQnFTCe21CO4LccApQP3ed5M7KLQoz2Qdbr8qdBffhNN+x TKHqya0WYyAvCic4D2ki6eqpGO1APfIF5vgoKeja/nNdR0lYIzEOl3cBMWEQXKueKuJtCenvI5U ZW6BdRKwy0JhkWYexNF6/SQFYsE3BQHK+Y4ipMmZHOC8QTHmRdnMjRkGQPyOE7vHOB4Y1waVTB6 tnNUFKyGWcw+2gnzcUBwzsDAarz+fkTkCaI10xC/9Xx/sOWgfT6lPP9vPo0P1h756If6LO1UaPt j83iwkA6DcUBc9bcU7zE2wYNHwv0eHhvmWI++j66/Pg8hLubBM11K6WoyUkEP2FsLD5mS8eDLMY bAZzVkrSnwuYHtg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Thu, 29 Jan 2026 15:24:29 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8808 Remove references to the Poky repository, replace by OpenEmbedded-Core. Replace the poky examples for the Git section by yocto-docs. Signed-off-by: Antonin Godard --- .../overview-manual/development-environment.rst | 87 +++++++++++----------- 1 file changed, 43 insertions(+), 44 deletions(-) diff --git a/documentation/overview-manual/development-environment.rst b/documentation/overview-manual/development-environment.rst index ab9bd084c..7408a4c62 100644 --- a/documentation/overview-manual/development-environment.rst +++ b/documentation/overview-manual/development-environment.rst @@ -148,45 +148,43 @@ code browser is organized into categories by function such as IDE Plugins, Matchbox, Poky, Yocto Linux Kernel, and so forth. From the interface, you can click on any particular item in the "Name" column and see the URL at the bottom of the page that you need to clone a Git -repository for that particular item. Having a local Git repository of -the :term:`Source Directory`, which -is usually named "poky", allows you to make changes, contribute to the +repository for that particular item. Having a local Git clone of +these repositories allows you to make changes, contribute to the history, and ultimately enhance the Yocto Project's tools, Board Support Packages, and so forth. For any supported release of Yocto Project, you can also go to the -:yocto_home:`Yocto Project Website <>` and select the "DOWNLOADS" -item from the "SOFTWARE" menu and get a released tarball of the ``poky`` -repository, any supported BSP tarball, or Yocto Project tools. Unpacking +:yocto_home:`Yocto Project Website <>` and select the "Releases" +item from the "Development" menu and get a released tarball of the +repositories, any supported BSP tarball, or Yocto Project tools. Unpacking these tarballs gives you a snapshot of the released files. .. note:: - The recommended method for setting up the Yocto Project - :term:`Source Directory` and the files - for supported BSPs (e.g., ``meta-intel``) is to use - :ref:`overview-manual/development-environment:git` + is to use :ref:`overview-manual/development-environment:git` to create a local copy of the upstream repositories. - Be sure to always work in matching branches for both the selected - BSP repository and the Source Directory (i.e. ``poky``) - repository. For example, if you have checked out the "&DISTRO_NAME_NO_CAP;" - branch of ``poky`` and you are going to use ``meta-intel``, be + BSP repository, the :term:`OpenEmbedded-Core (OE-Core)` and + :term:`BitBake` repositories. For example, if you have checked out the "&DISTRO_NAME_NO_CAP;" + branch of :term:`OpenEmbedded-Core (OE-Core)` and you are going to use ``meta-intel``, be sure to checkout the "&DISTRO_NAME_NO_CAP;" branch of ``meta-intel``. In summary, here is where you can get the project files needed for development: -- :yocto_git:`Source Repositories: <>` This area contains Poky, Yocto - documentation, metadata layers, and Linux kernel. You can create local - copies of Git repositories for each of these areas. +- :yocto_git:`Source Repositories: <>` This area contains :term:`BitBake`, + :term:`OpenEmbedded-Core (OE-Core)`, Yocto documentation and other metadata + layers. You can create local copies of Git repositories for each of these + areas. .. image:: figures/source-repos.png :width: 100% -- :yocto_home:`DOWNLOADS page `: - The :yocto_home:`Yocto Project website <>` includes a "DOWNLOADS" page accessible - through the "SOFTWARE" menu that allows you to download any Yocto +- :yocto_home:`Releases page `: + The :yocto_home:`Yocto Project website <>` includes a "Releases" page accessible + through the "Development" menu that allows you to download any Yocto Project release, tool, and Board Support Package (BSP) in tarball form. The hyperlinks point to the tarballs under :yocto_dl:`/releases/yocto/`. @@ -230,11 +228,11 @@ and so forth. ":doc:`/contributor-guide/identify-component`" section of the Yocto Project and OpenEmbedded Contributor Guide. -The Yocto Project ``poky`` Git repository also has an upstream -contribution Git repository named ``poky-contrib``. You can see all the -branches in this repository using the web interface of the -:yocto_git:`Source Repositories <>` organized within the "Poky Support" -area. These branches hold changes (commits) to the project that have +The Yocto Project Git repositories may also have upstream +contribution Git repositories suffixed with ``-contrib``. You can see all the +branches of these repositories using the web interface of the +:yocto_git:`Source Repositories <>`. +These branches hold changes (commits) to the project that have been submitted or committed by the Yocto Project development team and by community members who contribute to the project. The maintainer determines if the changes are qualified to be moved from the "contrib" @@ -323,7 +321,7 @@ Book `__. software on which to develop. The Yocto Project has two scripts named ``create-pull-request`` and ``send-pull-request`` that ship with the release to facilitate this workflow. You can find these scripts in - the ``scripts`` folder of the :term:`Source Directory`. For information + the ``scripts`` folder of :term:`OpenEmbedded-Core (OE-Core)`. For information on how to use these scripts, see the ":ref:`contributor-guide/submit-changes:using scripts to push a change upstream and request a pull`" section in the Yocto Project and OpenEmbedded Contributor Guide. @@ -377,7 +375,7 @@ local experimentation on projects as you develop changes or new features. A Git repository represents all development efforts for a given project. -For example, the Git repository ``poky`` contains all changes and +For example, the Git repository :yocto_git:`yocto-docs ` contains all changes and developments for that repository over the course of its entire life. That means that all changes that make up all releases are captured. The repository maintains a complete history of changes. @@ -390,10 +388,10 @@ locally. It is important to understand that Git tracks content change and not files. Git uses "branches" to organize different development efforts. -For example, the ``poky`` repository has several branches that include +For example, the :yocto_git:`yocto-docs ` repository has several branches that include the current "&DISTRO_NAME_NO_CAP;" branch, the "master" branch, and many branches for past Yocto Project releases. You can see all the branches -by going to :yocto_git:`/poky/` and clicking on the +by going to :yocto_git:`yocto-docs ` and clicking on the ``[...]`` link beneath the "Branch" heading. Each of these branches represents a specific area of development. The @@ -409,15 +407,15 @@ development branch in the repository. To help illustrate, consider the following example Git commands:: $ cd ~ - $ git clone git://git.yoctoproject.org/poky -b &DISTRO_NAME_NO_CAP; + $ git clone git://git.yoctoproject.org/yocto-docs -b &DISTRO_NAME_NO_CAP; In the previous example after moving to the home directory, the ``git clone`` command creates a -local copy of the upstream ``poky`` Git repository and checks out a +local copy of the upstream ``yocto-docs`` Git repository and checks out a local branch named "&DISTRO_NAME_NO_CAP;", which tracks the upstream "origin/&DISTRO_NAME_NO_CAP;" branch. Changes you make while in this branch would ultimately affect the upstream "&DISTRO_NAME_NO_CAP;" branch -of the ``poky`` repository. +of the ``yocto-docs`` repository. It is important to understand that when you create and checkout a local working branch based on a branch name, your local environment matches @@ -432,13 +430,12 @@ Yocto Project Release. Git uses "tags" to mark specific changes in a repository branch structure. Typically, a tag is used to mark a special point such as the final change (or commit) before a project is released. You can see the -tags used with the ``poky`` Git repository by going to :yocto_git:`/poky/` +tags used with the ``yocto-docs`` Git repository by going to :yocto_git:`/yocto-docs/` and clicking on the ``[...]`` link beneath the "Tag" heading. -Some key tags for the ``poky`` repository are ``jethro-14.0.3``, -``morty-16.0.1``, ``pyro-17.0.0``, and -``&DISTRO_NAME_NO_CAP;-&DISTRO;``. These tags represent Yocto Project -releases. +Some key tags for the ``yocto-docs`` repository are ``kirkstone-4.0.30``, +``scarthgap-5.0.1``, and ``&DISTRO_NAME_NO_CAP;-&DISTRO;``. These tags represent +Yocto Project releases. When you create a local copy of the Git repository, you also have access to all the tags in the upstream repository. Similar to branches, you can @@ -449,19 +446,19 @@ The most common use is to checkout a working branch that matches a specific Yocto Project release. Here is an example:: $ cd ~ - $ git clone git://git.yoctoproject.org/poky - $ cd poky + $ git clone git://git.yoctoproject.org/yocto-docs + $ cd yocto-docs $ git fetch --tags - $ git checkout tags/rocko-18.0.0 -b my_rocko-18.0.0 + $ git checkout tags/&DISTRO_NAME_NO_CAP;-&DISTRO; -b my_&DISTRO_NAME_NO_CAP;-&DISTRO; In this example, the name of the top-level directory of your local Yocto Project repository is -``poky``. After moving to the ``poky`` directory, the ``git fetch`` +``yocto-docs``. After moving to the ``yocto-docs`` directory, the ``git fetch`` command makes all the upstream tags available locally in your repository. Finally, the ``git checkout`` command creates and checks out -a branch named "my-rocko-18.0.0" that is based on the upstream branch +a branch named "my_&DISTRO_NAME_NO_CAP;-&DISTRO;" that is based on the upstream branch whose "HEAD" matches the commit in the repository associated with the -"rocko-18.0.0" tag. The files in your repository now exactly match that +"&DISTRO_NAME_NO_CAP;-&DISTRO;" tag. The files in your repository now exactly match that particular Yocto Project release as it is tagged in the upstream Git repository. It is important to understand that when you create and checkout a local working branch based on a tag, your environment matches @@ -596,7 +593,8 @@ MIT license :wikipedia:`here `. When you build an image using the Yocto Project, the build process uses a known list of licenses to ensure compliance. You can find this list in -the :term:`Source Directory` at ``meta/files/common-licenses``. Once the +:term:`OpenEmbedded-Core (OE-Core)` at :oe_git:`meta/files/common-licenses +`. Once the build completes, the list of all licenses found and used during that build are kept in the :term:`Build Directory` at ``tmp/deploy/licenses``. @@ -617,8 +615,9 @@ Source Definition and the effort for reviewing and approving licenses that conform to the Open Source Definition (OSD). You can find a list of the combined SPDX and OSI licenses that the Yocto -Project uses in the ``meta/files/common-licenses`` directory in your -:term:`Source Directory`. +Project uses in the :oe_git:`meta/files/common-licenses +` directory in +:term:`OpenEmbedded-Core (OE-Core)`. For information that can help you maintain compliance with various open source licensing during the lifecycle of a product created using the