From d80e663e209965073ff40fb775246eabc0159a44 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 12 Apr 2013 13:27:42 -0700 Subject: ref-manual: Review comments applied for patch session Paul Eggleton provided quite a series of patches that I previously applied. These changes represent the edits from an interactive review he conducted with me. The series of changes represents his review for the entire set of changes in the original patch series. (From yocto-docs rev: e26f615a01de2b101e97eb6fd7175b813f74295e) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/ref-manual/migration.xml | 37 +++++++++++---- documentation/ref-manual/ref-classes.xml | 2 +- documentation/ref-manual/ref-variables.xml | 73 ++++++++++++------------------ 3 files changed, 57 insertions(+), 55 deletions(-) (limited to 'documentation/ref-manual') diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml index a0da6b75c7..e1faea0fa9 100644 --- a/documentation/ref-manual/migration.xml +++ b/documentation/ref-manual/migration.xml @@ -351,15 +351,34 @@ Variables - The SANITY_TESTED_DISTROS - variable now uses a - distribution ID, which is composed of the host distributor ID - followed by the release. - Previously, it was composed of the description field. - For example, "Ubuntu 12.10" becomes "Ubuntu-12.10". - You do not need to worry about this change if you are not - specifically setting this variable, or if you are - specifically setting it to "". + The following variables have changed: + + SANITY_TESTED_DISTROS: + This variable now uses a distribution ID, which is composed + of the host distributor ID followed by the release. + Previously, + SANITY_TESTED_DISTROS + was composed of the description field. + For example, "Ubuntu 12.10" becomes "Ubuntu-12.10". + You do not need to worry about this change if you are not + specifically setting this variable, or if you are + specifically setting it to "". + + SRC_URI: + The ${PN}, + ${PF}, + and ${P} + directories have been dropped from the default value of the + FILESPATH + variable, which is used as the search path for finding files + referred to in + SRC_URI. + If you have a recipe that relied upon these directories, + which would be unusual, then you will need to add the + appropriate paths to + FILESEXTRAPATHS. + + diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml index c6453a7be9..69ca78c380 100644 --- a/documentation/ref-manual/ref-classes.xml +++ b/documentation/ref-manual/ref-classes.xml @@ -632,7 +632,7 @@ To exclude some recipes from having their work directories deleted by rm_work, you can add the names of the recipe or recipes you are working on to the RM_WORK_EXCLUDE - variable, which is also found in your local.conf + variable, which can also be set in your local.conf file. Here is an example: diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 3d4a03e6d6..b5f04cbf6c 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -600,10 +600,11 @@ Core layer for images cannot be removed COMPATIBLE_HOST - A regular expression matched against - HOST_SYS - that the OpenEmbedded build system evaluates against - systems with which the recipe works. + A regular expression that resolves to one or more hosts + (when the recipe is native) or one or more targets (when + the recipe is non-native) with which a recipe is compatible. + The regular expression is matched against + HOST_SYS. You can use the variable to stop recipes from being built for classes of systems with which the recipes are not compatible. @@ -616,10 +617,10 @@ Core layer for images cannot be removed COMPATIBLE_MACHINE - A regular expression matched against - MACHINEOVERRIDES - that the OpenEmbedded build system evaluates against - machines with which the recipe works. + A regular expression that resolves to one or more + target machines with which a recipe is compatible. + The regular expression is matched against + MACHINEOVERRIDES. You can use the variable to stop recipes from being built for machines with which the recipes are not compatible. Stopping these builds is particularly useful with kernels. @@ -743,8 +744,6 @@ Core layer for images cannot be removed Specifies a weak bias for recipe selection priority. - Use this variable when more than one provider/version - satisfies a dependency. The most common usage of this is variable is to set @@ -759,7 +758,7 @@ Core layer for images cannot be removed The bias provided by DEFAULT_PREFERENCE is weak and is overridden by BBFILE_PRIORITY - if the selection priority is different between two layers + if the that variable is different between two layers that contain different versions of the same recipe. @@ -1279,7 +1278,8 @@ Core layer for images cannot be removed Specifies the system, including the architecture and the - operating system, being built in the context of the current + operating system, for with the build is occurring + in the context of the current recipe. The OpenEmbedded build system automatically sets this variable. @@ -1389,7 +1389,7 @@ Core layer for images cannot be removed Specifies the list of locales to install into the image - during the packaging process. + during the root filesystem construction process. The OpenEmbedded build system automatically splits locale files, which are used for localization, into separate packages. @@ -1648,8 +1648,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" For example, to skip the check for symbolic link .so files in the main package of a recipe, add the following to the recipe. - In this example, the package name override - ${PN} must be used: + The package name override must be used, which in this + example is ${PN}: INSANE_SKIP_${PN} += "dev-so" @@ -3158,8 +3158,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" RSUGGESTS - A list of additional packages that you can suggest the - package manager installs. + A list of additional packages that you can suggest for + installation by the package manager at the time a package + is installed. Not all package managers support this functionality. @@ -3214,7 +3215,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" Identifiers consist of the host distributor ID followed by the release, as reported by the lsb_release tool - or as read from /etc/lsb-release.) + or as read from /etc/lsb-release. Separate the list items with explicit newline characters (\n). If SANITY_TESTED_DISTROS is not empty @@ -3281,9 +3282,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" thus force rebuilds when the recipe changes. If you add an inappropriate variable to this list, - other recipes might break when the interface of the - recipe changes after the other recipes have been - built. + the software might break at runtime if the + interface of the recipe was changed after the other + had been built. @@ -3309,9 +3310,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" recipe changes. If you add an inappropriate dependency for a recipe - relationship, the build might break when the interface - of the second recipe changes after the first recipe has - been built. + relationship, the software might break during + runtime if the interface of the second recipe was + changed after the first recipe had been built. @@ -3387,24 +3388,6 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" which are assumed to be a subdirectories of the directory in which the recipe file resides: - ${PN} - The recipe name - with any special suffix or prefix, if applicable. - For example, using bash to build for the native - machine, PN is bash-native. - Using bash to build for the target and for Multilib, - PN - would be bash and - lib64-bash, respectively. - - ${PF} - - ${PN}-${EXTENDPE}${PV}-${PR}. - The recipe name including all version and revision numbers - (i.e. eglibc-2.13-r20+svnr15508/ and - bash-4.2-r1/). - ${P} - - ${PN}-${PV}. - The recipe name and version (i.e. bash-4.2). - ${BPN} - The base recipe name without any special suffix or version numbers. @@ -3683,9 +3666,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" A list of functions to execute after files are staged into the sysroot. - The OpenEmbedded build system usually uses such functions - to apply additional processing on the - staged files, or to stage additional files. + These functions are usually used to apply additional + processing on the staged files, or to stage additional + files. -- cgit v1.2.3-54-g00ecf