<?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>2808</bug_id>
          
          <creation_ts>2012-07-20 15:40:44 +0000</creation_ts>
          <short_desc>Add an illustration showing &quot;source&quot; and &quot;destination&quot; directories</short_desc>
          <delta_ts>2013-09-30 08:09:10 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Quick Start</product>
          <component>quick-start</component>
          <version>unspecified</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>VERIFIED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>27 September 2013: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>1.5</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Dave Stewart">david.c.stewart</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>corneliux.stoicescu</cc>
    
    <cc>david.c.stewart</cc>
    
    <cc>jessica.zhang</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>richard.purdie</cc>
    
    <cc>sgw</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>23335</commentid>
    <comment_count>0</comment_count>
    <who name="Dave Stewart">david.c.stewart</who>
    <bug_when>2012-07-20 15:40:44 +0000</bug_when>
    <thetext>This was an idea from Gunnar Anderson of Volvo.

Suggested that it would really help to understand which directories are the sources of things and which are the destinations. This would facilitate knowing new people knowing which directories are safe to delete if you want to have the system rebuild things.

Destination directories should include downloads directory, shared state, tmp...

This picture might go in quickstart or might be in the development or reference guides.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>24501</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2012-08-27 15:39:37 +0000</bug_when>
    <thetext>Adding Richard Purdie and Paul Eggleton to the CC list. 

Can someone provide me with the basic &quot;from&quot; and &quot;to&quot; directories used during a typical image build?  I would like to create this illustration that shows the user where things come from and where they go to during a build. 

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>24577</commentid>
    <comment_count>2</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2012-08-29 08:32:21 +0000</bug_when>
    <thetext>The inputs you can&apos;t really delete would only be the metadata (layers containing recipes, classes, configuration etc.), and conf/* under the build directory; and, if you have any recipes pointing to local source files or repositories then those would be in the inputs as well - you wouldn&apos;t have any of those out of the box, but if you were developing your own software to be built by the build system as most people building a product would be, then you would have. 

Everything else (TMPDIR, SSTATEDIR, DL_DIR, ...) is output.

One thought that comes to mind however is that we should also answer the related question &quot;what should I keep if I want to be able to reproduce the build at a later date?&quot; In answering that I would suggest keeping the contents of the aforementioned inputs as well as at least SSTATEDIR and DL_DIR, although there are circumstances under which those won&apos;t completely result in the same output - e.g. we now have a default setting which keeps the sstate files for native recipes separated by the host distribution; thus if you moved these to a new machine with a different distro they at least will be rebuilt by default. We need to specifically resolve and document this topic IMO.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>30175</commentid>
    <comment_count>3</comment_count>
    <who name="Stoicescu Cornel">corneliux.stoicescu</who>
    <bug_when>2013-02-27 15:24:40 +0000</bug_when>
    <thetext>Scott, do you need any more information on this subject?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>30181</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-02-27 17:12:46 +0000</bug_when>
    <thetext>I will take the information from Paul&apos;s comment and create a rough drawing and then include it in a further comment for this bug.  We can assess it and build on it from there.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>36903</commentid>
    <comment_count>5</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-09-18 18:21:07 +0000</bug_when>
    <thetext>Hi, 

I am marking this extensive section for review now.  I have been working on it for a long time closely with Paul Eggleton.  It is complete now and there probably is time for changes if they are communicated to me fairly quickly.  The figures and some of the flow have been previously reviewed by Dave Stewart and I took action on that review. 

The idea of the section is a mid-level, detailed look at the overall BitBake process when generating an image or SDK.  The section does not delve overly deep into the bowels of the system but tries for a depth that would help the user grasp the overall process better with regard to output directories, variables, and input sources.  

Here is the link: http://www.yoctoproject.org/docs/latest/ref-manual/ref-manual.html#closer-look

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37305</commentid>
    <comment_count>6</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-09-27 21:15:15 +0000</bug_when>
    <thetext>Completed this new chapter for the Yocto Project Reference Manual.  You can view it at http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#closer-look.

Marking as RESOLVED.

Scottsection</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37326</commentid>
    <comment_count>7</comment_count>
    <who name="Stoicescu Cornel">corneliux.stoicescu</who>
    <bug_when>2013-09-30 08:09:10 +0000</bug_when>
    <thetext>The new section looks good. Great addition to the manual. Setting to VERIFIED.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>