sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

dev-manual: Small number of tweaks to ch 3, development manual. 

(From yocto-docs rev: f496e2fb8050830a2daf9f712a9b9b40b4025f1f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>

Conflicts:

	documentation/dev-manual/dev-manual-newbie.xml

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Robert P. J. Day 2013-11-11 10:42:55 -08:00 committed by Richard Purdie
parent 803300cc12
commit e3e0d40704
1 changed files with 18 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
documentation/dev-manual/dev-manual-newbie.xml
View File

@ -429,15 +429,17 @@
<para> <para>
For any supported release of Yocto Project, you can go to the For any supported release of Yocto Project, you can go to the
<ulink url='&YOCTO_HOME_URL;'>Yocto Project Website</ulink> and <ulink url='&YOCTO_HOME_URL;'>Yocto Project Website</ulink> and
select the "Downloads" tab and get a tarball of the release. select the "Downloads" tab and get a released tarball of the
You can also go to this site to download any supported BSP tarballs. <filename>poky</filename> repository or any supported BSP tarballs.
Unpacking the tarball gives you a hierarchical Source Directory that lets you develop Unpacking these tarballs gives you a snapshot of the released
using the Yocto Project. files.
</para> <note>
The recommended method for setting up the Yocto Project
<para> <link linkend='source-directory'>Source Directory</link> and the
Once you are set up through either tarball extraction or a checkout of Git repositories, files for supported BSPs (eg., <filename>meta-intel</filename>) is to
you are ready to develop. use <link linkend='git'>Git</link> to create a local copy of the
upstream repositories.
</note>
</para> </para>
<para> <para>
@ -820,7 +822,8 @@
<title>Git</title> <title>Git</title>
<para> <para>
The Yocto Project uses Git, which is a free, open source distributed version control system. The Yocto Project makes extensive use of Git,
which is a free, open source distributed version control system.
Git supports distributed development, non-linear development, and can handle large projects. Git supports distributed development, non-linear development, and can handle large projects.
It is best that you have some fundamental understanding of how Git tracks projects and It is best that you have some fundamental understanding of how Git tracks projects and
how to work with Git if you are going to use the Yocto Project for development. how to work with Git if you are going to use the Yocto Project for development.
@ -924,7 +927,7 @@
local working branch based on a branch name, local working branch based on a branch name,
your local environment matches the "tip" of that development branch your local environment matches the "tip" of that development branch
at the time you created your local branch, which could be at the time you created your local branch, which could be
different than the files at the time of a similarly named release. different from the files at the time of a similarly named release.
In other words, creating and checking out a local branch based on the In other words, creating and checking out a local branch based on the
<filename>&DISTRO_NAME;</filename> branch name is not the same as <filename>&DISTRO_NAME;</filename> branch name is not the same as
cloning and checking out the <filename>master</filename> branch. cloning and checking out the <filename>master</filename> branch.
@ -1017,7 +1020,7 @@
will allow the change, and for ultimately pushing the change from your local Git repository will allow the change, and for ultimately pushing the change from your local Git repository
into the project’s upstream (or master) repository.</para></listitem> into the project’s upstream (or master) repository.</para></listitem>
<listitem><para><emphasis><filename>git status</filename>:</emphasis> Reports any modified files that <listitem><para><emphasis><filename>git status</filename>:</emphasis> Reports any modified files that
possibly need staged and committed.</para></listitem> possibly need to be staged and committed.</para></listitem>
<listitem><para><emphasis><filename>git checkout &lt;branch-name&gt;</filename>:</emphasis> Changes <listitem><para><emphasis><filename>git checkout &lt;branch-name&gt;</filename>:</emphasis> Changes
your working branch. your working branch.
This command is analogous to "cd".</para></listitem> This command is analogous to "cd".</para></listitem>
@ -1294,10 +1297,9 @@
<listitem><para><emphasis>Board Support Package (BSP) README Files:</emphasis> <listitem><para><emphasis>Board Support Package (BSP) README Files:</emphasis>
For BSP maintainers of supported BSPs, you can examine For BSP maintainers of supported BSPs, you can examine
individual BSP <filename>README</filename> files. individual BSP <filename>README</filename> files.
Alternatively, you can examine the In addition, some layers (such as the <filename>meta-intel</filename> layer),
<filename>MAINTAINERS</filename> file, which is found in the include a <filename>MAINTAINERS</filename> file which contains
<filename>meta-intel</filename>, for a list of all supported a list of all supported BSP maintainers for that layer.
BSP maintainers.
</para></listitem> </para></listitem>
<listitem><para><emphasis>Search by File:</emphasis> <listitem><para><emphasis>Search by File:</emphasis>
Using <link linkend='git'>Git</link>, you can enter the Using <link linkend='git'>Git</link>, you can enter the