| Message ID | 20251224-remove-poky-references-v1-3-658a5f4dbde2@bootlin.com |
|---|---|
| State | Superseded |
| Headers | show |
| Series | Remove obsolete poky repo references | expand |
Hi Antonin, On 12/24/25 5:31 PM, Antonin Godard via lists.yoctoproject.org wrote: > 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. > Do the opposite? Have this commit before we remove the important parts in the commit you mention? So that no information is temporarily lost? > Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> > --- > documentation/dev-manual/poky-manual-setup.rst | 28 +++++++++++++++++++++++++- > 1 file changed, 27 insertions(+), 1 deletion(-) > > diff --git a/documentation/dev-manual/poky-manual-setup.rst b/documentation/dev-manual/poky-manual-setup.rst > index 7ee084007..c4e36ce8b 100644 > --- a/documentation/dev-manual/poky-manual-setup.rst > +++ b/documentation/dev-manual/poky-manual-setup.rst > @@ -13,8 +13,15 @@ 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: cloning the repositories with Git, or > +downloading the released archives. > + suggestion: Use cross-reference links for both (linking to "Use Git to Clone the Layers and 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 > @@ -41,6 +48,25 @@ 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 on :yocto_dl:`/releases/yocto/`. Then, choose the subdirectory s/on/at/ ? > +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 individual components (if you wish > +to use them individually), and of the corresponding Poky release bundling > +a selection of these components. > + Where it this poky bundle, I cannot find it here: https://downloads.yoctoproject.org/releases/yocto/yocto-5.3/ > +.. note:: > + > + The recommended method for accessing Yocto Project components is to > + use Git to clone the upstream repository and work from within that suggestion: Use a cross-reference link pointing at the section above this one. > + locally cloned repository. > + s/that locally cloned repository/the locally cloned repositories/ (no combo layer anymore!). Cheers, Quentin
diff --git a/documentation/dev-manual/poky-manual-setup.rst b/documentation/dev-manual/poky-manual-setup.rst index 7ee084007..c4e36ce8b 100644 --- a/documentation/dev-manual/poky-manual-setup.rst +++ b/documentation/dev-manual/poky-manual-setup.rst @@ -13,8 +13,15 @@ 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: cloning the repositories with Git, or +downloading the released 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 @@ -41,6 +48,25 @@ 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 on :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 individual components (if you wish +to use them individually), and of the corresponding Poky release bundling +a selection of these components. + +.. note:: + + 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. + 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 | 28 +++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-)