diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 20f97b9f86..11b53ac116 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -966,11 +966,24 @@ The bitbake-layers script with the create-layer subcommand simplifies creating a new general layer. - - For information on BSP layers, see the - "BSP Layers" - section in the Yocto Project Board Specific (BSP) - Developer's Guide. + Notes + + + For information on BSP layers, see the + "BSP Layers" + section in the Yocto Project Board Specific (BSP) + Developer's Guide. + + + In order to use a layer with the OpenEmbedded + build system, you need to add the layer to your + bblayers.conf configuration + file. + See the + "Adding a Layer Using the bitbake-layers Script" + section for more information. + + The default mode of the script's operation with this subcommand is to create a layer with the following: @@ -1009,6 +1022,13 @@ $ bitbake-layers create-layer your_layer_name + As an example, the following command adds a layer named + meta-scottrif: + + $ bitbake-layers create-layer meta-scottrif + NOTE: Starting bitbake server... + Add your new layer with 'bitbake-layers add-layer meta-scottrif' + @@ -1051,19 +1071,31 @@ Filename of the example recipe + + +
+ Adding a Layer Using the <filename>bitbake-layers</filename> Script Once you create your general layer, you must add it to your bblayers.conf file. - You can add your layer by using the + Adding the layer to this configuration file makes the + OpenEmbedded build system aware of your layer so that it can + search it for metadata. + + + + Add your layer by using the bitbake-layers add-layer command: $ bitbake-layers add-layer your_layer_name - Here is an example where a layer named - meta-scottrif is added and then the - layers are shown using the - bitbake-layers show-layers command: + Here is an example that adds a layer named + meta-scottrif to the configuration file. + Following the command that adds the layer is another + bitbake-layers command that shows the + layers that are in your bblayers.conf + file: $ bitbake-layers add-layer meta-scottrif NOTE: Starting bitbake server... @@ -1081,6 +1113,11 @@ Adding the layer to this file enables the build system to locate the layer during the build. + + During a build, the OpenEmbedded build system looks in + the layers from the top of the list down to the bottom + in that order. +
diff --git a/documentation/kernel-dev/kernel-dev-common.xml b/documentation/kernel-dev/kernel-dev-common.xml index 1ea5ca53d2..9686609bf5 100644 --- a/documentation/kernel-dev/kernel-dev-common.xml +++ b/documentation/kernel-dev/kernel-dev-common.xml @@ -136,7 +136,7 @@ Developer's Guide, respectively. For information on how to use the bitbake-layers create-layer - command, see the + command to quickly set up a layer, see the "Creating a General Layer Using the bitbake-layers Script" section in the Yocto Project Development Tasks Manual. @@ -360,7 +360,7 @@ Developer's Guide, respectively. For information on how to use the bitbake-layers create-layer - command, see the + command to quickly set up a layer, see the "Creating a General Layer Using the bitbake-layers Script" section in the Yocto Project Development Tasks Manual. @@ -489,7 +489,8 @@ See the "Creating a General Layer Using the bitbake-layers Script" section in the Yocto Project Development Tasks Manual for - information on how to use this script. + information on how to use this script to quick set up a + new layer.
diff --git a/documentation/yocto-project-qs/qs.xml b/documentation/yocto-project-qs/qs.xml index 23553f3516..2e5defe6a0 100644 --- a/documentation/yocto-project-qs/qs.xml +++ b/documentation/yocto-project-qs/qs.xml @@ -971,8 +971,8 @@ section in the same manual. - Add a Layer for Software: - For steps on how to add a general layer for software, + Create a Layer for Software: + For steps on how to create a general layer for software, see the "Creating a General Layer Using the bitbake-layers Script" section in the Yocto Project Development Tasks Manual.