diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2013-10-29 07:37:31 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2013-11-01 17:09:55 +0000 |
commit | 4d69fc1ad65e8ff049cfeb69437ca7c2896f5de9 (patch) | |
tree | dd3eb4d66127d88473f9c72dabd0c9d2f1300b52 /documentation | |
parent | 57d2417eacf45206328c5791524597691f2f1ff0 (diff) | |
download | ast2050-yocto-poky-4d69fc1ad65e8ff049cfeb69437ca7c2896f5de9.zip ast2050-yocto-poky-4d69fc1ad65e8ff049cfeb69437ca7c2896f5de9.tar.gz |
dev-manual: Removed tarball method for poky in setup section
Fixes [YOCTO #5368]
Partial fix for the bug. This part removed the tarball install
method from the getting setup section of the second chapter. I
did some rewriting to smooth it out.
(From yocto-docs rev: b051433e34e0f3a46deba0b2b4815ab77fde62c8)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/dev-manual/dev-manual-start.xml | 78 |
1 files changed, 32 insertions, 46 deletions
diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index 0729baa..b0f5e12 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml @@ -79,47 +79,32 @@ them for the supported distributions. </para></listitem> <listitem id='local-yp-release'><para><emphasis>Yocto Project Release:</emphasis> - You need a release of the Yocto Project. - You set that up with a local <link linkend='source-directory'>Source Directory</link> - one of two ways depending on whether you - are going to contribute back into the Yocto Project or not. - <note> - Regardless of the method you use, this manual refers to the resulting local - hierarchical set of files as the "Source Directory." + You need a release of the Yocto Project installed locally on + your development system. + This local area is referred to as the + <link linkend='source-directory'>Source Directory</link> + and is created when you use + <link linkend='git'>Git</link> to clone a local copy + of the upstream <filename>poky</filename> repository.</para> + <para>Working from a copy of the upstream repository allows you + to contribute back into the Yocto Project or simply work with + the latest software on a development branch. + Because Git maintains and creates an upstream repository with + a complete history of changes and you are working with a local + clone of that repository, you have access to all the Yocto + Project development branches and tag names used in the upstream + repository.</para> + <note>You can view the Yocto Project Source Repositories at + <ulink url='&YOCTO_GIT_URL;/cgit.cgi'></ulink> </note> - <itemizedlist> - <listitem><para><emphasis>Tarball Extraction:</emphasis> - If you are not going to contribute back into the Yocto - Project, you can simply go to the - <ulink url='&YOCTO_HOME_URL;'>Yocto Project Website</ulink>, - select the "Downloads" tab, and choose what you want. - Once you have the tarball, just extract it into a - directory of your choice.</para> - <para>For example, the following command extracts the - Yocto Project &DISTRO; release tarball - into the current working directory and sets up the local Source Directory - with a top-level folder named <filename>&YOCTO_POKY;</filename>: - <literallayout class='monospaced'> - $ tar xfj &YOCTO_POKY_TARBALL; - </literallayout></para> - <para>This method does not produce a local Git repository. - Instead, you simply end up with a snapshot of the release.</para></listitem> - <listitem><para><emphasis>Git Repository Method:</emphasis> If you are going to be contributing - back into the Yocto Project or you simply want to keep up - with the latest developments, you should use Git commands to set up a local - Git repository of the upstream <filename>poky</filename> source repository. - Doing so creates a repository with a complete history of changes and allows - you to easily submit your changes upstream to the project. - Because you clone the repository, you have access to all the Yocto Project development - branches and tag names used in the upstream repository.</para> - <note>You can view the Yocto Project Source Repositories at - <ulink url='&YOCTO_GIT_URL;/cgit.cgi'></ulink></note> - <para>The following transcript shows how to clone the <filename>poky</filename> - Git repository into the current working directory. - The command creates the local repository in a directory named <filename>poky</filename>. - For information on Git used within the Yocto Project, see the - "<link linkend='git'>Git</link>" section. - <literallayout class='monospaced'> + <para>The following transcript shows how to clone the + <filename>poky</filename> Git repository into the current + working directory. + The command creates the local repository in a directory + named <filename>poky</filename>. + For information on Git used within the Yocto Project, see + the "<link linkend='git'>Git</link>" section. + <literallayout class='monospaced'> $ git clone git://git.yoctoproject.org/poky Cloning into 'poky'... remote: Counting objects: 203728, done. @@ -127,12 +112,13 @@ remote: Total 203728 (delta 147444), reused 202891 (delta 146614) Receiving objects: 100% (203728/203728), 95.54 MiB | 308 KiB/s, done. Resolving deltas: 100% (147444/147444), done. - </literallayout></para> - <para>For another example of how to set up your own local Git repositories, see this - <ulink url='&YOCTO_WIKI_URL;/wiki/Transcript:_from_git_checkout_to_meta-intel_BSP'> - wiki page</ulink>, which describes how to create both <filename>poky</filename> - and <filename>meta-intel</filename> Git repositories.</para></listitem> - </itemizedlist></para></listitem> + </literallayout></para> + <para>For another example of how to set up your own local Git + repositories, see this + <ulink url='&YOCTO_WIKI_URL;/wiki/Transcript:_from_git_checkout_to_meta-intel_BSP'> + wiki page</ulink>, which describes how to create both + <filename>poky</filename> and <filename>meta-intel</filename> + Git repositories.</para></listitem> <listitem id='local-kernel-files'><para><emphasis>Yocto Project Kernel:</emphasis> If you are going to be making modifications to a supported Yocto Project kernel, you need to establish local copies of the source. |