From 2512cbf862ca371223506da710bb8aa1a048ad99 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 11 Jan 2013 15:15:06 -0800 Subject: kernel-dev: Edits to "Modifying an Existing Recipe" Second pass through this section. Also removed the original text. Switching to numbered list. (From yocto-docs rev: 7978c5acd4776e6ade7c0ee34c6f7ab58eeb2bb9) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/kernel-dev/kernel-dev-common.xml | 94 ++++++++++---------------- 1 file changed, 34 insertions(+), 60 deletions(-) (limited to 'documentation') 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 @@ - To begin with, create a minimal, custom layer from which you - can work. - See the - "Get Your Layer Setup for the Build" section - of the Yocto Project Development Manual for information. - - - - Next comes the .bbappend 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 - meta/recipes-kernel/linux/linux-yocto_3.4.bb - recipe, the append file will typical be located as follows - within your custom layer: - + To modify an existing recipe, do the following: + + Create a minimal, custom layer from which you + can work. + See the "Creating and Preparing a Layer" + section for some general resources. + You can also see the + "Get Your Layer Setup for the Build" section + of the Yocto Project Development Manual for a detailed + example. + Create the .bbappend 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 + meta/recipes-kernel/linux/linux-yocto_3.4.bb + recipe, the append file will typical be located as follows + within your custom layer: + <your-layer>/recipes-kernel/linux/linux-yocto_3.4.bbappend - - The append file should initially contain the following text: - + + The append file should initially contain the following text: + FILESEXTRAPATHS := "${THISDIR}/${PN}" - - The path ${THISDIR}/${PN} 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: - + + The path ${THISDIR}/${PN} 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: + <your-layer>/recipes-kernel/linux/linux-yocto/ - - If you are working on a new machine Board Support Package - (BSP), be sure to refer to the - Yocto Project Board Support Package (BSP) Developer's Guide. - - - - - Original text: - -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. - + + If you are working on a new machine Board Support Package + (BSP), be sure to refer to the + Yocto Project Board Support Package (BSP) Developer's Guide. + +
-- cgit v1.2.3-54-g00ecf