summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael Opdenacker <michael.opdenacker@bootlin.com>2021-03-25 20:27:15 +0100
committerRichard Purdie <richard.purdie@linuxfoundation.org>2021-04-06 22:29:49 +0100
commitae19be727a889aa961cfa8baeb5896675a7aa7ab (patch)
tree9a8e51cf36b2fbd1c149cc196cfc926b15e5b662
parentbe976e3aa119d378010273ac8bb8134a4018ef43 (diff)
downloadpoky-ae19be727a889aa961cfa8baeb5896675a7aa7ab.tar.gz
poky-ae19be727a889aa961cfa8baeb5896675a7aa7ab.tar.bz2
poky-ae19be727a889aa961cfa8baeb5896675a7aa7ab.zip
Quick build: checkout a branch instead of a fixed tag
- Add guidelines for choosing a release - Check-out a branch instead of a fixed tag This way it's possible to pull release updates later (From yocto-docs rev: 00b45fcf7e37616b46ca003b49c83594c061c40b) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/brief-yoctoprojectqs/index.rst63
1 files changed, 39 insertions, 24 deletions
diff --git a/documentation/brief-yoctoprojectqs/index.rst b/documentation/brief-yoctoprojectqs/index.rst
index f68ad168b8..7bba47ea9c 100644
--- a/documentation/brief-yoctoprojectqs/index.rst
+++ b/documentation/brief-yoctoprojectqs/index.rst
@@ -106,42 +106,57 @@ commands to clone the Poky repository.
Resolving deltas: 100% (323116/323116), done.
Checking connectivity... done.
-Move to the ``poky`` directory and take a look at the tags:
+Go to :yocto_wiki:`Releases wiki page </Releases>`, and choose a release
+codename (such as ``&DISTRO_NAME_NO_CAP;``), corresponding to either the
+latest stable release or a Long Term Support release.
+
+Then move to the ``poky`` directory and take a look at existing branches:
.. code-block:: shell
$ cd poky
- $ git fetch --tags
- $ git tag
- 1.1_M1.final
- 1.1_M1.rc1
- 1.1_M1.rc2
- 1.1_M2.final
- 1.1_M2.rc1
+ $ git branch -a
+ .
+ .
+ .
+ remotes/origin/HEAD -> origin/master
+ remotes/origin/dunfell
+ remotes/origin/dunfell-next
+ .
+ .
+ .
+ remotes/origin/gatesgarth
+ remotes/origin/gatesgarth-next
+ .
.
.
+ remotes/origin/master
+ remotes/origin/master-next
.
- yocto-2.5
- yocto-2.5.1
- yocto-2.5.2
- yocto-2.6
- yocto-2.6.1
- yocto-2.6.2
- yocto-2.7
- yocto_1.5_M5.rc8
-
-For this example, check out the branch based on the
-``&DISTRO_REL_TAG;`` release:
+ .
+ .
+
+
+For this example, check out the ``&DISTRO_NAME_NO_CAP;`` branch based on the
+``&DISTRO_NAME;`` release:
.. code-block:: shell
- $ git checkout tags/&DISTRO_REL_TAG; -b my-&DISTRO_REL_TAG;
- Switched to a new branch 'my-&DISTRO_REL_TAG;'
+ $ git checkout -t origin/&DISTRO_NAME_NO_CAP; -b my-&DISTRO_NAME_NO_CAP;
+ Branch 'my-&DISTRO_NAME_NO_CAP;' set up to track remote branch '&DISTRO_NAME_NO_CAP;' from 'origin'.
+ Switched to a new branch 'my-&DISTRO_NAME_NO_CAP;'
The previous Git checkout command creates a local branch named
-``my-&DISTRO_REL_TAG;``. The files available to you in that branch exactly
-match the repository's files in the ``&DISTRO_NAME_NO_CAP;`` development
-branch at the time of the Yocto Project &DISTRO_REL_TAG; release.
+``my-&DISTRO_NAME_NO_CAP;``. The files available to you in that branch
+exactly match the repository's files in the ``&DISTRO_NAME_NO_CAP;``
+release branch.
+
+Note that you can regularly type the following command in the same directory
+to keep your local files in sync with the release branch:
+
+.. code-block:: shell
+
+ $ git pull
For more options and information about accessing Yocto Project related
repositories, see the