1 files changed, 34 insertions, 60 deletions
diff --git a/documentation/kernel-dev/kernel-dev-common.xml b/documentation/kernel-dev/kernel-dev-common.xml
index 9a55d7f555..787f3411b7 100644
--- a/documentation/kernel-dev/kernel-dev-common.xml
+++ b/documentation/kernel-dev/kernel-dev-common.xml
@@ -51,69 +51,43 @@
        </para>
        <para>
-            To begin with, create a minimal, custom layer from which you
+            To modify an existing recipe, do the following:
-            can work.
+            <orderedlist>
-            See the
+                <listitem><para>Create a minimal, custom layer from which you
-            "<ulink url='&YOCTO_DOCS_DEV_URL;#get-your-layer-setup-for-the-build'>Get Your Layer Setup for the Build</ulink>" section
+                    can work.
-            of the Yocto Project Development Manual for information.
+                    See the "<link linkend='creating-and-preparing-a-layer'>Creating and Preparing a Layer</link>"
-        </para>
+                    section for some general resources.
+                    You can also see the
-        <para>
+                    "<ulink url='&YOCTO_DOCS_DEV_URL;#get-your-layer-setup-for-the-build'>Get Your Layer Setup for the Build</ulink>" section
-            Next comes the <filename>.bbappend</filename> file.
+                    of the Yocto Project Development Manual for a detailed
-            You create this file in your custom layer.
+                    example.</para></listitem>
-            You also name it accordingly based on the linux-yocto recipe
+                <listitem><para>Create the <filename>.bbappend</filename> file.
-            you are using.
+                    You create this file in your custom layer.
-            For example, if you are modifying the
+                    You also name it accordingly based on the linux-yocto recipe
-            <filename>meta/recipes-kernel/linux/linux-yocto_3.4.bb</filename>
+                    you are using.
-            recipe, the append file will typical be located as follows
+                    For example, if you are modifying the
-            within your custom layer:
+                    <filename>meta/recipes-kernel/linux/linux-yocto_3.4.bb</filename>
-            <literallayout class='monospaced'>
+                    recipe, the append file will typical be located as follows
+                    within your custom layer:
+                    <literallayout class='monospaced'>
     &lt;your-layer&gt;/recipes-kernel/linux/linux-yocto_3.4.bbappend
-            </literallayout>
+                    </literallayout>
-            The append file should initially contain the following text:
+                    The append file should initially contain the following text:
-            <literallayout class='monospaced'>
+                    <literallayout class='monospaced'>
     <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'>FILESEXTRAPATHS</ulink> := "${THISDIR}/${PN}"
