<?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>8298</bug_id>
          
          <creation_ts>2015-09-15 09:13:56 +0000</creation_ts>
          <short_desc>No documentation for some classes from: meta/classes</short_desc>
          <delta_ts>2015-10-22 15:03:50 +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.9</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>13 Oct 2015 - IN PROGRESS REVIEW</status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.0</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</reporter>
          <assigned_to name="Jose Lamego">jose.a.lamego</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>srifenbark</cc>
          
          <qa_contact name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</qa_contact>
          <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>54054</commentid>
    <comment_count>0</comment_count>
    <who name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</who>
    <bug_when>2015-09-15 09:13:56 +0000</bug_when>
    <thetext>populate_sdk_ext class is not documented in http://www.yoctoproject.org/docs/1.8/ref-manual/ref-manual.html#ref-classes</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>54057</commentid>
    <comment_count>1</comment_count>
    <who name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</who>
    <bug_when>2015-09-15 09:24:31 +0000</bug_when>
    <thetext>also missing: 

image-empty.bbclass
dummy.bbclass
image-empty.bbclass
migrate_localcount.bbclass
pkg_distribute.bbclass
pkg_metainfo.bbclass
recipe_sanity.bbclass
sourcepkg.bbclass</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>54068</commentid>
    <comment_count>2</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2015-09-15 10:03:19 +0000</bug_when>
    <thetext>Are you looking at 1.8/master? dummy.bbclass was removed back in 2012. The following classes in master are also missing from the documentation:

image-buildinfo.bbclass
fs-uuid.bbclass
sign_rpm.bbclass
image-vm.bbclass
kernel-fitimage.bbclass
kernel-uboot.bbclass
kernel-uimage.bbclass
rootfsdebugfiles.bbclass
kernelsrc.bbclass</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>54071</commentid>
    <comment_count>3</comment_count>
    <who name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</who>
    <bug_when>2015-09-15 11:10:27 +0000</bug_when>
    <thetext>I compared the list from here https://bugzilla.yoctoproject.org/show_bug.cgi?id=4931 with the documentation.

Paul, is any way of getting all the bb.classes, so I could have an umbrella bug for all?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>54077</commentid>
    <comment_count>4</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2015-09-15 13:08:57 +0000</bug_when>
    <thetext>I was just looking under meta/classes/ - that&apos;s where all of the bbclass files can be found.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>54080</commentid>
    <comment_count>5</comment_count>
    <who name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</who>
    <bug_when>2015-09-15 13:22:22 +0000</bug_when>
    <thetext>so full list would be: 
autotools_stage.bbclass
cpan-base.bbclass
cpan_build.bbclass
distutils3-base.bbclass
distutils3-native-base.bbclass
distutils-base.bbclass
distutils-common-base.bbclass
distutils-native-base.bbclass
distutils-tools.bbclass
fs-uuid.bbclass
image-buildinfo.bbclass
image-vm.bbclass
kernel-fitimage.bbclass
kernel-grub.bbclass
kernelsrc.bbclass
kernel-uboot.bbclass
kernel-uimage.bbclass
libc-common.bbclass
libc-package.bbclass
migrate_localcount.bbclass
multilib.bbclass
multilib_global.bbclass
multilib_header.bbclass
populate_sdk_base.bbclass
populate_sdk_ext.bbclass
python3native.bbclass
qmake2.bbclass
qmake_base.bbclass
qt4e.bbclass
qt4x11.bbclass
recipe_sanity.bbclass
rootfs_deb.bbclass
rootfsdebugfiles.bbclass
rootfs_ipk.bbclass
rootfs_rpm.bbclass
sign_rpm.bbclass
testimage-auto.bbclass
useradd_base.bbclass</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>54082</commentid>
    <comment_count>6</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2015-09-15 13:43:52 +0000</bug_when>
    <thetext>Some of those are mentioned in the class reference though (e.g. some of the sections use a wildcard).</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>54132</commentid>
    <comment_count>7</comment_count>
    <who name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</who>
    <bug_when>2015-09-16 07:14:42 +0000</bug_when>
    <thetext>I observed some are not covered by those with wildcard: one example is &apos;populate_sdk_ext&apos;; we should have it all covered. I suggest to let the full list, in order to verify them all when closing the bug and not to be mislead by those with wildcards.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>54162</commentid>
    <comment_count>8</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-09-16 15:15:10 +0000</bug_when>
    <thetext>I will need some baseline descriptions of the missing classes from Paul Eggleton.  Once I get those, I will get some descriptions in for review. 

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>54952</commentid>
    <comment_count>9</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-10-03 19:29:22 +0000</bug_when>
    <thetext>Hi, 

Here are some links for review based on the text emailed to me for the new class descriptions.  Some of the classes are grouped using &quot;*&quot; characters as part of their name.  There are some issues doing this from the information I had.  Please look them over carefully and see if the groupings are correct and any unique information bundled under a &quot;*&quot; type class is captured:

