diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index a60f256142..0954c0ff50 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml @@ -56,25 +56,44 @@ The Packages section in the Yocto Project Quick start for the exact package requirements. Yocto Project Release: You need a release of the Yocto Project. - You can get set up for this one of two ways depending on whether you are going to be contributing - back into the Yocto Project source repository or not. + You can get set up with local Yocto Project files one of two ways depending on whether you + are going to be contributing back into the Yocto Project source repository or not. Tarball Extraction: If you are not going to contribute back into the Yocto Project you can simply download the Yocto Project release you want from the website’s download page. - Once you have the tarball, just extract it into a directory of your choice. - This method does not produce a poky Git repository. - You end up simply with a snapshot of Yocto Project files that are based on the - particular release in the tarball. - If you are interested in supported Board Support Packages (BSPs) you can also download - these release tarballs from the same site and locate them in a directory of your - choice. + Once you have the tarball, just extract it into a directory of your choice. + + For example, the following command extracts the Yocto Project 1.1 release tarball + into the current working directory and sets up a file structure whose top-level + directory is named poky-1.1: + + $ tar xfj poky-1.1.tar.bz2 + + + This method does not produce a poky Git repository. + You end up simply with a local snapshot of Yocto Project files that are based on the + particular release in the tarball. Git Repository Method: If you are going to be contributing back into the Yocto Project you should probably use Git commands to set up a local - poky Git repository of from the Yocto Project. + poky Git repository of the Yocto Project. Doing so creates a Git repository with a complete history of changes and allows - you to easily submit your changes upstream to the project. - For an example of how to set up your own local Git repositories see this + you to easily submit your changes upstream to the project. + + The following transcript shows how to clone the poky + Git repository into the current working directory. + The command creates the repository in a directory named poky: + + $ git clone git://git.yoctoproject.org/poky + Initialized empty Git repository in /home/scottrif/poky/.git/ + remote: Counting objects: 107624, done. + remote: Compressing objects: 100% (37128/37128), done. + remote: Total 107624 (delta 73393), reused 99851 (delta 67287) + Receiving objects: 100% (107624/107624), 69.74 MiB | 483 KiB/s, done. + Resolving deltas: 100% (73393/73393), done. + + + For another example of how to set up your own local Git repositories see this wiki page, which describes how to create both poky and meta-intel Git repositories.