mbox series

[v3,00/57] Remove obsolete poky repo references

Message ID 20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com
Headers show
Series Remove obsolete poky repo references | expand

Message

Antonin Godard Jan. 29, 2026, 3:22 p.m. UTC 
The Poky repository's master branch is no longer updated:
https://git.yoctoproject.org/poky/tree/README

Many places in the documentation were still making references to Poky as
in the repository. Migrate the documentation in two steps:

Check all occurrences of "poky" or "source directory"
(case-insensitive/multiline match), and reformulate/adapt.

Most of the occurrences will usually be a path in Poky that can be
replaced by OE-Core/meta-yocto.

Some others are more tricky, and needed some re-organization / rework.
For that reason, patch were split by files, to make reviewing/merging
easier and incremental.

This series depends on the "Redefine terms now that the Poky repository is
obsolete" series which redefines terms used to replaces occurrences
here.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
Changes in v3:
- Address Quentin's comments (thanks!).
- Link to v2: https://patch.msgid.link/20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com

Changes in v2:
- Rename "project" to "bitbake-builds" across the whole series, to match
  the default naming of bitbake-setup.
- Apply Reviewed-by trailers from Quentin on patches with no
  modifications. Reviewed-by trailers on modified patches were not
  applied.
- Apply the suggestions from Quentin on the v1. Thanks a lot Quentin for
  the thorough review.
- Link to v1: https://patch.msgid.link/20251224-remove-poky-references-v1-0-658a5f4dbde2@bootlin.com

---
Antonin Godard (57):
      transitioning-to-a-custom-environment.rst: remove obsolete poky repo references
      dev-manual/poky-manual-setup.rst: remove obsolete poky repo references
      dev-manual/start.rst: remove obsolete poky repo references
      bsp-guide/bsp.rst: remove obsolete poky repo references
      kernel-dev/advanced.rst: remove obsolete poky repo references
      contributor-guide/submit-changes.rst: remove obsolete poky repo references
      dev-manual/building.rst: remove obsolete poky repo references
      dev-manual/debugging.rst: remove obsolete poky repo references
      dev-manual/error-reporting-tool.rst: remove obsolete poky repo references
      dev-manual/external-toolchain.rst: remove obsolete poky repo references
      dev-manual/layers.rst: re-organize the document
      dev-manual/layers.rst: remove obsolete poky repo references
      dev-manual/libraries.rst: remove obsolete poky repo references
      dev-manual/new-recipe.rst: remove obsolete poky repo references
      dev-manual/securing-images.rst: remove obsolete poky repo references
      dev-manual/temporary-source-code.rst: remove obsolete poky repo references
      dev-manual/wayland.rst: remove obsolete poky repo references
      dev-manual/wic.rst: remove obsolete poky repo references
      kernel-dev/common.rst: remove obsolete poky repo references
      migration-guides/migration-1.4.rst: remove obsolete poky repo references
      overview-manual/concepts.rst: remove obsolete poky repo references
      overview-manual/development-environment.rst: remove obsolete poky repo references
      overview-manual/yp-intro.rst: remove obsolete poky repo references
      ref-manual/classes.rst: remove obsolete poky repo references
      ref-manual/images.rst: remove obsolete poky repo references
      ref-manual/structure.rst: remove obsolete poky repo references
      ref-manual/tasks.rst: remove obsolete poky repo references
      ref-manual/variables.rst: remove obsolete poky repo references
      sdk-manual/appendix-obtain.rst: remove obsolete poky repo references
      sdk-manual/intro.rst: remove obsolete poky repo references
      test-manual/runtime-testing.rst: remove obsolete poky repo references
      README: remove obsolete poky repo references
      README: replace obsolete substitution variables
      contributor-guide/identify-component.rst: remove obsolete poky repo references
      dev-manual/build-quality.rst: remove obsolete poky repo references
      dev-manual/custom-distribution.rst: remove obsolete poky repo references
      dev-manual/custom-template-configuration-directory.rst: remove obsolete poky repo references
      dev-manual/init-manager.rst: remove obsolete poky repo references
      dev-manual/licenses.rst: remove obsolete poky repo references
      dev-manual/licenses.rst: instruct to use git-archive instead of removing .git
      dev-manual/packages.rst: remove obsolete poky repo references
      dev-manual/python-development-shell.rst: remove obsolete poky repo references
      dev-manual/qemu.rst: remove obsolete poky repo references
      dev-manual/upgrading-recipes.rst: remove obsolete poky repo references
      dev-manual/upgrading-recipes.rst: move meta-openembedded to bitbake-builds/layers
      dev-manual/vulnerabilities.rst: remove obsolete poky repo references
      ref-manual/devtool-reference.rst: remove obsolete poky repo references
      ref-manual/faq.rst: remove obsolete poky repo references
      ref-manual/features.rst: remove obsolete poky repo references
      ref-manual/release-process.rst: remove obsolete poky repo references
      ref-manual/release-process.rst: remove repeated "in the"
      ref-manual/system-requirements.rst: remove obsolete poky repo references
      ref-manual/system-requirements.rst: fix wrong path to install-buildtools
      ref-manual/yocto-project-supported-features.rst: remove obsolete poky repo reference
      test-manual/reproducible-builds.rst: remove obsolete poky repo references
      test-manual/understand-autobuilder.rst: remove obsolete poky repo references
      what-i-wish-id-known.rst: remove obsolete poky repo references

 documentation/README                               |  43 +--
 documentation/brief-yoctoprojectqs/index.rst       |   2 +-
 documentation/bsp-guide/bsp.rst                    | 165 ++++-------
 .../contributor-guide/identify-component.rst       |   9 -
 documentation/contributor-guide/submit-changes.rst |  60 +---
 documentation/dev-manual/build-quality.rst         |   2 +-
 documentation/dev-manual/building.rst              |  40 +--
 documentation/dev-manual/custom-distribution.rst   |   8 +-
 .../custom-template-configuration-directory.rst    |   8 +-
 documentation/dev-manual/debugging.rst             |  16 +-
 documentation/dev-manual/error-reporting-tool.rst  |   3 +-
 documentation/dev-manual/external-toolchain.rst    |   2 +-
 documentation/dev-manual/init-manager.rst          |   6 +-
 documentation/dev-manual/layers.rst                | 308 ++++++++------------
 documentation/dev-manual/libraries.rst             |   8 +-
 documentation/dev-manual/licenses.rst              |  32 +-
 documentation/dev-manual/new-recipe.rst            |  25 +-
 documentation/dev-manual/packages.rst              |  11 +-
 documentation/dev-manual/poky-manual-setup.rst     |  29 +-
 .../dev-manual/python-development-shell.rst        |   2 +-
 documentation/dev-manual/qemu.rst                  |  11 +-
 documentation/dev-manual/start.rst                 | 324 +++------------------
 documentation/dev-manual/temporary-source-code.rst |   4 +-
 documentation/dev-manual/upgrading-recipes.rst     |  28 +-
 documentation/dev-manual/wayland.rst               |   2 +-
 documentation/dev-manual/wic.rst                   |  20 +-
 documentation/kernel-dev/advanced.rst              |  12 +-
 documentation/kernel-dev/common.rst                | 158 ++++------
 documentation/migration-guides/migration-1.4.rst   |   2 +-
 documentation/overview-manual/concepts.rst         |  76 ++---
 .../overview-manual/development-environment.rst    | 108 +++----
 .../figures/poky-reference-distribution.png        | Bin 23784 -> 0 bytes
 documentation/overview-manual/yp-intro.rst         | 155 ++--------
 documentation/ref-manual/classes.rst               |  34 ++-
 documentation/ref-manual/devtool-reference.rst     |  10 +-
 documentation/ref-manual/faq.rst                   |  45 ++-
 documentation/ref-manual/features.rst              |   2 +-
 documentation/ref-manual/fragments.rst             |   2 +
 documentation/ref-manual/images.rst                |   5 +-
 documentation/ref-manual/release-process.rst       |   8 +-
 documentation/ref-manual/structure.rst             | 170 ++++++-----
 documentation/ref-manual/system-requirements.rst   |  16 +-
 documentation/ref-manual/tasks.rst                 |  10 +-
 documentation/ref-manual/terms.rst                 |   2 +-
 documentation/ref-manual/variables.rst             | 149 +++++-----
 .../yocto-project-supported-features.rst           |   2 +-
 documentation/sdk-manual/appendix-obtain.rst       |  29 +-
 documentation/sdk-manual/intro.rst                 |   8 +-
 documentation/security-manual/securing-images.rst  |   9 +-
 documentation/security-manual/vulnerabilities.rst  |  20 +-
 documentation/test-manual/reproducible-builds.rst  |   8 +-
 documentation/test-manual/runtime-testing.rst      |   4 +-
 .../test-manual/understand-autobuilder.rst         |   6 +-
 .../transitioning-to-a-custom-environment.rst      |  21 +-
 documentation/what-i-wish-id-known.rst             |   5 +-
 55 files changed, 816 insertions(+), 1428 deletions(-)
