Bug 8800

Summary: Flesh out the do_populate_sysroot documentation
Product: [Documentation] Reference Reporter: ulfalizer
Component: handbookAssignee: Scott Rifenbark <srifenbark>
Status: RESOLVED FIXED QA Contact:
Severity: normal    
Priority: Medium CC: bluelightning, poky.doc.watcher, poky.watcher, srifenbark
Version: 2.1   
Target Milestone: 2.1 M4   
Hardware: x86   
OS: Multiple   
Whiteboard: 21 March 2016: RESOLVED
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: Done (doc changes complete)

Description ulfalizer 2015-12-13 01:03:40 UTC
The documentation for do_populate_sysroot seems a bit terse at the moment. I suggest writing something like the following, which also makes staging.bbclass easier to find:

"Copies a subset of the files installed by the do_install task into the sysroot to make them available to other recipes. Files that would typically not be needed by other recipes at build time are skipped, including files installed into /etc. See [staging.bbclass] for exactly which files are copied."
Comment 1 Scott Rifenbark 2016-02-06 00:32:47 UTC
Hi, 

See http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#ref-tasks-populate_sysroot for the updated explanation of do_populate_sysroot.  

Also, I noticed that the staging class description (http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#ref-classes-staging) really doesn't say much about it.  Do you have any suggestions for this class?

Thanks,
Scott
Comment 2 ulfalizer 2016-02-06 09:51:29 UTC
Looks good - thanks!

Maybe staging.bbclass could be rephrased like this, though I don't think it's that bad as is:

"The staging class provides the do_populate_sysroot task, which stages files into the sysroot to make them available to other recipes at build time."

With that wording it's clearer that do_populate_sysroot is from staging.bbclass.
Comment 3 Scott Rifenbark 2016-02-15 18:49:25 UTC
Thanks, 

Your wording is fine.  I updated the section.  See http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#ref-classes-staging.

Scott
Comment 4 Scott Rifenbark 2016-03-22 16:22:21 UTC
Closing this one out.