[PATCH 0/4] [DOCS] Kernel Manual enhancement to creating a BSP

[PATCH 0/4] [DOCS] Kernel Manual enhancement to creating a BSP

[scott.m.rifenbark]

From: Scott Rifenbark <scott.m.rifenbark@intel.com>

I updated the sections on creating a BSP based on an existing similar
BSP with and without a local kernel repository.  This series of changes
were completed in conjunction with Bruce Ashfield reviewing the technical 
content.

Pull URL: git://git.pokylinux.org/poky-contrib.git
  Branch: srifenbark/docs
  Browse: http://git.pokylinux.org/cgit.cgi/poky-contrib/log/?h=srifenbark/docs

Thanks,
     <scott.m.rifenbark@intel.com>
---


Scott Rifenbark (4):
  documentation/kernel-manual/kernel-how-to.xml: Fix to step 1 of
    section 3.4.4
  documentation/kernel-manual/kernel-how-to.xml: Fix to step 3 of
    section 3.4.4
  documentation/kernel-manual/kernel-how-to.xml: fix to step 3 and 4 of
    section 3.4.4
  documentation/kernel-manual/kernel-how-to.xml: Changes to section
    3.4.4 and new 3.4.5

 documentation/kernel-manual/kernel-how-to.xml |   43 +++++++++++++++++++++++--
 1 files changed, 40 insertions(+), 3 deletions(-)

[PATCH 1/4] documentation/kernel-manual/kernel-how-to.xml: Fix to step 1 of section 3.4.4

[scott.m.rifenbark]

From: Scott Rifenbark <scott.m.rifenbark@intel.com>

Step one states that the linux-yocto_git.bbappend file is left.  This
file is associated with distro 2.6.37 kernel and the rest of the
example is associated with the 2.6.34 kernel.  So, I changed the
step to indicate that the directory is left with a linux-yocto-stable_git.bbappend
file.

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
---
 documentation/kernel-manual/kernel-how-to.xml |    3 ++-
 1 files changed, 2 insertions(+), 1 deletions(-)

diff --git a/documentation/kernel-manual/kernel-how-to.xml b/documentation/kernel-manual/kernel-how-to.xml
index c3c9569..efe81e5 100644
--- a/documentation/kernel-manual/kernel-how-to.xml
+++ b/documentation/kernel-manual/kernel-how-to.xml
@@ -1052,7 +1052,8 @@ That's it. Configure and build.
                         <listitem><para>Copy meta-emenlow</para></listitem>
                         <listitem><para>Fix or remove anything you do not need.  
                         For this example the only thing left was the kernel directory with a 