These first three classes are all autotools* classes (autotools, autotools_stage, and autotools-brokensep).  I was a bit confused on how to treat these three separate classes.  The notes said to make autotools_stage like autotools.  Initially, I was going to create a single class description for &quot;autotools*) that would cover all three.  However, there is different information for the autotools-brokensep class.  So, I separated them into three descriptions.  Note that the autotools and autotools_stage classes appear to be identical.  Let me know what direction to go here.  Here are the links for the three classes:

 * http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-autotools-stage

* http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-autotools

* http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-autotools-brokensep

Here is the link for &quot;cpan*.bbclass&quot;: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-cpan

Here is the link for &quot;distutils-*.bblclass&quot; classes: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-distutils.  I am not sure about this bundled description.  It supposedly spans several distutils-* classes.  It was hard to figure out exactly the information from the bullets to apply to the group.  

Here is the link for the &quot;distutils3*.bbclass&quot; classes: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-distutils3.  Same comment here.  This single class grouping covers multiple classes.  Someone needs to look this general group description over and be sure that the technical information is correct.

Here is the link for the &quot;fs-uuid.bbclass&quot;: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-fs-uuid

Here is the link for the &quot;image-buildinfo.bbclass&quot;: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-image-buildinfo

Here is the link for the &quot;image-vm.bbclass&quot;: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-image-vm

Here is the link for the &quot;kernel-fitimage.bbclass&quot;: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-kernel-fitimage

Here is the link for the &quot;kernel-grub.bbclass&quot;: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-kernel-grub

Here is the link for the &quot;kernelsrc.bbclass&quot;: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-kernelsrc

Here is the link for the &quot;kernel-uboot.bbclass&quot;: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-kernel-uboot

Here is the link for the &quot;kernel-uimage.bbclass&quot;: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-kernel-uimage

Here is the link for the &quot;libc*.bbclass&quot; classes: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-libc*

Here is the link for the &quot;migrate_localcount.bbclass&quot;: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-migrate_localcount

Here is the link to the &quot;populate_sdk_*.bbclass&quot; where we added a new bullet of information: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-populate-sdk-*

Here is the link to the &quot;python3native.bbclass&quot;:  http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-python3native

Here is the link to the &quot;recipe_sanity.bbclass&quot;: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-recipe_sanity

Here is the link to the &quot;sign_rpm.bbclass&quot;: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-sign_rpm

Here is the link to the &quot;testimage*.bbclass&quot; classes: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-testimage*

Here is the link to the &quot;useradd*.bbclass&quot; classes: http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-useradd.  Some confusion on this one.  There is a &quot;useradd-staticids.bbclass&quot; description.  Does this get bundled user &quot;useradd*.bbclass&quot;?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>55131</commentid>
    <comment_count>10</comment_count>
    <who name="Jose Lamego">jose.a.lamego</who>
    <bug_when>2015-10-09 19:05:11 +0000</bug_when>
    <thetext>Scott, these are my comments. The rest of modifications look good, please let me know if more is needed.

(7.3. autotools.bbclass) Agree, the autotools and autotools_stage are identical so both can be bundled under a * class (autotools*.bbclass). For autotools_brokensep, I suggest to append its reference in the bundle as a final paragraph, without subheading or separator of any kind.

(7.36 distutils-*.bbclass) Rename bundle to distutils*.bbclass, because distutils.bbclass is also covered.
In first paragraph: change &quot;The distutils-*...&quot; to &quot;The distutils*...&quot;
In second bullet: change &quot;...require the distutils-* classes in...&quot; to &quot;...require the distutils.bbclass in...&quot; 
In last paragraph: change &quot;...some of the distutils-* classes...&quot; to &quot;...some of the distutils* classes...&quot;. Insert a new line start before &quot;The distutils-tools class...&quot; so every sub-class has it own paragraph within the bundle.

(7.37. distutils3*.bbclass) In first paragraph: change &quot;The distutils3 class...&quot; to &quot;The distutils3* classes...&quot;

(7.128. sign_rpm.bbclass) Remove duplicated &quot;The sign_rpm class&quot;

(7.138. testimage.bbclass) Remove this reference, as it is now bundled in following testimage*.bbclass

(7.139. testimage*.bbclass) In last paragraph: change &quot;Tests run automatically on...&quot; to &quot;The testimage-auto.bbclass runs tests on...&quot;. Insert a new line start before &quot;For information on how to enable...&quot;

(7.149. useradd*.bbclass) Append the reference for useradd-staticids.bbclass to this bundle. In appended Notes section: change &quot;You do not use this class...&quot; to &quot;You do not use the useradd-staticids class...&quot;

