diff options
author | Paul Sokolovsky <pmiscml@gmail.com> | 2007-12-22 11:38:55 +0000 |
---|---|---|
committer | Paul Sokolovsky <pmiscml@gmail.com> | 2007-12-22 11:38:55 +0000 |
commit | 11060af81e612ab50f0232d254a181ec85e28da4 (patch) | |
tree | 72b2aafcf6d82fcccd59549cde0354b50e648b05 | |
parent | abbb39cf6b7c750fed1f989142db0963f8f494dd (diff) | |
download | openembedded-11060af81e612ab50f0232d254a181ec85e28da4.tar.gz |
usermanual.xml: Reorder chapters, put Getting Started after Intro.
* Of course, user-friendly manuals are written like this:
1. Intro
2. Easy way
3. Details
not like:
1. Intro
2. Lotsa dark and morbid knowledge
3. Now, let's set up it
-rw-r--r-- | usermanual/usermanual.xml | 117 |
1 files changed, 59 insertions, 58 deletions
diff --git a/usermanual/usermanual.xml b/usermanual/usermanual.xml index 63fd6cfc9d..4ed7c6a69c 100644 --- a/usermanual/usermanual.xml +++ b/usermanual/usermanual.xml @@ -57,6 +57,65 @@ OpenEmbedded was created.</para> <chapter> + <title>Getting Started</title> + <section> + <title>Getting <application>BitBake</application></title> + <para>The required version of <application>BitBake</application> is changing rapidly. At the time of writing (end of 2007) <application>BitBake</application> 1.8.latest was required.</para> + <para>A good method is to get <application>BitBake</application> from the stable Subversion branch. + <screen> +<command>svn</command> co http://svn.berlios.de/svnroot/repos/bitbake/branches/bitbake-1.8 +... +A bitbake-1.8/classes/base.bbclass +U bitbake-1.8 +At revision 986. + </screen> + <application>BitBake</application> is checked out now; this completes the first and most critical dependency of OpenEmbedded. Issuing <command>svn</command> <command>update</command> in the <emphasis>bitbake-1.8</emphasis> directory will update <application>BitBake</application> to the latest stable version, but generally it is a good idea to stick with a specific known working version of <application>BitBake</application> until OpenEmbedded asks you to upgrade. + </para> + </section> + + <section> + <title>Getting OpenEmbedded</title> + <para> +The OpenEmbedded metadate has a high rate of development, so it's a good idea to stay up to date. +You'll need monotone 0.29 or later to get the metadata and stay up to date. Monotone is available in most distributions and has binaries at http://venge.net/monotone/ + +<screen> +#get the snapshot +wget http://openembedded.org/snapshots/OE.db.bz2 http://openembedded.org/snapshots/OE.db.bz2.md5 + +#verify the integrity +cat OE.db.bz2.md5sum +md5sum OE.db.bz2 + +#extract the tarball +bunzip OE.db.bz2 + +#check the development branch +monotone --db=OE.db co -b org.openembedded.dev +</screen> + + </para> + </section> + + <section> + <title>Configuring OpenEmbedded</title> + <para>This section is a stub, help us by expanding it</para> + </section> + + <section> + <title>Building Software</title> + <para>Once you set up and configured BitBake and OpenEmbedded, you can build software and images like this: +<screen> +bitbake <recipe_name> +</screen> + </para> + + <para>This section is a stub, help us by expanding it</para> + </section> + </chapter> + + + <chapter> <title>Metadata</title> <section> <title>File Layout</title> @@ -166,64 +225,6 @@ It's important to use <emphasis>+=</emphasis> so it will get appended to the sta <chapter> - <title>Getting Started with OpenEmbedded</title> - <section> - <title>Getting <application>BitBake</application></title> - <para>The required version of <application>BitBake</application> is changing rapidly. At the time of writing (end of 2007) <application>BitBake</application> 1.8.latest was required.</para> - <para>A good method is to get <application>BitBake</application> from the stable Subversion branch. - <screen> -<command>svn</command> co http://svn.berlios.de/svnroot/repos/bitbake/branches/bitbake-1.8 -... -A bitbake-1.8/classes/base.bbclass -U bitbake-1.8 -At revision 986. - </screen> - <application>BitBake</application> is checked out now; this completes the first and most critical dependency of OpenEmbedded. Issuing <command>svn</command> <command>update</command> in the <emphasis>bitbake-1.8</emphasis> directory will update <application>BitBake</application> to the latest stable version, but generally it is a good idea to stick with a specific known working version of <application>BitBake</application> until OpenEmbedded asks you to upgrade. - </para> - </section> - - <section> - <title>Getting OpenEmbedded</title> - <para> -The OpenEmbedded metadate has a high rate of development, so it's a good idea to stay up to date. -You'll need monotone 0.29 or later to get the metadata and stay up to date. Monotone is available in most distributions and has binaries at http://venge.net/monotone/ - -<screen> -#get the snapshot -wget http://openembedded.org/snapshots/OE.db.bz2 http://openembedded.org/snapshots/OE.db.bz2.md5 - -#verify the integrity -cat OE.db.bz2.md5sum -md5sum OE.db.bz2 - -#extract the tarball -bunzip OE.db.bz2 - -#check the development branch -monotone --db=OE.db co -b org.openembedded.dev -</screen> - - </para> - </section> - - <section> - <title>Configuring OpenEmbedded</title> - <para>This section is a stub, help us by expanding it</para> - </section> - - <section> - <title>Building Software</title> - <para>Once you set up and configured BitBake and OpenEmbedded, you can build software and images like this: -<screen> -bitbake <recipe_name> -</screen> - </para> - - <para>This section is a stub, help us by expanding it</para> - </section> - </chapter> - - <chapter> <title>Special features</title> <section> <title>Debian package naming <anchor id="debian" /></title> |