-                        <filename>linux-yocto_git.bbappend</filename> file (linux-yocto is the kernel listed in 
+                        <filename>linux-yocto-stable_git.bbappend</filename> file 
+                        (linux-yocto-stable is the kernel listed in 
                         <filename>meta-crownbay/conf/machine/crownbay.conf</filename></para></listitem>.
                         <listitem><para>Add a new entry in the <filename>build/conf/bblayers.conf</filename> 
                         so the new layer can be found by Bitbake.</para></listitem>
-- 
1.7.1

[PATCH 2/4] documentation/kernel-manual/kernel-how-to.xml: Fix to step 3 of section 3.4.4

[scott.m.rifenbark]

From: Scott Rifenbark <scott.m.rifenbark@intel.com>

Changed 'linux-yocto_git.bbappend' to 'linux-yocto-stable_git.bbappend'
in step 3 just before the code example.  This makes the code consistent
with the rest of the example supporting the 2.6.34 kernel.

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
---
 documentation/kernel-manual/kernel-how-to.xml |    2 +-
 1 files changed, 1 insertions(+), 1 deletions(-)

diff --git a/documentation/kernel-manual/kernel-how-to.xml b/documentation/kernel-manual/kernel-how-to.xml
index efe81e5..6d1da06 100644
--- a/documentation/kernel-manual/kernel-how-to.xml
+++ b/documentation/kernel-manual/kernel-how-to.xml
@@ -1089,7 +1089,7 @@ That's it. Configure and build.
                 </para></listitem>
                 
                 <listitem><para>
-                    In a layer, create a <filename>linux-yocto_git.bbappend</filename> 
+                    In a layer, create a <filename>linux-yocto-stable_git.bbappend</filename> 
                     file with the following:
                 </para>       
                 
-- 
1.7.1

[PATCH 3/4] documentation/kernel-manual/kernel-how-to.xml: fix to step 3 and 4 of section 3.4.4

[scott.m.rifenbark]

From: Scott Rifenbark <scott.m.rifenbark@intel.com>

Added text after the sample bbappend file stating that the user needs
to update the KSRC assignment statement and also remove its comment.
Also they have to remove the comment from the SRC_URI line.

Changed the bitbake command in step 4 to use the linux-yocto-stable
file rather than the linux-yocto file.

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
---
 documentation/kernel-manual/kernel-how-to.xml |    7 ++++++-
 1 files changed, 6 insertions(+), 1 deletions(-)

diff --git a/documentation/kernel-manual/kernel-how-to.xml b/documentation/kernel-manual/kernel-how-to.xml
index 6d1da06..2742611 100644
--- a/documentation/kernel-manual/kernel-how-to.xml
+++ b/documentation/kernel-manual/kernel-how-to.xml
@@ -1111,6 +1111,11 @@ That's it. Configure and build.
      # SRC_URI = "git://${KSRC};nocheckout=1;branch=${KBRANCH},meta;name=machine,meta"
                     </literallayout>
                 </para>
+
+                <para>
+                    In the previous sample file you need to update and remove the comment from 
+                    the KSRC assignment and also remove the comment from the SRC_URI line.
+                </para>
                 
                 <para>
                     After doing that, select the machine in <filename>build/conf/local.conf</filename>:
@@ -1177,7 +1182,7 @@ That's it. Configure and build.
                     Then, modify the code there, using quilt to save the changes, and recompile until 
                     it works:
                     <literallayout class='monospaced'>
-     $ bitbake -c compile -f linux-yocto
+     $ bitbake -c compile -f linux-yocto-stable
                     </literallayout>
                 </para></listitem>
                 
-- 
1.7.1

[PATCH 4/4] documentation/kernel-manual/kernel-how-to.xml: Changes to section 3.4.4 and new 3.4.5

[scott.m.rifenbark]

From: Scott Rifenbark <scott.m.rifenbark@intel.com>

I made some updates to the 3.4.4 section according to Bruce Ashfield's
feedback.  I also added a new section 3.4.5 (Creating a BSP Based on an
Existing Similar BSP Without a Local Kernel Repository).

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
---
 documentation/kernel-manual/kernel-how-to.xml |   31 +++++++++++++++++++++++++
 1 files changed, 31 insertions(+), 0 deletions(-)

diff --git a/documentation/kernel-manual/kernel-how-to.xml b/documentation/kernel-manual/kernel-how-to.xml
index 2742611..abb19f2 100644
--- a/documentation/kernel-manual/kernel-how-to.xml
+++ b/documentation/kernel-manual/kernel-how-to.xml
@@ -1198,6 +1198,37 @@ That's it. Configure and build.
             </para>
         </section>
 
+        <section id='bsp-creating-bsp-without-a-local-kernel-repo'>
+        <title>Creating a BSP Based on an Existing Similar BSP Without a Local Kernel Repository</title>
+
+            <para>
+                If you are creating a BSP based on an existing similar BSP but you do not have
+                a local kernel repository, the process is very similar to the process in 
+                the previous section (<xref linkend='bsp-creating'/>). 
+            </para>
+
+            <para>
+                Follow the exact same process as described in the previous section with 
+                these slight modifications:
+            </para>
+            <orderedlist>
+                <listitem><para>Perform Step 1 as is from the previous section.</para></listitem>
+                <listitem><para>Perform Step 2 as is from the previous section.</para></listitem>
+                <listitem><para>Perform Step 3 but do not modify the 
+                    KSRC line in the bbappend file.</para></listitem>
+                <listitem><para>Edit the <filename>local.conf</filename> so 
+                    that it contains the following:
+                    <literallayout class='monospaced'>
+     YOCTO_KERNEL_EXTERNAL_BRANCH="&lt;your-machine&gt;-standard
+                    </literallayout></para>
+                    <para>Adding this statement to the file triggers BSP bootstrapping
+                    to occur and the correct branches and base configuration to be used.
+                </para></listitem>
+                <listitem><para>Perform Step 4 as is from the previous section.</para></listitem>
+                <listitem><para>Perform Step 5 as is from the previous section.</para></listitem>
+            </orderedlist>
+        </section>
+
 
 <!--        <section id='bsp-creating-a-new-bsp'>
             <title>BSP: Creating a New BSP</title>
-- 
1.7.1

Re: [PATCH 0/4] [DOCS] Kernel Manual enhancement to creating a BSP

[Saul Wold]

On 02/18/2011 08:57 AM, scott.m.rifenbark@intel.com wrote:
> From: Scott Rifenbark<scott.m.rifenbark@intel.com>
>
> I updated the sections on creating a BSP based on an existing similar
> BSP with and without a local kernel repository.  This series of changes
> were completed in conjunction with Bruce Ashfield reviewing the technical
> content.
>
> Pull URL: git://git.pokylinux.org/poky-contrib.git
>    Branch: srifenbark/docs
>    Browse: http://git.pokylinux.org/cgit.cgi/poky-contrib/log/?h=srifenbark/docs
>
> Thanks,
>       <scott.m.rifenbark@intel.com>
> ---
>
>
> Scott Rifenbark (4):
>    documentation/kernel-manual/kernel-how-to.xml: Fix to step 1 of
>      section 3.4.4
>    documentation/kernel-manual/kernel-how-to.xml: Fix to step 3 of
>      section 3.4.4
>    documentation/kernel-manual/kernel-how-to.xml: fix to step 3 and 4 of
>      section 3.4.4
>    documentation/kernel-manual/kernel-how-to.xml: Changes to section
>      3.4.4 and new 3.4.5
>
>   documentation/kernel-manual/kernel-how-to.xml |   43 +++++++++++++++++++++++--
>   1 files changed, 40 insertions(+), 3 deletions(-)
>
> _______________________________________________
> poky mailing list
> poky@yoctoproject.org
> https://lists.yoctoproject.org/listinfo/poky
>
Merged into Master

Thanks
	Sau!