path: root/docs/usermanual
diff options
authorTheodore A. Roth <taroth@gmail.com>2009-02-24 16:32:57 +0000
committerCliff Brake <cbrake@bec-systems.com>2009-02-25 08:38:59 -0500
commita8d2a6706ea43b2ead95c8d06b6e6575ff2b0ba1 (patch)
tree1511ea6a6b2aabf72d4c2064a8998e1a648ee83e /docs/usermanual
parent54f42088e2bdf35916a319eaaa1985e5b322cf41 (diff)
getting_oe.xml: Update getting openembedded section.
Resubmitted against .dev branch instead of .documentation. getting_oe.xml: Update getting openembedded section. Signed-off-by: Theodore A. Roth <taroth@gmail.com>
Diffstat (limited to 'docs/usermanual')
1 files changed, 43 insertions, 17 deletions
diff --git a/docs/usermanual/chapters/getting_oe.xml b/docs/usermanual/chapters/getting_oe.xml
index c7eb7ec7de..69b9126fad 100644
--- a/docs/usermanual/chapters/getting_oe.xml
+++ b/docs/usermanual/chapters/getting_oe.xml
@@ -92,24 +92,50 @@ $ <command>svn</command> co svn://svn.berlios.de/bitbake/branches/bitbake-1.8/ b
<section id="gettingoe_getting_oe">
<title>Getting OpenEmbedded</title>
+ <para><emphasis>Note:</emphasis> Once upon a time OpenEmbedded used
+ Monotone for version control. If you have an OE Monotone repository on
+ your computer, you should replace it with the Git repository.</para>
<para>The OpenEmbedded metadata has a high rate of development, so it's a
- good idea to stay up to date. You'll need monotone 0.28 to get the
- metadata and stay up to date. Monotone is available in most distributions
- and has binaries at <ulink url="http://venge.net/monotone/">Monotone
- homepage</ulink>.</para>
- <para>Next step is getting snapshot of database. <screen>
-wget http://openembedded.org/snapshots/OE.mtn.bz2 http://openembedded.org/snapshots/OE.mtn.bz2.md5
-</screen> Or if you have monotone 0.30 or later: <screen>
-wget http://www.openembedded.org/snapshots/OE-this-is-for-mtn-0.30.mtn.bz2
-wget http://www.openembedded.org/snapshots/OE-this-is-for-mtn-0.30.mtn.bz2.md5
-</screen> Then verify integrity of snapshot by checking md5sum. <screen>
-md5sum -c OE.mtn.bz2.md5sum
-</screen> Then unpack database. <screen>
-bunzip OE.mtn.bz2
-</screen> Finally checkout the development branch. <screen>
-mtn --db=OE.mtn co -b org.openembedded.dev
+ good idea to stay up to date. You'll need Git to get the metadata and
+ stay up to date. Git is available in most distributions and has binaries
+ at <ulink url="http://git-scm.com/">Git homepage</ulink>.</para>
+ <section><title>Checking Out OpenEmbedded With Git</title>
+ <para>Once you have installed Git, checkout the OpenEmbedded repository:
+ <screen>
+$ cd $OEBASE
+$ git clone git://git.openembedded.net/openembedded</screen>
+ The <literal>$OEBASE/openembedded/</literal> directory should now
+ exist.</para>
+ </section>
+ <section><title>Updating OpenEmbedded</title>
+ <para>The <literal>org.openembedded.dev</literal> branch of OpenEmbedded
+ is updated very frequently (as much as several times an hour). The
+ distro branches are not updated as much but still fairly often. It
+ seems good practice to update your OpenEmbedded tree at least
+ daily. To do this, run:
+ <screen>
+$ cd $OEBASE
+$ git pull</screen>
+ </para>
+ </section>
+ <section><title>Changing Branches</title>
+ <para>Working with multiple branches is very easy to do with Git. The
+ OpenEmbedded repository holds many branches. To list all branches, use this command:
+ <screen>$ git branch -a</screen>
+ Branch names that begin with <literal>origin/</literal> denote
+ branches that exist on the remote server. The name with a * in front
+ of it is the branch currently checked out. If you want to work with a
+ remote branch, you must first create a local copy of it. The following
+ command will create a local copy of a remote branch:
+ <screen>$ git branch &lt;local_name&gt; &lt;remote_name&gt;</screen>
+ To change branches, use this command:
+ <screen>$ git checkout &lt;branch_name&gt;</screen>
+ There are more complicated branch operations that can be done with git,
+ but those are beyond the scope of this document.</para>
+ </section>
<section id="gettingoe_configuring_oe">