<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugzilla.yoctoproject.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.6"
          urlbase="https://bugzilla.yoctoproject.org/"
          
          maintainer="it-coreprojects-helpdesk@linuxfoundation.org"
>

    <bug>
          <bug_id>8800</bug_id>
          
          <creation_ts>2015-12-13 01:03:40 +0000</creation_ts>
          <short_desc>Flesh out the do_populate_sysroot documentation</short_desc>
          <delta_ts>2016-03-22 16:22:21 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Reference</product>
          <component>handbook</component>
          <version>2.1</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>21 March 2016: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.1 M4</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter>ulfalizer</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>srifenbark</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Done (doc changes complete)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>57233</commentid>
    <comment_count>0</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2015-12-13 01:03:40 +0000</bug_when>
    <thetext>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:

&quot;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.&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>58697</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-02-06 00:32:47 +0000</bug_when>
    <thetext>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&apos;t say much about it.  Do you have any suggestions for this class?

Thanks,
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>58700</commentid>
    <comment_count>2</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-02-06 09:51:29 +0000</bug_when>
    <thetext>Looks good - thanks!

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

&quot;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.&quot;

With that wording it&apos;s clearer that do_populate_sysroot is from staging.bbclass.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>59048</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-02-15 18:49:25 +0000</bug_when>
    <thetext>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</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>60298</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-03-22 16:22:21 +0000</bug_when>
    <thetext>Closing this one out.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>