public inbox for docs@lists.yoctoproject.org
 help / color / mirror / Atom feed
From: Antonin Godard <antonin.godard@bootlin.com>
To: docs@lists.yoctoproject.org
Cc: Thomas Petazzoni <thomas.petazzoni@bootlin.com>,
	 Antonin Godard <antonin.godard@bootlin.com>
Subject: [PATCH v2 02/56] dev-manual/poky-manual-setup.rst: remove obsolete poky repo references
Date: Tue, 27 Jan 2026 09:18:57 +0100	[thread overview]
Message-ID: <20260127-remove-poky-references-v2-2-74bf80cc4e5a@bootlin.com> (raw)
In-Reply-To: <20260127-remove-poky-references-v2-0-74bf80cc4e5a@bootlin.com>

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 <antonin.godard@bootlin.com>
---
 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
+<dev-manual/poky-manual-setup:Use Git to Clone The Layers>`, or
+:ref:`downloading the released archives <dev-manual/poky-manual-setup:Using the
+Source Archives>`.
+
 Use Git to Clone The Layers
-===========================
+---------------------------
 
 Go to the :yocto_home:`Releases </development/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; </releases/yocto/&DISTRO_REL_LATEST_TAG;/>`.
+
+You will find there source archives of :term:`OpenEmbedded-Core (OE-Core)`,
+:term:`BitBake`, and :yocto_git:`meta-yocto </meta-yocto>`.
+
+.. note::
+
+   The recommended method for accessing Yocto Project components is to :ref:`use
+   Git to clone the upstream repository <dev-manual/poky-manual-setup:Use Git to
+   Clone The Layers>` and work from within the locally cloned repositories.
+
 Building Your Image
 ===================
 

-- 
2.52.0



  parent reply	other threads:[~2026-01-27  8:19 UTC|newest]

Thread overview: 92+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-01-27  8:18 [PATCH v2 00/56] Remove obsolete poky repo references Antonin Godard
2026-01-27  8:18 ` [PATCH v2 01/56] transitioning-to-a-custom-environment.rst: remove " Antonin Godard
2026-01-27  8:18 ` Antonin Godard [this message]
2026-01-27 10:55   ` [docs] [PATCH v2 02/56] dev-manual/poky-manual-setup.rst: " Quentin Schulz
2026-01-27  8:18 ` [PATCH v2 03/56] dev-manual/start.rst: " Antonin Godard
2026-01-27 11:14   ` [docs] " Quentin Schulz
2026-01-27  8:18 ` [PATCH v2 04/56] bsp-guide/bsp.rst: " Antonin Godard
2026-01-27 11:27   ` [docs] " Quentin Schulz
2026-01-29 11:17     ` Antonin Godard
2026-01-27  8:19 ` [PATCH v2 05/56] kernel-dev/advanced.rst: " Antonin Godard
2026-01-27 13:05   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 06/56] contributor-guide/submit-changes.rst: " Antonin Godard
2026-01-27 13:37   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 07/56] dev-manual/building.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 08/56] dev-manual/debugging.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 09/56] dev-manual/error-reporting-tool.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 10/56] dev-manual/external-toolchain.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 11/56] dev-manual/layers.rst: " Antonin Godard
2026-01-27 15:18   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 12/56] " Antonin Godard
2026-01-27 15:29   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 13/56] dev-manual/libraries.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 14/56] dev-manual/new-recipe.rst: " Antonin Godard
2026-01-27 15:39   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 15/56] dev-manual/securing-images.rst: " Antonin Godard
2026-01-27 15:44   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 16/56] dev-manual/temporary-source-code.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 17/56] dev-manual/wayland.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 18/56] dev-manual/wic.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 19/56] kernel-dev/common.rst: " Antonin Godard
2026-01-27 17:41   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 20/56] migration-guides/migration-1.4.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 21/56] overview-manual/concepts.rst: " Antonin Godard
2026-01-27 17:58   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 22/56] overview-manual/development-environment.rst: " Antonin Godard
2026-01-28 11:11   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 23/56] overview-manual/yp-intro.rst: " Antonin Godard
2026-01-28 11:32   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 24/56] ref-manual/classes.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 25/56] ref-manual/images.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 26/56] ref-manual/structure.rst: " Antonin Godard
2026-01-28 11:48   ` [docs] " Quentin Schulz
2026-01-29 14:11     ` Antonin Godard
2026-01-27  8:19 ` [PATCH v2 27/56] ref-manual/tasks.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 28/56] ref-manual/variables.rst: " Antonin Godard
2026-01-28 13:36   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 29/56] sdk-manual/appendix-obtain.rst: " Antonin Godard
2026-01-28 13:36   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 30/56] sdk-manual/intro.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 31/56] test-manual/runtime-testing.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 32/56] README: " Antonin Godard
2026-01-28 13:40   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 33/56] README: replace obsolete substitution variables Antonin Godard
2026-01-27  8:19 ` [PATCH v2 34/56] contributor-guide/identify-component.rst: remove obsolete poky repo references Antonin Godard
2026-01-27  8:19 ` [PATCH v2 35/56] dev-manual/build-quality.rst: " Antonin Godard
2026-01-28 13:41   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 36/56] dev-manual/custom-distribution.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 37/56] dev-manual/custom-template-configuration-directory.rst: " Antonin Godard
2026-01-28 13:47   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 38/56] dev-manual/init-manager.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 39/56] dev-manual/licenses.rst: " Antonin Godard
2026-01-28 13:54   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 40/56] dev-manual/licenses.rst: instruct to use git-archive instead of removing .git Antonin Godard
2026-01-28 13:57   ` Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 41/56] dev-manual/packages.rst: remove obsolete poky repo references Antonin Godard
2026-01-28 14:01   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 42/56] dev-manual/python-development-shell.rst: " Antonin Godard
2026-01-28 14:02   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 43/56] dev-manual/qemu.rst: " Antonin Godard
2026-01-28 14:03   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 44/56] dev-manual/upgrading-recipes.rst: " Antonin Godard
2026-01-28 14:09   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 45/56] dev-manual/vulnerabilities.rst: " Antonin Godard
2026-01-28 14:11   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 46/56] ref-manual/devtool-reference.rst: " Antonin Godard
2026-01-28 14:15   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 47/56] ref-manual/faq.rst: " Antonin Godard
2026-01-28 14:23   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 48/56] ref-manual/features.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 49/56] ref-manual/release-process.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 50/56] ref-manual/release-process.rst: remove repeated "in the" Antonin Godard
2026-01-28 14:27   ` Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 51/56] ref-manual/system-requirements.rst: remove obsolete poky repo references Antonin Godard
2026-01-28 14:48   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 52/56] ref-manual/system-requirements.rst: fix wrong path to install-buildtools Antonin Godard
2026-01-28 15:02   ` Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 53/56] ref-manual/yocto-project-supported-features.rst: remove obsolete poky repo reference Antonin Godard
2026-01-27  8:19 ` [PATCH v2 54/56] test-manual/reproducible-builds.rst: remove obsolete poky repo references Antonin Godard
2026-01-27  8:19 ` [PATCH v2 55/56] test-manual/understand-autobuilder.rst: " Antonin Godard
2026-01-28 15:03   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 56/56] what-i-wish-id-known.rst: " Antonin Godard
2026-01-28 15:08   ` [docs] " Quentin Schulz

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20260127-remove-poky-references-v2-2-74bf80cc4e5a@bootlin.com \
    --to=antonin.godard@bootlin.com \
    --cc=docs@lists.yoctoproject.org \
    --cc=thomas.petazzoni@bootlin.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox