<?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>7740</bug_id>
          
          <creation_ts>2015-05-12 11:44:45 +0000</creation_ts>
          <short_desc>Explain better what Toaster does in the layer checkout directory</short_desc>
          <delta_ts>2015-09-10 08:46:51 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>7</classification_id>
          <classification>Build System, Metadata &amp; Runtime</classification>
          <product>Toaster</product>
          <component>toaster</component>
          <version>1.8</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></status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>enhancement</bug_severity>
          <target_milestone>1.9 M3</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Belen Barros Pena">belen.barros.pena</reporter>
          <assigned_to name="Belen Barros Pena">belen.barros.pena</assigned_to>
          <cc>alexandru.damian</cc>
    
    <cc>belen.barros.pena</cc>
    
    <cc>bluelightning</cc>
    
    <cc>bogdanx.a.voiculescu</cc>
    
    <cc>brian.avery</cc>
    
    <cc>cristiana.voicu</cc>
    
    <cc>jessica.zhang</cc>
    
    <cc>randy.e.witt</cc>
    
    <cc>srifenbark</cc>
          
          <qa_contact name="Alexandru Roman">alexandru.costinx.roman</qa_contact>
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>No (bug/feature does not impact docs)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>50913</commentid>
    <comment_count>0</comment_count>
    <who name="Belen Barros Pena">belen.barros.pena</who>
    <bug_when>2015-05-12 11:44:45 +0000</bug_when>
    <thetext>Currently, the Toaster set up script asks users to define the layer checkout directory using this text:

-- Validation: The checkout directory must be set
Toaster needs to know in which directory it should check out the layers that will be needed for your builds. 
Toaster suggests &quot;/home/yocto&quot;. If you select this directory, a layer like &quot;meta-intel&quot; will end up in &quot;/home/yocto/meta-intel&quot;. 
Press enter to select &quot;home/yocto&quot; or type the full path to a different directory (must be a parent of current checkout directory):

We should make a bit more clear that the checkout directory should be a parent of the directory where you have cloned the sources you are using to run Toaster. Maybe we could say something like:

-- Validation: Please set the layers checkout directory

This is the directory where Toaster will checkout the source code of the layers you will build. 

To keep clean the clone you are using to run Toaster, the layers checkout directory should be a parent of such clone directory. 

Toaster suggests you use &quot;home/yocto&quot; as your layers checkout directory. Press enter to select &quot;home/yocto&quot; or type the full path to a different directory (remember, it must be a parent of the directory where you cloned the sources you are using to run Toaster):</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>50914</commentid>
    <comment_count>1</comment_count>
    <who name="Belen Barros Pena">belen.barros.pena</who>
    <bug_when>2015-05-12 11:45:42 +0000</bug_when>
    <thetext>Forgot to say: Randy, Scott, if you have any suggestions on how to improve on what I just wrote, please comment. 

