documentation/dev-manual/dev-manual-bsp-appendix.xml: edits to poky repo setup

There is confusion as to how to set up the Git repository and be
sure you have the snapshot of the release.  I have changed the
description to use a tag rather than the branch names.  The
stuff is out for review with Josh.

(From yocto-docs rev: 2521873e1bf8e1ad398fae4b7297f8746a34258f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

1 files changed, 23 insertions, 7 deletions

diff --git a/documentation/dev-manual/dev-manual-bsp-appendix.xml b/documentation/dev-manual/dev-manual-bsp-appendix.xml
index aecb24f725..51fb3f4f4f 100644
--- a/documentation/dev-manual/dev-manual-bsp-appendix.xml
+++ b/documentation/dev-manual/dev-manual-bsp-appendix.xml
@@ -55,21 +55,37 @@
 
     <para>
         Once you have the local <filename>poky</filename> Git repository set up, 
-        you have many development branches from which you can work. 
-        From inside the repository you can see the branch names and the tag names used 
-        in the Git repository using either of the following two commands:
+        you have all the development branches available to you from which you can work. 
+        However, you need to be sure that your local repository reflects the specific
+        snapshot of the release you are interested in.
+        From inside the repository you can see the development branches that represent
+        areas of development that have diverged from the main (master) branch.  
+        You can also see the tag names used to mark snapshots of stable releases or 
+        points in the repository.
+        Use the following commands to list out the branches and the tags in the repository, 
+        respectively.
         <literallayout class='monospaced'>
      $ git branch -a
      $ git tag -l
         </literallayout> 
-        For this example we are going to use the Yocto Project 1.1 Release, which is code
+        For this example, we are going to use the Yocto Project 1.1 Release, which is code
         named "edison". 
-        These commands create a local branch named <filename>edison</filename>
-        that tracks the remote branch of the same name.
+        To make sure we have a local area (branch in Git terms) on our machine that tracks
+        the snapshot of the 1.1 release, we can use the following commands:
         <literallayout class='monospaced'>
-     $ git checkout -b edison origin/edison
+     $ cd ~/poky
+     $ git fetch --tags
+     $ git checkout edison-6.0 -b edison
      Switched to a new branch 'edison'
         </literallayout>
+        The <filename>git fetch --tags</filename> is somewhat redundant since you just set 
+        up the repository and should have all the tags.
+        The <filename>fetch</filename> command makes sure all the tags are available in your
+        local repository.
+        The Git <filename>checkout</filename> command with the <filename>-b</filename> option
+        creates a local branch for you named <filename>edison</filename>.
+        Your local branch tracks the Yocto Project 1.1 released tarball marked with the 
+        <filename>edison-6.0</filename> tag in the source repositories.
     </para>
 </section>