diff options
Diffstat (limited to 'documentation/kernel-dev/kernel-dev-common.xml')
-rw-r--r-- | documentation/kernel-dev/kernel-dev-common.xml | 94 |
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 9a55d7f..787f341 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 - can work. - See the - "<ulink url='&YOCTO_DOCS_DEV_URL;#get-your-layer-setup-for-the-build'>Get Your Layer Setup for the Build</ulink>" section - of the Yocto Project Development Manual for information. - </para> - - <para> - Next comes the <filename>.bbappend</filename> file. - You create this file in your custom layer. - You also name it accordingly based on the linux-yocto recipe - you are using. - For example, if you are modifying the - <filename>meta/recipes-kernel/linux/linux-yocto_3.4.bb</filename> - recipe, the append file will typical be located as follows - within your custom layer: - <literallayout class='monospaced'> + To modify an existing recipe, do the following: + <orderedlist> + <listitem><para>Create a minimal, custom layer from which you + can work. + See the "<link linkend='creating-and-preparing-a-layer'>Creating and Preparing a Layer</link>" + section for some general resources. + You can also see the + "<ulink url='&YOCTO_DOCS_DEV_URL;#get-your-layer-setup-for-the-build'>Get Your Layer Setup for the Build</ulink>" section + of the Yocto Project Development Manual for a detailed + example.</para></listitem> + <listitem><para>Create the <filename>.bbappend</filename> file. + You create this file in your custom layer. + You also name it accordingly based on the linux-yocto recipe + you are using. + For example, if you are modifying the + <filename>meta/recipes-kernel/linux/linux-yocto_3.4.bb</filename> + recipe, the append file will typical be located as follows + within your custom layer: + <literallayout class='monospaced'> <your-layer>/recipes-kernel/linux/linux-yocto_3.4.bbappend - </literallayout> - The append file should initially contain the following text: - <literallayout class='monospaced'> + </literallayout> + The append file should initially contain the following text: + <literallayout class='monospaced'> <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'>FILESEXTRAPATHS</ulink> := "${THISDIR}/${PN}" - </literallayout> - 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. - If you add any new files that modify the kernel recipe, you need - to place them in your layer in the following area: - <literallayout class='monospaced'> + </literallayout> + 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. + If you add any new files that modify the kernel recipe, + you need to place them in your layer in the following area: + <literallayout class='monospaced'> <your-layer>/recipes-kernel/linux/linux-yocto/ - </literallayout> - <note>If you are working on a new machine Board Support Package - (BSP), be sure to refer to the - <ulink url='&YOCTO_DOCS_BSP_URL;'>Yocto Project Board Support Package (BSP) Developer's Guide</ulink>. - </note> - </para> - - <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> + </literallayout> + <note>If you are working on a new machine Board Support Package + (BSP), be sure to refer to the + <ulink url='&YOCTO_DOCS_BSP_URL;'>Yocto Project Board Support Package (BSP) Developer's Guide</ulink>. + </note></para></listitem> + </orderedlist> </para> <section id='applying-patches'> |