<?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>10385</bug_id>
          
          <creation_ts>2016-10-06 04:51:02 +0000</creation_ts>
          <short_desc>creating-a-new-bsp-layer-using-the-yocto-bsp-script prompted default kernel (4.1) but described default kernel is 4.4</short_desc>
          <delta_ts>2016-11-29 18:30:37 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Development Manual</product>
          <component>development</component>
          <version>2.1.2</version>
          <rep_platform>Other</rep_platform>
          <op_sys>other</op_sys>
          <bug_status>VERIFIED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>14 Oct 2016: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium+</priority>
          <bug_severity>minor</bug_severity>
          <target_milestone>2.3 M1</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Gene Chen">genechen</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>jose.perez.carranza</cc>
    
    <cc>srifenbark</cc>
          
          <qa_contact name="Juan Ramos">juan.fernandox.ramos.frayle</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>66977</commentid>
    <comment_count>0</comment_count>
    <who name="Gene Chen">genechen</who>
    <bug_when>2016-10-06 04:51:02 +0000</bug_when>
    <thetext>First of all, I would like to express my thanks to YOCTO Project for pulling all the messy embedded development together. I am impressed with the quality of the document. Therefore I would like to help the project by pointing out a small typo.

This is just overlooked while porting from the older Yocto version to the newer Yocto version. I have captured the relevant context following:

http://www.yoctoproject.org/docs/2.1/bsp-guide/bsp-guide.html#creating-a-new-bsp-layer-using-the-yocto-bsp-script

     Would you like to use the default (4.1) kernel? (y/n) [default: y]
     Do you need a new machine branch for this BSP (the alternative is to re-use an existing branch)? [y/n] [default: y]
     Getting branches from remote repo git://git.yoctoproject.org/linux-yocto-4.1.git...
.
.
.
The script then prompts you for the kernel. The default 4.4 kernel is acceptable. So, the example accepts the default. If you enter &apos;n&apos;, the script prompts you to further enter the kernel you do want to use.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67094</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-10-10 16:46:19 +0000</bug_when>
    <thetext>Hi, 

Thanks for pointing out this inconsistency and error.  I have updated the 2.2 version of the BSP guide to use the default 4.8 kernel as part of the script output.  This is the version I am getting with with latest poky.  See http://www.yoctoproject.org/docs/2.2/bsp-guide/bsp-guide.html#creating-a-new-bsp-layer-using-the-yocto-bsp-script for the correction. 

I have updated the krogoth version of the manual as well (2.1.2).  This version uses the 4.4 kernel as the default.  See http://www.yoctoproject.org/docs/2.1.2/bsp-guide/bsp-guide.html#creating-a-new-bsp-layer-using-the-yocto-bsp-script for the change.

If these updates are acceptable, I will set the bug to RESOLVED and put the doc flag to &quot;done.&quot;  Let me know.  You could probably change the ownership of the bug to Scott Rifenbark as it is a documentation fix.

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67112</commentid>
    <comment_count>2</comment_count>
    <who name="Gene Chen">genechen</who>
    <bug_when>2016-10-10 22:32:46 +0000</bug_when>
    <thetext>Scott,

Re-assigned this bug to you.

The fix on 2.2 and 2.1.2 looks good. I don&apos;t know whether you can fix this in 2.1 because Yoctoproject&apos;s main documentation still point to 2.1. For any newbie like me to visit the project would see it. If Yocto is moving to 2.1.2 or 2.2 soon then we don&apos;t have to worry about 2.1 at all.

Thanks,

Gene</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67113</commentid>
    <comment_count>3</comment_count>
    <who name="Gene Chen">genechen</who>
    <bug_when>2016-10-10 22:41:01 +0000</bug_when>
    <thetext>
Take a closer look at the main documentation page https://www.yoctoproject.org/documentation.

It has the reference to both 2.1 and 2.1.1&apos;s &quot;Yocto Project Board Support Package (BSP) Developer&apos;s Guide&quot;. We can address this by either change the main documentation to point to only 2.1.2 or fix both 2.1 and 2.1.1 BSP guide.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67136</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-10-11 13:48:31 +0000</bug_when>
    <thetext>Hi Gene, 

So this situation is always bad for me and the documentation.  There is an error in current or past version and the development has moved past those versions.  In this case, the most current version of YP for the &apos;krogoth&apos; branch (2.1, 2.1.1, and 2.1.2) is 2.1.1.  However, the top of that branch is for the &quot;under-development&quot; 2.1.2 release.  I can &quot;fix&quot; the 2.1.1 manual with a change to the manual that appears on the web site only.  The change only sticks as long as I never rebuild that particular manual set again, or if I do, I remember to re-apply the same change before building it out again.  This is the problem with back-filling a change underneath the top part of a branch.

Now, in the &apos;master&apos; branch of the yocto-docs, the manuals under development are for 2.2.  So the fix is in place for both 2.1.2 and 2.2, which are to be released soon.

I can go in and checkout out the docs on the specific 2.1 and 2.1.1 tags and make the change so that the manuals on the website will be correct.  Users that would perhaps download the manual set based on a tag or a release will not get that specific change though.

See http://www.yoctoproject.org/docs/2.1.1/bsp-guide/bsp-guide.html#creating-a-new-bsp-layer-using-the-yocto-bsp-script for the change in the 2.1.1 BSP manual.

See http://www.yoctoproject.org/docs/2.1/bsp-guide/bsp-guide.html#creating-a-new-bsp-layer-using-the-yocto-bsp-script for the change in the 2.1 BSP manual.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67164</commentid>
    <comment_count>5</comment_count>
    <who name="Gene Chen">genechen</who>
    <bug_when>2016-10-12 02:10:28 +0000</bug_when>
    <thetext>Scott,

Thanks for taking extra effort to fix the error in the current version.
Although there is a small chance the error can come back. Since 2.1.2 and 2.2 will be release soon, the window for that to happen is small. Therefore I believe what you have done is enough for now.  

Thanks,

Gene</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67277</commentid>
    <comment_count>6</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-10-14 19:22:29 +0000</bug_when>
    <thetext>Ok Gene, 

Thanks... I am putting the bug to RESOLVED and marking the doc flag at &quot;done.&quot;

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>68691</commentid>
    <comment_count>7</comment_count>
    <who name="Juan Ramos">juan.fernandox.ramos.frayle</who>
    <bug_when>2016-11-29 18:30:37 +0000</bug_when>
    <thetext>tested in commit 6c9f6b5f70ab3ee194b2c2c6f3bd462c994848fa creating a new image:

Would you like to use the default (4.8) kernel? (y/n) [default: y] 

As said in:

http://www.yoctoproject.org/docs/2.2/bsp-guide/bsp-guide.html#creating-a-new-bsp-layer-using-the-yocto-bsp-script


also checked commit cca8dd15c8096626052f6d8d25ff1e9a606104a3

Would you like to use the default (4.4) kernel? (y/n) [default: y] 

As said in:

http://www.yoctoproject.org/docs/2.1/bsp-guide/bsp-guide.html#creating-a-new-bsp-layer-using-the-yocto-bsp-script</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>