<?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>1931</bug_id>
          
          <creation_ts>2012-01-25 11:55:30 +0000</creation_ts>
          <short_desc>Need better documentation on the IMAGE_INSTALL variable</short_desc>
          <delta_ts>2012-04-18 17:41:38 +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>1.0</version>
          <rep_platform>All</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>DUPLICATE</resolution>
          <dup_id>1897</dup_id>
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>Done</status_whiteboard>
          <keywords></keywords>
          <priority>Low</priority>
          <bug_severity>enhancement</bug_severity>
          <target_milestone>1.2 M4</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Scott Rifenbark">srifenbark</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>sgw</cc>
    
    <cc>song.liu</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>---</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>18357</commentid>
    <comment_count>0</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2012-01-25 11:55:30 +0000</bug_when>
    <thetext>The IMAGE_INSTALL variable is listed curtly in the glossary with the following:

   IMAGE_INSTALL - The list of packages used to build images

We need more information on this variable.  One thing, it sounds as if the user should not be setting it?  If that is the case, we need to declare that.  Also need to provide how the variable is used if it has any ramifications to the user.  If not, why do we even have it defined in the glossary.

The variable is also described in Section 3.2.1 of the reference manual, &quot;Customizing Images Using Custom .bb Files&quot;. (http://www.yoctoproject.org/docs/latest/poky-ref-manual/poky-ref-manual.html#usingpoky-extend-customimage-custombb).  This section implies that the user can control the contents of the image.  

The variable also appears in the next section (3.2.2 Customizing Images Using Custom Tasks) - http://www.yoctoproject.org/docs/latest/poky-ref-manual/poky-ref-manual.html#usingpoky-extend-customiage-customtasks. In this section IMAGE_INSTALL is mentioned in the context of needing to add &apos;task-custom-apps&apos; and/or &apos;task-custom-tools&apos; to the variable.  Again, this section implies user control over IMAGE_INSTALL.  

In Section 3.2.3 Customizing Images Using Custom IMAGE_FEATURES and EXTRA_IMAGE_FEATURES - http://www.yoctoproject.org/docs/latest/poky-ref-manual/poky-ref-manual.html#usingpoky-extend-customimage-imagefeatures the variable is talked about in the context of it being generated automatically.  

This is not very good documentation on IMAGE_INSTALL.  It could be improved.
I am opening a separate bug on it aimed at the documents.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>18451</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2012-02-01 14:54:17 +0000</bug_when>
    <thetext>Updated the description for IMAGE_INSTALL in the YP Reference Manual as well as noted its proper use from the local.conf file.

*** This bug has been marked as a duplicate of bug 1897 ***</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>