From 0f25a65a2646a8dd5157285f0e5555a17b5dabd9 Mon Sep 17 00:00:00 2001
From: Scott Rifenbark <scott.m.rifenbark@intel.com>
Date: Tue, 13 Mar 2012 17:11:02 -0600
Subject: documentation/dev-manual/dev-manual-newbie.xml: Added to append term

I added more information to the YP Term "Append Files."

(From yocto-docs rev: e1a7e9b0a790d394e237a0972140107d11178408)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---
 documentation/dev-manual/dev-manual-newbie.xml | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

(limited to 'documentation')

diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml
index 1da05e20df..0cf9f3110f 100644
--- a/documentation/dev-manual/dev-manual-newbie.xml
+++ b/documentation/dev-manual/dev-manual-newbie.xml
@@ -197,10 +197,19 @@
         While some of these terms are universal, the list includes them just in case:
         <itemizedlist>
             <listitem><para><emphasis>Append Files:</emphasis> Files that append build information to 
-                a recipe file.  
-                Information in append files overrides the information in the similarly-named recipe file.
-                Append files use the <filename>.bbappend</filename> filename suffix.
-                </para></listitem>
+                a recipe file.
+                Append files are known as BitBake append files and <filename>.bbappend</filename> files.
+                The Yocto Project build system expects every append file to have a corresponding and 
+                underlying recipe (<filename>.bb</filename>) file.
+                Furthermore, the append file and the underlying recipe must have the same root filename.
+                The filenames can differ only in the file type suffix used (e.g. 
+                <filename>formfactor_0.0.bb</filename> and <filename>formfactor_0.0.bbappend</filename>).
+                </para>
+                <para>Information in append files overrides the information in the similarly-named recipe file.
+                For examples of <filename>.bbappend</filename> file in use, see the
+                "<link linkend='using-bbappend-files'>Using .bbappend Files</link>" and 
+                "<link linkend='changing-recipes-kernel'>Changing <filename>recipes-kernel</filename></link>"
+                sections.</para></listitem>
             <listitem><para><emphasis>BitBake:</emphasis> The task executor and scheduler used by 
                 the Yocto Project to build images. 
                 For more information on BitBake, see the <ulink url='http://bitbake.berlios.de/manual/'>
-- 
cgit v1.2.3-54-g00ecf