---
base-commit: f43bb42123928181d76f81c0343ece777ac143d0
change-id: 20251224-remove-poky-references-316294b3557f
prerequisite-change-id: 20251224-terms-refresh-cdcd529ee508:v3
prerequisite-patch-id: 28a8d58b852a13391a97f6488bc59721f5efda86
prerequisite-patch-id: 39e885d60801727fff2c835f0c1904287a8223ad
prerequisite-patch-id: 60b57a0baefe0536612ed8c9dff680234c52eed6
prerequisite-patch-id: ef2fccb1181fd736f5713197040c52667c4b469e
prerequisite-patch-id: d641f824c2d4e7ff9506f9007102ebf3b112564f

Comments

Antonin Godard Jan. 29, 2026, 3:26 p.m. UTC | #1 
On Thu Jan 29, 2026 at 4:22 PM CET, Antonin Godard wrote:
> The Poky repository's master branch is no longer updated:
> https://git.yoctoproject.org/poky/tree/README
>
> Many places in the documentation were still making references to Poky as
> in the repository. Migrate the documentation in two steps:
>
> Check all occurrences of "poky" or "source directory"
> (case-insensitive/multiline match), and reformulate/adapt.
>
> Most of the occurrences will usually be a path in Poky that can be
> replaced by OE-Core/meta-yocto.
>
> Some others are more tricky, and needed some re-organization / rework.
> For that reason, patch were split by files, to make reviewing/merging
> easier and incremental.
>
> This series depends on the "Redefine terms now that the Poky repository is
> obsolete" series which redefines terms used to replaces occurrences
> here.
>
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>

I will send pull requests with this series as-is. If any typos are left, let's
send follow-up patches to fix them.

Antonin