Bug 1891

Summary:	No examples of .bbappend or kernel config fragments in the manual
Product:	[Documentation] Reference	Reporter:	Richard Purdie <richard.purdie>
Component:	handbook	Assignee:	Scott Rifenbark <srifenbark>
Status:	RESOLVED FIXED	QA Contact:
Severity:	major
Priority:	Medium	CC:	jack, poky.doc.watcher, poky.watcher, sgw
Version:	unspecified
Target Milestone:	1.2 M3
Hardware:	x86
OS:	Multiple
URL:	http://git.yoctoproject.org/cgit.cgi/yocto-docs/commit/?id=4fb34abd60180fc2482ddb9f62e476763cee7679
Whiteboard:	13-March-2012: Resolved/Fixed
OS type for building Yocto:	---	Type of Regression:	---
Verified:		Documentation change:	---

Description Richard Purdie 2012-01-11 05:55:55 UTC

To quote a user from irc "Snafflehog: RP__: I'm looking for where the documentation is on adding bbappends and kernel config fragments - I can't find it for the life in me! Could you point me to at least the correct piece of documentation as they all seem to step on each others toes!"

I looked at the manuals and he's right. Nowhere is there any example about what a .bbappend file might contain. Searching for information about kerne; config fragments, again I can't find any example in the manual. We need to do better!

Comment 1 Scott Rifenbark 2012-01-11 06:08:23 UTC

I am creating a new chapter in the YP Dev manual entitled "Common Tasks".  This chapter is going to eventually contain usage information that is currently in the YP Reference Manual.  To address this bug I will have sections that describe isolated examples for creating a .bbappend file and a configuration fragment.

Comment 2 Jack Mitchell 2012-01-11 06:37:38 UTC

That sounds exactly like what I was looking for Scott, Cheers.

Comment 3 Scott Rifenbark 2012-03-13 23:22:29 UTC

Created a new section called "Understanding and Using Layers" in the YP Development manual.  Inside the section is another section called "Using .bbappend Files."  This section, along with several other edit passes through the manual should provide information on how to use a .bbappend file.  

To see how .bbappend is treated throughout the dev manual, see the latest version at http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html.

Scott