@@ -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
===================
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(-)