<?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>8019</bug_id>
          
          <creation_ts>2015-07-16 10:39:29 +0000</creation_ts>
          <short_desc>Clarification of IMAGE_INSTALL variable</short_desc>
          <delta_ts>2016-04-15 13:39:33 +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>unspecified</version>
          <rep_platform>All</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.2 M4</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Topi Kuutela">topi.kuutela</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>ross.burton</cc>
    
    <cc>srifenbark</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Yes (doc changes required)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>52428</commentid>
    <comment_count>0</comment_count>
    <who name="Topi Kuutela">topi.kuutela</who>
    <bug_when>2015-07-16 10:39:29 +0000</bug_when>
    <thetext>The current description of IMAGE_INSTALL is still confusing when it comes to usage in local.conf.

I propose changing the description as follows:
1. Declare IMAGE_INSTALL as inteded to be used only in image recipes.
2. Instead of describing the gotcha of IMAGE_INSTALL in local.conf, add reference to CORE_IMAGE_EXTRA_INSTALL which is already documented as local.conf only variable. 
This could be improved further by adding the CORE_IMAGE_EXTRA_INSTALL to IMAGE_INSTALL in core-image.bbclass instead of ?=&apos;ing it.

This change should also be reflected on other parts of the manual in which IMAGE_INSTALL is mentioned.

Related to previous changes and discussion on IMAGE_INSTALL on https://bugzilla.yoctoproject.org/show_bug.cgi?id=1897</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>52521</commentid>
    <comment_count>1</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2015-07-22 15:00:16 +0000</bug_when>
    <thetext>Unfortunately CORE_IMAGE_EXTRA_INSTALL won&apos;t work for all images because it&apos;s only handled by core-image.bbclass - it won&apos;t do anything for image recipes that only inherit from image.bbclass.

Can you explain what specifically you found confusing regarding setting it from local.conf?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>52535</commentid>
    <comment_count>2</comment_count>
    <who name="Topi Kuutela">topi.kuutela</who>
    <bug_when>2015-07-23 06:09:09 +0000</bug_when>
    <thetext>The possibility of using +=-syntax in local.conf, which gets overwritten by most (all?) example image recipes with no warning.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>54456</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-09-22 15:03:10 +0000</bug_when>
    <thetext>There is quite a bit of explanation in the variable&apos;s description regarding the dangers of using the &quot;+=&quot; operator with IMAGE_INSTALL.  Do we need more?  I think it is pretty clear.  If not, can you elaborate more?

See http://www.yoctoproject.org/docs/1.9/ref-manual/ref-manual.html#var-IMAGE_INSTALL

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>57871</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-01-15 16:04:37 +0000</bug_when>
    <thetext>Hi, 

Any further comments on this?

Thanks,
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>59116</commentid>
    <comment_count>5</comment_count>
    <who name="Stephen K Jolley">sjolley.yp.pm</who>
    <bug_when>2016-02-16 17:24:18 +0000</bug_when>
    <thetext>I am pulling this out of NEEDINFO, since Topi no longer has a valid e-mail address.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>61284</commentid>
    <comment_count>6</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2016-04-15 13:39:33 +0000</bug_when>
    <thetext>Looks like yocto-docs 834aebb75dce1c905b1e0f142d0d7de6bb44e7d4 fixed this.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>