Bug 5303

Summary:	reference manual entry for buildhistory is incorrect
Product:	[Documentation] Reference	Reporter:	Stoicescu Cornel <corneliux.stoicescu>
Component:	handbook	Assignee:	Scott Rifenbark <srifenbark>
Status:	VERIFIED FIXED	QA Contact:
Severity:	normal
Priority:	Medium+	CC:	bluelightning, jessica.zhang, poky.doc.watcher, poky.watcher, srifenbark
Version:	1.5
Target Milestone:	1.5 M5
Hardware:	x86
OS:	Multiple
Whiteboard:	03 October 2013: RESOLVED
OS type for building Yocto:	---	Type of Regression:	---
Verified:		Documentation change:	Done (doc changes complete)

Description Stoicescu Cornel 2013-10-02 12:13:28 UTC

http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#understanding-what-the-build-history-contains 

There are 2 issues:
1) "build-id" is a file not a directory
2) bug 4154 introduced a new folder "image-files" that contains 2 files: 
./image-files
./image-files/etc
./image-files/etc/group
./image-files/etc/passwd

NOTE: Point number 2) should have been addressed in the bug itself but since I was opening a bug for the "build-id" issue, I added it here to simplify things.

Comment 1 Paul Eggleton 2013-10-03 12:12:22 UTC

Well spotted. We should note somewhere also that the files under image-files are specified by BUILDHISTORY_IMAGE_FILES (which defaults to "/etc/passwd /etc/group").

Comment 2 Scott Rifenbark 2013-10-03 15:57:44 UTC

Hi, 

I updated the figure and a list of the files in the following sections:

http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#understanding-what-the-build-history-contains

http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#build-history-image-information

Please see if this will work.

Thanks, 
Scott

Comment 3 Stoicescu Cornel 2013-10-04 07:32:54 UTC

Changes to the documentation fix the reported issues.

Comment 4 Scott Rifenbark 2013-10-04 13:45:37 UTC

Thanks for the review.  I am marking RESOLVED. 

Scott

Comment 5 Stoicescu Cornel 2013-10-04 14:05:09 UTC

Setting to VERIFIED.