From cf654970763f4a8acaa52da61ef7dd4dd0b2b6fd Mon Sep 17 00:00:00 2001 From: Paul Eggleton Date: Tue, 23 Aug 2011 15:33:13 +0100 Subject: documentation: update BBFILE_* variable documentation * Add documentation of LAYERVERSION, LAYERDEPENDS and new layer priority behaviour * Improve some wording (From yocto-docs rev: be7c10f3b8b35ff231e5974a48936e66fd49fcbc) Signed-off-by: Paul Eggleton Signed-off-by: Richard Purdie --- documentation/poky-ref-manual/ref-variables.xml | 52 ++++++++++++++++++++----- 1 file changed, 43 insertions(+), 9 deletions(-) (limited to 'documentation') diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml index 34ce56a080..b87ee42fe9 100644 --- a/documentation/poky-ref-manual/ref-variables.xml +++ b/documentation/poky-ref-manual/ref-variables.xml @@ -74,9 +74,10 @@ BBFILE_COLLECTIONS - Identifies layer-specific .bbfiles, which contain recipes - used by BitBake to build software. - The variable is appended with a layer name. + Lists the names of configured layers. These names are used to find the other BBFILE_* + variables. Typically each layer will append its name to this variable in its + conf/layer.conf file. + @@ -84,14 +85,14 @@ Variable that expands to match files from BBFILES in a particular layer. This variable is used in the conf/layer.conf file and must - contain the name of the - specific layer (e.g. BBFILE_PATTERN_emenlow). + be suffixed with the name of the specific layer (e.g. + BBFILE_PATTERN_emenlow). BBFILE_PRIORITY - Assigns different priorities to recipe files in different layers. + Assigns the priority for recipe files in each layer. This variable is useful in situations where the same package appears in more than one layer. Setting this variable allows you to prioritize a @@ -104,14 +105,22 @@ lower precedence. A larger value for the BBFILE_PRIORITY variable results in a higher precedence. - For example, the value 6 has a higher precedence than the value 5. - By default, the BBFILE_PRIORITY variable is set to "5". + For example, the value 6 has a higher precedence than the + value 5. + If not specified, the BBFILE_PRIORITY variable is set based on layer + dependencies (see LAYERDEPENDS below). Tdefault priority if unspecified + for a layer with no dependencies is the lowest defined priority + 1 + (or 1 if no priorities are defined). + + You can use the command "bitbake-layers show_layers" to list + all configured layers along with their priorities. + BBFILES - List of recipes used by BitBake to build software + List of recipe files used by BitBake to build software @@ -540,6 +549,20 @@ L + LAYERDEPENDS + + Lists the layers that this recipe depends upon, separated by spaces. + Optionally a specific layer version may be specified for a dependency + by adding it to the end of the layer name with a colon, e.g. "anotherlayer:3" + (to be compared against LAYERVERSION_anotherlayer in this example). + An error will be produced if any dependency is missing or + the version numbers do not match exactly (if specified). + This variable is used in the conf/layer.conf file + and must be suffixed with the name of the specific layer (e.g. + LAYERDEPENDS_mylayer). + + + LAYERDIR When used inside the layer.conf configuration @@ -551,6 +574,17 @@ + LAYERVERSION + + Optionally specifies the version of a layer as a single number. + This may be used within LAYERDEPENDS for another layer in order to + depend on a specific version of the layer. + This variable is used in the conf/layer.conf file + and must be suffixed with the name of the specific layer (e.g. + LAYERVERSION_mylayer). + + + LICENSE The list of package source licenses. -- cgit v1.2.3-54-g00ecf