summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r--documentation/dev-manual/dev-manual-start.xml43
1 files changed, 31 insertions, 12 deletions
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 @@
56 The Packages</ulink> section in the Yocto Project Quick start for the exact package 56 The Packages</ulink> section in the Yocto Project Quick start for the exact package
57 requirements.</para></listitem> 57 requirements.</para></listitem>
58 <listitem><para><emphasis>Yocto Project Release:</emphasis> You need a release of the Yocto Project. 58 <listitem><para><emphasis>Yocto Project Release:</emphasis> You need a release of the Yocto Project.
59 You can get set up for this one of two ways depending on whether you are going to be contributing 59 You can get set up with local Yocto Project files one of two ways depending on whether you
60 back into the Yocto Project source repository or not. 60 are going to be contributing back into the Yocto Project source repository or not.
61 <itemizedlist> 61 <itemizedlist>
62 <listitem><para><emphasis>Tarball Extraction:</emphasis> If you are not going to contribute 62 <listitem><para><emphasis>Tarball Extraction:</emphasis> If you are not going to contribute
63 back into the Yocto Project you can simply download the Yocto Project release you want 63 back into the Yocto Project you can simply download the Yocto Project release you want
64 from the website’s <ulink url='http://yoctoproject.org/download'>download page</ulink>. 64 from the website’s <ulink url='http://yoctoproject.org/download'>download page</ulink>.
65 Once you have the tarball, just extract it into a directory of your choice. 65 Once you have the tarball, just extract it into a directory of your choice.</para>
66 This method does not produce a <filename>poky</filename> Git repository. 66
67 You end up simply with a snapshot of Yocto Project files that are based on the 67 <para>For example, the following command extracts the Yocto Project 1.1 release tarball
68 particular release in the tarball. 68 into the current working directory and sets up a file structure whose top-level
69 If you are interested in supported Board Support Packages (BSPs) you can also download 69 directory is named <filename>poky-1.1</filename>:
70 these release tarballs from the same site and locate them in a directory of your 70 <literallayout class='monospaced'>
71 choice.</para></listitem> 71 $ tar xfj poky-1.1.tar.bz2
72 </literallayout></para>
73
74 <para>This method does not produce a <filename>poky</filename> Git repository.
75 You end up simply with a local snapshot of Yocto Project files that are based on the
76 particular release in the tarball.</para></listitem>
72 <listitem><para><emphasis>Git Repository Method:</emphasis> If you are going to be contributing 77 <listitem><para><emphasis>Git Repository Method:</emphasis> If you are going to be contributing
73 back into the Yocto Project you should probably use Git commands to set up a local 78 back into the Yocto Project you should probably use Git commands to set up a local
74 <filename>poky</filename> Git repository of from the Yocto Project. 79 <filename>poky</filename> Git repository of the Yocto Project.
75 Doing so creates a Git repository with a complete history of changes and allows 80 Doing so creates a Git repository with a complete history of changes and allows
76 you to easily submit your changes upstream to the project. 81 you to easily submit your changes upstream to the project.</para>
77 For an example of how to set up your own local Git repositories see this 82
83 <para>The following transcript shows how to clone the <filename>poky</filename>
84 Git repository into the current working directory.
85 The command creates the repository in a directory named <filename>poky</filename>:
86 <literallayout class='monospaced'>
87 $ git clone git://git.yoctoproject.org/poky
88 Initialized empty Git repository in /home/scottrif/poky/.git/
89 remote: Counting objects: 107624, done.
90 remote: Compressing objects: 100% (37128/37128), done.
91 remote: Total 107624 (delta 73393), reused 99851 (delta 67287)
92 Receiving objects: 100% (107624/107624), 69.74 MiB | 483 KiB/s, done.
93 Resolving deltas: 100% (73393/73393), done.
94 </literallayout></para>
95
96 <para>For another example of how to set up your own local Git repositories see this
78 <ulink url='https://wiki.yoctoproject.org/wiki/Transcript:_from_git_checkout_to_meta-intel_BSP'> 97 <ulink url='https://wiki.yoctoproject.org/wiki/Transcript:_from_git_checkout_to_meta-intel_BSP'>
79 wiki page</ulink>, which describes how to create both <filename>poky</filename> 98 wiki page</ulink>, which describes how to create both <filename>poky</filename>
80 and <filename>meta-intel</filename> Git repositories.</para></listitem> 99 and <filename>meta-intel</filename> Git repositories.</para></listitem>