<?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>5855</bug_id>
          
          <creation_ts>2014-02-20 14:00:10 +0000</creation_ts>
          <short_desc>Document the possible values of the BUILDHISTORY_FEATURES variable</short_desc>
          <delta_ts>2014-03-11 20:14: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>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>11 March 2014 - RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>1.6</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Laszlo Papp">lpapp</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>richard.purdie</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>40496</commentid>
    <comment_count>0</comment_count>
    <who name="Laszlo Papp">lpapp</who>
    <bug_when>2014-02-20 14:00:10 +0000</bug_when>
    <thetext>Based on the underlying source code [1], it seems to be that the potential values can be the following:

* image

* package

* sdk

To be fair, the current documentation gives an example for the image, but it does not mention how to enable e.g. the package feature only, which seems to be what we need in our case unless I misunderstand that feature.

[1] http://git.yoctoproject.org/cgit/cgit.cgi/poky/tree/meta/classes/buildhistory.bbclass#n10</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>40534</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-02-20 19:08:26 +0000</bug_when>
    <thetext>Hi, 

I will need some help on this so I am adding Paul to the CC list.  There seems to be quite a few BUILDHISTORY_* variables.  We currently don&apos;t document any of them.  I am wondering if we should be?

The &quot;Using Build History to Gather Image Information Only&quot; section is what shows how to use the image value.  Would a separate section showing package and sdk be appropriate?  If so, this is where I would need some information.

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>40535</commentid>
    <comment_count>2</comment_count>
    <who name="Laszlo Papp">lpapp</who>
    <bug_when>2014-02-20 19:18:12 +0000</bug_when>
    <thetext>I forgot to be explicit, but I think this variable could be also added to the variable glossary at the bottom, just in case.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>40624</commentid>
    <comment_count>3</comment_count>
    <who name="Laszlo Papp">lpapp</who>
    <bug_when>2014-02-24 10:10:58 +0000</bug_when>
    <thetext>Hmm, my original post is incorrect in that sense that I apparently need the &quot;image&quot; BUILDHISTORY feature to get package names and versions, etc, rather than the &quot;package&quot; feature.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>40627</commentid>
    <comment_count>4</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2014-02-24 10:31:06 +0000</bug_when>
    <thetext>&quot;image&quot; means analysis of the contents of images (including, among other things, the list of installed packages)

&quot;package&quot; means analysis of the contents of individual package

&quot;sdk&quot; means analysis of the contents of SDKs</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>40634</commentid>
    <comment_count>5</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-02-24 14:02:02 +0000</bug_when>
    <thetext>Laszlo, 

I am going to document the BUILDHISTORY_* variables in the glossary.  That at least should provide some information so people will know what they get when they provide &quot;image&quot;, &quot;package&quot;, or &quot;sdk&quot;.

Paul, 

Thanks for the extra information.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>40983</commentid>
    <comment_count>6</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-03-07 19:37:09 +0000</bug_when>
    <thetext>Hi,

Several new variables documented for BUILDHISTORY_*.  Please review.

http://www.yoctoproject.org/docs/1.6/ref-manual/ref-manual.html#var-BUILDHISTORY_FEATURES

http://www.yoctoproject.org/docs/1.6/ref-manual/ref-manual.html#var-BUILDHISTORY_DIR

http://www.yoctoproject.org/docs/1.6/ref-manual/ref-manual.html#var-BUILDHISTORY_IMAGE_FILES

http://www.yoctoproject.org/docs/1.6/ref-manual/ref-manual.html#var-BUILDHISTORY_COMMIT

http://www.yoctoproject.org/docs/1.6/ref-manual/ref-manual.html#var-BUILDHISTORY_COMMIT_AUTHOR

http://www.yoctoproject.org/docs/1.6/ref-manual/ref-manual.html#var-BUILDHISTORY_PUSH_REPO

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>40988</commentid>
    <comment_count>7</comment_count>
    <who name="Laszlo Papp">lpapp</who>
    <bug_when>2014-03-07 19:55:08 +0000</bug_when>
    <thetext>Scott, it looks OK to me.

There is an issue in here: http://www.yoctoproject.org/docs/1.6/ref-manual/ref-manual.html#understanding-what-the-build-history-contains

because it is writing TMPDIR, but it was not introduced by your changes, so it could be fixed separately.

Thank you for your work.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>40989</commentid>
    <comment_count>8</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-03-07 20:48:04 +0000</bug_when>
    <thetext>Laszlo, 

Thanks for the quick look at these.  I updated the opening sentence in the section http://wwww.yoctoproject.org/docs/1.6/ref-manual/ref-manual.html#understanding-what-the-build-history-contains so that it says the build history information is kept in $TOPDIR/buildhistory.  

Thanks for your continued efforts with the documentation!

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>41106</commentid>
    <comment_count>9</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-03-11 20:14:33 +0000</bug_when>
    <thetext>Hi, 

I think we are good on this one.  I took care of the separate issue that Laszlo pointed out in his last comment.  Marking as RESOLVED and turning the Doc flag to &quot;Done&quot;.

Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>