diff options
| author |   Robert P. J. Day <rpjday@crashcourse.ca> | 2014-07-08 15:32:50 +0300 |
|---|---|---|
| committer |   Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-07-21 11:00:35 +0100 |
| commit | af98b2ff4f44f892b63a6598e7fdfc144972ed3d (patch) | |
| tree | 430fbfed7bf8f5b02fe2d4dc7acc67a47e680425 /doc | |
| parent | 4e5db4bc460c12194a233dd283c273009606bb64 (diff) | |
| download | bitbake-contrib-af98b2ff4f44f892b63a6598e7fdfc144972ed3d.tar.gz | |
bitbake-user-manual-intro.xml: More edits to the intro chapter.
Some applied as is, some not applied, some modified.
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/bitbake-user-manual/bitbake-user-manual-intro.xml | 25 |
1 files changed, 18 insertions, 7 deletions
diff --git a/doc/bitbake-user-manual/bitbake-user-manual-intro.xml b/doc/bitbake-user-manual/bitbake-user-manual-intro.xml index 42ea19f3f..ade91e94f 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-intro.xml +++ b/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> |