<?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>6925</bug_id>
          
          <creation_ts>2014-11-03 10:48:13 +0000</creation_ts>
          <short_desc>Mismatch between documentation and linux-yocto-custom.bb comments</short_desc>
          <delta_ts>2015-09-09 11:55:47 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Kernel Development</product>
          <component>kernel-development</component>
          <version>unspecified</version>
          <rep_platform>All</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>VERIFIED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>17 June 2015: Set the documentation flag to &quot;No&quot;</status_whiteboard>
          <keywords></keywords>
          <priority>Low</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>1.9 M2</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Paul Eggleton">bluelightning</reporter>
          <assigned_to name="Bruce Ashfield">bruce.ashfield</assigned_to>
          <cc>bogdanx.a.voiculescu</cc>
    
    <cc>bruce.ashfield</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>46721</commentid>
    <comment_count>0</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2014-11-03 10:48:13 +0000</bug_when>
    <thetext>The Kernel Development manual states that you should copy and modify linux-yocto-custom.bb, but the comments in the header of that file recommend creating a bbappend. We shouldn&apos;t have conflicting instructions so one of these needs changing.

My personal opinion for this recipe is that the copy and modify approach is the better one, as there is actually very little in the .bb file that you wouldn&apos;t have to change in the bbappend so you might as well copy the whole thing (and probably rename it).

Darren, could you please make a recommendation and then we can make the change as appropriate?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>46732</commentid>
    <comment_count>1</comment_count>
    <who name="Darren Hart">dvhart</who>
    <bug_when>2014-11-03 19:07:24 +0000</bug_when>
    <thetext>I concur with copy-and-modify being the preferred approach.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>46733</commentid>
    <comment_count>2</comment_count>
    <who name="Darren Hart">dvhart</who>
    <bug_when>2014-11-03 19:08:13 +0000</bug_when>
    <thetext>Bruce, do you mind taking this one?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>50893</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-05-11 15:49:24 +0000</bug_when>
    <thetext>Hey, 

Not sure if there is a documentation change needed here for the manual... please advise.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>50895</commentid>
    <comment_count>4</comment_count>
    <who name="Bruce Ashfield">bruce.ashfield</who>
    <bug_when>2015-05-11 19:07:17 +0000</bug_when>
    <thetext>Nothing for the manual, I&apos;ll update the source to match.

(In reply to comment #3)
&gt; Hey, 
&gt; 
&gt; Not sure if there is a documentation change needed here for the manual...
&gt; please advise.
&gt; 
&gt; Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>51761</commentid>
    <comment_count>5</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-06-17 13:00:17 +0000</bug_when>
    <thetext>Set the documentation flag to &quot;No&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>53875</commentid>
    <comment_count>6</comment_count>
    <who name="Alexandru Roman">alexandru.costinx.roman</who>
    <bug_when>2015-09-09 11:55:47 +0000</bug_when>
    <thetext>Verified on master: db92bc23880794be77373b0f2d8c26279dcecb84</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>