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: Append Files: 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 .bbappend filename suffix. - + a recipe file. + Append files are known as BitBake append files and .bbappend files. + The Yocto Project build system expects every append file to have a corresponding and + underlying recipe (.bb) 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. + formfactor_0.0.bb and formfactor_0.0.bbappend). + + Information in append files overrides the information in the similarly-named recipe file. + For examples of .bbappend file in use, see the + "Using .bbappend Files" and + "Changing recipes-kernel" + sections. BitBake: The task executor and scheduler used by the Yocto Project to build images. For more information on BitBake, see the