aboutsummaryrefslogtreecommitdiffstats
path: root/bitbake
diff options
context:
space:
mode:
authorRobert P. J. Day <rpjday@crashcourse.ca>2014-07-08 15:32:50 +0300
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-07-21 11:00:57 +0100
commit696973af240cbe0122189178895074adf0d643f4 (patch)
tree62091637367b17bee3be7ef4ea13ffc0eb131336 /bitbake
parent4df50d382763961501651eb4ca7d5dff11298479 (diff)
downloadopenembedded-core-contrib-696973af240cbe0122189178895074adf0d643f4.tar.gz
bitbake: bitbake-user-manual-intro.xml: More edits to the intro chapter.
Some applied as is, some not applied, some modified. (Bitbake rev: af98b2ff4f44f892b63a6598e7fdfc144972ed3d) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'bitbake')
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml25
1 files changed, 18 insertions, 7 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
index 42ea19f3fc..ade91e94f1 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
@@ -217,11 +217,12 @@
<listitem><para>Where the source code resides and
how to fetch it</para></listitem>
<listitem><para>Whether the source code requires
- any patches</para></listitem>
+ any patches, where to find them, and how to apply
+ them</para></listitem>
<listitem><para>How to configure and compile the
source code</para></listitem>
<listitem><para>Where on the target machine to install the
- package or packages being compiled</para></listitem>
+ package or packages created</para></listitem>
</itemizedlist>
</para>
@@ -233,7 +234,11 @@
The term "package" is also commonly used to describe recipes.
However, since the same word is used to describe packaged
output from a project, it is best to maintain a single
- descriptive term, "recipes".
+ descriptive term - "recipes".
+ Put another way, a single "recipe" file is quite capable
+ of generating a number of related but separately installable
+ "packages".
+ In fact, that ability is fairly common.
</note>
</para>
</section>
@@ -318,7 +323,6 @@
Append files, which are files that have the
<filename>.bbappend</filename> file extension, extend or
override information in an existing recipe file.
- recipe file.
</para>
<para>
@@ -331,8 +335,9 @@
</para>
<para>
- Information in append files overrides the information in the
- similarly-named recipe file.
+ Information in append files extends or
+ overrides the information in the underlying,
+ similarly-named recipe files.
</para>
<para>
@@ -357,6 +362,12 @@
However, if you named the append file
<filename>busybox_1.%.bbappend</filename>, then you would have a match.
</para>
+
+ <para>
+ In the most general case, you could name the append file something as
+ simple as <filename>busybox_%.bbappend</filename> to be entirely
+ version independent.
+ </para>
</section>
</section>
@@ -437,7 +448,7 @@
has been thoroughly tested for compatibility with the other
components.
For information on how to check out a particular BitBake-based
- build system, the build system's supporting documentation.
+ build system, consult that build system's supporting documentation.
</para></listitem>
</itemizedlist>
</para>