-            </literallayout>
+                    </literallayout>
-            The path <filename>${THISDIR}/${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PN'><filename>PN</filename></ulink><filename>}</filename> expands
+                    The path <filename>${THISDIR}/${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PN'><filename>PN</filename></ulink><filename>}</filename> expands
-            to "linux-yocto" in the current directory for this example.
+                    to "linux-yocto" in the current directory for this example.
-            If you add any new files that modify the kernel recipe, you need
+                    If you add any new files that modify the kernel recipe,
-            to place them in your layer in the following area:
+                    you need to place them in your layer in the following area:
-            <literallayout class='monospaced'>
+                    <literallayout class='monospaced'>
     &lt;your-layer&gt;/recipes-kernel/linux/linux-yocto/
-            </literallayout>
+                    </literallayout>
-            <note>If you are working on a new machine Board Support Package
+                    <note>If you are working on a new machine Board Support Package
-                (BSP), be sure to refer to the
+                        (BSP), be sure to refer to the
-                <ulink url='&YOCTO_DOCS_BSP_URL;'>Yocto Project Board Support Package (BSP) Developer's Guide</ulink>.
+                        <ulink url='&YOCTO_DOCS_BSP_URL;'>Yocto Project Board Support Package (BSP) Developer's Guide</ulink>.
-            </note>
+                    </note></para></listitem>
-        </para>
+            </orderedlist>
-        <para>
-            Original text:
-            <literallayout class='monospaced'>
-In many cases, you can customize an existing linux-yocto recipe to meet the
-needs of your project. Each release of the Yocto Project provides a few Linux
-kernel recipes to choose from. To get started, prepare a layer and a bbappend
-file corresponding to the recipe you wish to modify.
-See [New example in Dev Manual] for instructions to create a minimal layer.
-The bbappend will typical be located at the following location relative to the
-layer (if modifying the linux-yocto_3.4.bb recipe):
-        recipes-kernel/linux/linux-yocto_3.4.bbappend
-And should contain the following text initially:
-        FILESEXTRAPATHS := "${THISDIR}/${PN}"
-The ${PN} will expand to "linux-yocto" in this example. Any new files added to
-modify the recipe should then be added to the following path within the layer:
-        recipes-kernel/linux/linux-yocto/
-NOTE: If you are working on a new machine BSP, be sure to refer to the Yocto
-Project Board Support Package Developer's Guide.
-            </literallayout>
        </para>
        <section id='applying-patches'>

diff --git a/documentation/kernel-dev/kernel-dev-common.xml b/documentation/kernel-dev/kernel-dev-common.xml index 9a55d7f555..787f3411b7 100644 --- a/documentation/kernel-dev/kernel-dev-common.xml +++ b/documentation/kernel-dev/kernel-dev-common.xml
@@ -51,69 +51,43 @@
51	</para>	51	</para>
52		52
53	<para>	53	<para>
54	To begin with, create a minimal, custom layer from which you	54	To modify an existing recipe, do the following:
55	can work.	55	<orderedlist>
56	See the	56	<listitem><para>Create a minimal, custom layer from which you
57	"<ulink url='&YOCTO_DOCS_DEV_URL;#get-your-layer-setup-for-the-build'>Get Your Layer Setup for the Build</ulink>" section	57	can work.
58	of the Yocto Project Development Manual for information.	58	See the "<link linkend='creating-and-preparing-a-layer'>Creating and Preparing a Layer</link>"
59	</para>	59	section for some general resources.
60		60	You can also see the
61	<para>	61	"<ulink url='&YOCTO_DOCS_DEV_URL;#get-your-layer-setup-for-the-build'>Get Your Layer Setup for the Build</ulink>" section
62	Next comes the <filename>.bbappend</filename> file.	62	of the Yocto Project Development Manual for a detailed
63	You create this file in your custom layer.	63	example.</para></listitem>
64	You also name it accordingly based on the linux-yocto recipe	64	<listitem><para>Create the <filename>.bbappend</filename> file.
65	you are using.	65	You create this file in your custom layer.
66	For example, if you are modifying the	66	You also name it accordingly based on the linux-yocto recipe
67	<filename>meta/recipes-kernel/linux/linux-yocto_3.4.bb</filename>	67	you are using.
68	recipe, the append file will typical be located as follows	68	For example, if you are modifying the
69	within your custom layer:	69	<filename>meta/recipes-kernel/linux/linux-yocto_3.4.bb</filename>
70	<literallayout class='monospaced'>	70	recipe, the append file will typical be located as follows
		71	within your custom layer:
		72	<literallayout class='monospaced'>
71	<your-layer>/recipes-kernel/linux/linux-yocto_3.4.bbappend	73	<your-layer>/recipes-kernel/linux/linux-yocto_3.4.bbappend
72	</literallayout>	74	</literallayout>
73	The append file should initially contain the following text:	75	The append file should initially contain the following text:
74	<literallayout class='monospaced'>	76	<literallayout class='monospaced'>
75	<ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'>FILESEXTRAPATHS</ulink> := "${THISDIR}/${PN}"	77	<ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'>FILESEXTRAPATHS</ulink> := "${THISDIR}/${PN}"
76	</literallayout>	78	</literallayout>
77	The path <filename>${THISDIR}/${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PN'><filename>PN</filename></ulink><filename>}</filename> expands	79	The path <filename>${THISDIR}/${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PN'><filename>PN</filename></ulink><filename>}</filename> expands
78	to "linux-yocto" in the current directory for this example.	80	to "linux-yocto" in the current directory for this example.
79	If you add any new files that modify the kernel recipe, you need	81	If you add any new files that modify the kernel recipe,
80	to place them in your layer in the following area:	82	you need to place them in your layer in the following area:
81	<literallayout class='monospaced'>	83	<literallayout class='monospaced'>
82	<your-layer>/recipes-kernel/linux/linux-yocto/	84	<your-layer>/recipes-kernel/linux/linux-yocto/
83	</literallayout>	85	</literallayout>
84	<note>If you are working on a new machine Board Support Package	86	<note>If you are working on a new machine Board Support Package
85	(BSP), be sure to refer to the	87	(BSP), be sure to refer to the
86	<ulink url='&YOCTO_DOCS_BSP_URL;'>Yocto Project Board Support Package (BSP) Developer's Guide</ulink>.	88	<ulink url='&YOCTO_DOCS_BSP_URL;'>Yocto Project Board Support Package (BSP) Developer's Guide</ulink>.
87	</note>	89	</note></para></listitem>
88	</para>	90	</orderedlist>
89
90	<para>
91	Original text:
92	<literallayout class='monospaced'>
93	In many cases, you can customize an existing linux-yocto recipe to meet the
94	needs of your project. Each release of the Yocto Project provides a few Linux
95	kernel recipes to choose from. To get started, prepare a layer and a bbappend
96	file corresponding to the recipe you wish to modify.
97
98	See [New example in Dev Manual] for instructions to create a minimal layer.
99
100	The bbappend will typical be located at the following location relative to the
101	layer (if modifying the linux-yocto_3.4.bb recipe):
102
103	recipes-kernel/linux/linux-yocto_3.4.bbappend
104
105	And should contain the following text initially:
106
107	FILESEXTRAPATHS := "${THISDIR}/${PN}"
108
109	The ${PN} will expand to "linux-yocto" in this example. Any new files added to
110	modify the recipe should then be added to the following path within the layer:
111
112	recipes-kernel/linux/linux-yocto/
113
114	NOTE: If you are working on a new machine BSP, be sure to refer to the Yocto
115	Project Board Support Package Developer's Guide.
116	</literallayout>
117	</para>	91	</para>
118		92
119	<section id='applying-patches'>	93	<section id='applying-patches'>