dev-manual: Added branch clarification to checking out poky

Re-wordings to be clear about what the user is getting when
they check out a development branch of an upstream repository.

(From yocto-docs rev: deb6ecfd35a76760bc2270bbbc69aa232b0c8cc7)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2017-06-28 16:17:28 -07:00
committed by Richard Purdie
parent 95547dab77
commit 1b2d89737f

View File

@@ -611,9 +611,17 @@
When you clone the upstream poky repository, you have access to
all its development branches.
Each development branch in a repository is unique as it forks
off the repositories "master" branch.
To see and use the files of any branch locally, you need to
know the branch name and then checkout the branch.
off the "master" branch.
To see and use the files of a particular development branch
locally, you need to know the branch name and then specifically
check out that development branch.
<note>
Checking out an active development branch by branch name
gives you a snapshot of that particular branch at the time
you check it out.
Further development on top of the branch that occurs after
check it out can occur.
</note>
<orderedlist>
<listitem><para>
<emphasis>Switch to the Poky Directory:</emphasis>
@@ -648,7 +656,7 @@
</para></listitem>
<listitem><para>
<emphasis>Checkout the Branch:</emphasis>
Checkout the branch in which you want to work.
Checkout the development branch in which you want to work.
For example, to access the files for the Yocto Project
2.3 Release (Pyro), use the following command:
<literallayout class='monospaced'>
@@ -656,8 +664,8 @@
Branch pyro set up to track remote branch pyro from origin.
Switched to a new branch 'pyro'
</literallayout>
The previous command checks out the "pyro" branch and
reports that the branch is tracking the upstream
The previous command checks out the "pyro" development
branch and reports that the branch is tracking the upstream
"origin/pyro" branch.</para>
<para>The following command displays the branches