Thanks!</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>50915</commentid>
    <comment_count>2</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-05-12 12:25:47 +0000</bug_when>
    <thetext>(In reply to comment #0)
&gt; Currently, the Toaster set up script asks users to define the layer checkout
&gt; directory using this text:
&gt; 
&gt; -- Validation: The checkout directory must be set
&gt; Toaster needs to know in which directory it should check out the layers that
&gt; will be needed for your builds. 
&gt; Toaster suggests &quot;/home/yocto&quot;. If you select this directory, a layer like
&gt; &quot;meta-intel&quot; will end up in &quot;/home/yocto/meta-intel&quot;. 
&gt; Press enter to select &quot;home/yocto&quot; or type the full path to a different
&gt; directory (must be a parent of current checkout directory):
&gt; 
&gt; We should make a bit more clear that the checkout directory should be a
&gt; parent of the directory where you have cloned the sources you are using to
&gt; run Toaster. Maybe we could say something like:
&gt; 
&gt; -- Validation: Please set the layers checkout directory

I would end the above sentence with a period.

&gt; 
&gt; This is the directory where Toaster will checkout the source code of the
&gt; layers you will build. 

You might consider this - &quot;This is the directory Toaster uses to checkout the source code of the layers you will build.&quot;

&gt; 
&gt; To keep clean the clone you are using to run Toaster, the layers checkout
&gt; directory should be a parent of such clone directory. 

You might consider this - &quot;To keep the clone you are using to run Toaster clean, the layers directory should be a parent of the clone directory.&quot;

&gt; 
&gt; Toaster suggests you use &quot;home/yocto&quot; as your layers checkout directory.
&gt; Press enter to select &quot;home/yocto&quot; or type the full path to a different
&gt; directory (remember, it must be a parent of the directory where you cloned
&gt; the sources you are using to run Toaster):

You might consider this - &quot;Toaster suggests you use &quot;home/yocto&quot; as your layers checkout directory.  Press enter to select &quot;home/yocto&quot; or type the full path to a different directory.  If you provide your own directory, it must be a parent of the cloned directory for the sources you are using to run Toaster.&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>50953</commentid>
    <comment_count>3</comment_count>
    <who name="Belen Barros Pena">belen.barros.pena</who>
    <bug_when>2015-05-13 09:38:38 +0000</bug_when>
    <thetext>The confusion was this one: 

&quot;it wasn’t clear that toaster wouldn’t make changes to the existing layers already in my “src” directory and would instead create a subdirectory and do its own checkouts.&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>52227</commentid>
    <comment_count>4</comment_count>
    <who name="brian avery">brian.avery</who>
    <bug_when>2015-07-08 22:34:00 +0000</bug_when>
    <thetext>What is forcing the requirement that it be the parent of the current directory?

For example, here is my directory structure when building stuff w/ Yocto
as I always prefer shadow builds to in-place builds:

~/src/yocto-poky/master/poky/GIT_CHECKOUT
~/src/yocto-poky/fido/poky/GIT_CHECKOUT
~/src/yocto-layers/master
~/src/yocto-layers/fido
~/src/yocto-builds/toaster-master
~/src/yocto-builds/toaster-fido
~/src/yocto-builds/arm-fido
~/src/yocto-builds/qemu-fido


My preference would probably be to put the layers toaster is checking out in 
either 
~/src/yocto-layers/toaster
or
~/src/yocto-builds/toaster-master/layerdir

The first is not a parent, the second choice would be a child. In either case, it seems odd to limit the destination directory for a git checkout assuming it is 
1) accessible
2) not already a git tree.
---
For reference, by hand I start builds as :
~/src/yocto-builds/arm-fido$&gt;../../yocto-poky/master/poky/oe-init-build-env
cd build
bitbake core-image-minimal</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>53315</commentid>
    <comment_count>5</comment_count>
    <who name="Belen Barros Pena">belen.barros.pena</who>
    <bug_when>2015-08-21 10:41:01 +0000</bug_when>
    <thetext>(In reply to comment #4)
&gt; What is forcing the requirement that it be the parent of the current
&gt; directory?

We have an enhancement open to remove this requirement (bug 7742), currently unassigned and set to 2.1

Until we get that done, I will update the text in the Toaster setup script to improve clarity.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>53320</commentid>
    <comment_count>6</comment_count>
    <who name="Belen Barros Pena">belen.barros.pena</who>
    <bug_when>2015-08-21 12:54:15 +0000</bug_when>
    <thetext>Patch submitted for review

https://lists.yoctoproject.org/pipermail/toaster/2015-August/002596.html</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>53826</commentid>
    <comment_count>7</comment_count>
    <who name="Belen Barros Pena">belen.barros.pena</who>
    <bug_when>2015-09-08 09:10:49 +0000</bug_when>
    <thetext>merged to master

http://git.yoctoproject.org/cgit/cgit.cgi/poky/commit/?id=ccc1d9ac0c7a0e1768fdfc043da106d144029f3c</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>53905</commentid>
    <comment_count>8</comment_count>
    <who name="Alexandru Roman">alexandru.costinx.roman</who>
    <bug_when>2015-09-10 08:46:35 +0000</bug_when>
    <thetext>Verified on master: d4585fa23d56a58c583ee33db067a23177a936b1</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>53906</commentid>
    <comment_count>9</comment_count>
    <who name="Alexandru Roman">alexandru.costinx.roman</who>
    <bug_when>2015-09-10 08:46:51 +0000</bug_when>
    <thetext>Verified on master: d4585fa23d56a58c583ee33db067a23177a936b1</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>