(7.150 useradd-staticids.bbclass) Remove this reference after appending it to useradd*.bbclass.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>55271</commentid>
    <comment_count>11</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-10-13 16:58:50 +0000</bug_when>
    <thetext>(In reply to comment #10)

Jose, 

I have applied all this feedback.  Below are the links so you can verify.

Thanks,
Scott


&gt; Scott, these are my comments. The rest of modifications look good, please
&gt; let me know if more is needed.
&gt; 
&gt; (7.3. autotools.bbclass) Agree, the autotools and autotools_stage are
&gt; identical so both can be bundled under a * class (autotools*.bbclass). For
&gt; autotools_brokensep, I suggest to append its reference in the bundle as a
&gt; final paragraph, without subheading or separator of any kind.

Jose - Please look at http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-autotools and let me know if this is ok.

&gt; 
&gt; (7.36 distutils-*.bbclass) Rename bundle to distutils*.bbclass, because
&gt; distutils.bbclass is also covered.
&gt; In first paragraph: change &quot;The distutils-*...&quot; to &quot;The distutils*...&quot;
&gt; In second bullet: change &quot;...require the distutils-* classes in...&quot; to
&gt; &quot;...require the distutils.bbclass in...&quot; 
&gt; In last paragraph: change &quot;...some of the distutils-* classes...&quot; to
&gt; &quot;...some of the distutils* classes...&quot;. Insert a new line start before &quot;The
&gt; distutils-tools class...&quot; so every sub-class has it own paragraph within the
&gt; bundle.

See http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-distutils

&gt; 
&gt; (7.37. distutils3*.bbclass) In first paragraph: change &quot;The distutils3
&gt; class...&quot; to &quot;The distutils3* classes...&quot;

See http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-distutils3

&gt; 
&gt; (7.128. sign_rpm.bbclass) Remove duplicated &quot;The sign_rpm class&quot;

Fixed - http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-sign_rpm

&gt; 
&gt; (7.138. testimage.bbclass) Remove this reference, as it is now bundled in
&gt; following testimage*.bbclass

This is no longer there and all cross-references in the YP set have been adjusted.

&gt; 
&gt; (7.139. testimage*.bbclass) In last paragraph: change &quot;Tests run
&gt; automatically on...&quot; to &quot;The testimage-auto.bbclass runs tests on...&quot;.
&gt; Insert a new line start before &quot;For information on how to enable...&quot;

See http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-testimage*

&gt; 
&gt; (7.149. useradd*.bbclass) Append the reference for useradd-staticids.bbclass
&gt; to this bundle. In appended Notes section: change &quot;You do not use this
&gt; class...&quot; to &quot;You do not use the useradd-staticids class...&quot;

See http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-useradd

&gt; 
&gt; (7.150 useradd-staticids.bbclass) Remove this reference after appending it
&gt; to useradd*.bbclass.

This has been removed and merged into useradd*.bbclass as directed.  Cross-references throughout the YP manual set adjusted.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>55275</commentid>
    <comment_count>12</comment_count>
    <who name="Jose Lamego">jose.a.lamego</who>
    <bug_when>2015-10-13 20:15:03 +0000</bug_when>
    <thetext>(in reply to Comment #11)

Scott, all changes look good. Please let me know if we are waiting for additional feedback.

Thanks</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>55304</commentid>
    <comment_count>13</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-10-14 15:28:03 +0000</bug_when>
    <thetext>Hi Jose, 

I still have it in IN PROGRESS REVIEW. I don&apos;t particularly need more feedback to close it if you have approved all the changes.  Just give me the word and I will set to RESOLVED/FIXED and reset the doc flag to &quot;Done.&quot;

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>55305</commentid>
    <comment_count>14</comment_count>
    <who name="Jose Lamego">jose.a.lamego</who>
    <bug_when>2015-10-14 15:42:09 +0000</bug_when>
    <thetext>All ok by me. Thanks Scott!

Jose</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>55306</commentid>
    <comment_count>15</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-10-14 15:53:01 +0000</bug_when>
    <thetext>Cool - thanks for changing status.  I flipped the doc flag to &quot;Done.&quot;

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>55599</commentid>
    <comment_count>16</comment_count>
    <who name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</who>
    <bug_when>2015-10-22 13:52:36 +0000</bug_when>
    <thetext>Verified on http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes; just rootfsdebugfiles still missing: should I fill a separate bug?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>55602</commentid>
    <comment_count>17</comment_count>
    <who name="Jose Lamego">jose.a.lamego</who>
    <bug_when>2015-10-22 14:02:12 +0000</bug_when>
    <thetext>(in reply to comment #16)

Thank you Bogdan, I missed that one.

Scott: please append the following bullet in &quot;7.120. rootfs*.bbclass&quot;:

- The rootfsdebugfiles class, which installs additional files found on the build host directly into the rootfs.

Let me know if more is needed.
Jose</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>55606</commentid>
    <comment_count>18</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-10-22 14:36:42 +0000</bug_when>
    <thetext>Hi, 

No need to create a new bug.  I added this in to the manual.  See http://www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html#ref-classes-rootfs*.

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>55613</commentid>
    <comment_count>19</comment_count>
    <who name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</who>
    <bug_when>2015-10-22 15:00:04 +0000</bug_when>
    <thetext>Thank you Jose and Scott! This was very fast :)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>55615</commentid>
    <comment_count>20</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-10-22 15:03:50 +0000</bug_when>
    <thetext>(In reply to comment #19)
&gt; Thank you Jose and Scott! This was very fast :)

Simple fix... thanks</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>