summaryrefslogtreecommitdiffstats
path: root/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
diff options
context:
space:
mode:
Diffstat (limited to 'bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml')
-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 @@
217 <listitem><para>Where the source code resides and 217 <listitem><para>Where the source code resides and
218 how to fetch it</para></listitem> 218 how to fetch it</para></listitem>
219 <listitem><para>Whether the source code requires 219 <listitem><para>Whether the source code requires
220 any patches</para></listitem> 220 any patches, where to find them, and how to apply
221 them</para></listitem>
221 <listitem><para>How to configure and compile the 222 <listitem><para>How to configure and compile the
222 source code</para></listitem> 223 source code</para></listitem>
223 <listitem><para>Where on the target machine to install the 224 <listitem><para>Where on the target machine to install the
224 package or packages being compiled</para></listitem> 225 package or packages created</para></listitem>
225 </itemizedlist> 226 </itemizedlist>
226 </para> 227 </para>
227 228
@@ -233,7 +234,11 @@
233 The term "package" is also commonly used to describe recipes. 234 The term "package" is also commonly used to describe recipes.
234 However, since the same word is used to describe packaged 235 However, since the same word is used to describe packaged
235 output from a project, it is best to maintain a single 236 output from a project, it is best to maintain a single
236 descriptive term, "recipes". 237 descriptive term - "recipes".
238 Put another way, a single "recipe" file is quite capable
239 of generating a number of related but separately installable
240 "packages".
241 In fact, that ability is fairly common.
237 </note> 242 </note>
238 </para> 243 </para>
239 </section> 244 </section>
@@ -318,7 +323,6 @@
318 Append files, which are files that have the 323 Append files, which are files that have the
319 <filename>.bbappend</filename> file extension, extend or 324 <filename>.bbappend</filename> file extension, extend or
320 override information in an existing recipe file. 325 override information in an existing recipe file.
321 recipe file.
322 </para> 326 </para>
323 327
324 <para> 328 <para>
@@ -331,8 +335,9 @@
331 </para> 335 </para>
332 336
333 <para> 337 <para>
334 Information in append files overrides the information in the 338 Information in append files extends or
335 similarly-named recipe file. 339 overrides the information in the underlying,
340 similarly-named recipe files.
336 </para> 341 </para>
337 342
338 <para> 343 <para>
@@ -357,6 +362,12 @@
357 However, if you named the append file 362 However, if you named the append file
358 <filename>busybox_1.%.bbappend</filename>, then you would have a match. 363 <filename>busybox_1.%.bbappend</filename>, then you would have a match.
359 </para> 364 </para>
365
366 <para>
367 In the most general case, you could name the append file something as
368 simple as <filename>busybox_%.bbappend</filename> to be entirely
369 version independent.
370 </para>
360 </section> 371 </section>
361 </section> 372 </section>
362 373
@@ -437,7 +448,7 @@
437 has been thoroughly tested for compatibility with the other 448 has been thoroughly tested for compatibility with the other
438 components. 449 components.
439 For information on how to check out a particular BitBake-based 450 For information on how to check out a particular BitBake-based
440 build system, the build system's supporting documentation. 451 build system, consult that build system's supporting documentation.
441 </para></listitem> 452 </para></listitem>
442 </itemizedlist> 453 </itemizedlist>
443 </para> 454 </para>