summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/ref-variables.xml
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-04-12 13:27:42 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-04-13 23:57:24 +0100
commitd80e663e209965073ff40fb775246eabc0159a44 (patch)
treef0feb42d23b10bd5da9626ff359598ce80b3a7a5 /documentation/ref-manual/ref-variables.xml
parent1519fcda32bdd2f9b52e68cad500abd55038a9bf (diff)
downloadpoky-d80e663e209965073ff40fb775246eabc0159a44.tar.gz
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 <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual/ref-variables.xml')
-rw-r--r--documentation/ref-manual/ref-variables.xml73
1 files changed, 28 insertions, 45 deletions
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
600 600
601 <glossentry id='var-COMPATIBLE_HOST'><glossterm>COMPATIBLE_HOST</glossterm> 601 <glossentry id='var-COMPATIBLE_HOST'><glossterm>COMPATIBLE_HOST</glossterm>
602 <glossdef> 602 <glossdef>
603 <para>A regular expression matched against 603 <para>A regular expression that resolves to one or more hosts
604 <link linkend="var-HOST_SYS"><filename>HOST_SYS</filename></link> 604 (when the recipe is native) or one or more targets (when
605 that the OpenEmbedded build system evaluates against 605 the recipe is non-native) with which a recipe is compatible.
606 systems with which the recipe works. 606 The regular expression is matched against
607 <link linkend="var-HOST_SYS"><filename>HOST_SYS</filename></link>.
607 You can use the variable to stop recipes from being built 608 You can use the variable to stop recipes from being built
608 for classes of systems with which the recipes are not 609 for classes of systems with which the recipes are not
609 compatible. 610 compatible.
@@ -616,10 +617,10 @@ Core layer for images cannot be removed
616 617
617 <glossentry id='var-COMPATIBLE_MACHINE'><glossterm>COMPATIBLE_MACHINE</glossterm> 618 <glossentry id='var-COMPATIBLE_MACHINE'><glossterm>COMPATIBLE_MACHINE</glossterm>
618 <glossdef> 619 <glossdef>
619 <para>A regular expression matched against 620 <para>A regular expression that resolves to one or more
620 <link linkend="var-MACHINEOVERRIDES"><filename>MACHINEOVERRIDES</filename></link> 621 target machines with which a recipe is compatible.
621 that the OpenEmbedded build system evaluates against 622 The regular expression is matched against
622 machines with which the recipe works. 623 <link linkend="var-MACHINEOVERRIDES"><filename>MACHINEOVERRIDES</filename></link>.
623 You can use the variable to stop recipes from being built 624 You can use the variable to stop recipes from being built
624 for machines with which the recipes are not compatible. 625 for machines with which the recipes are not compatible.
625 Stopping these builds is particularly useful with kernels. 626 Stopping these builds is particularly useful with kernels.
@@ -743,8 +744,6 @@ Core layer for images cannot be removed
743 <glossdef> 744 <glossdef>
744 <para> 745 <para>
745 Specifies a weak bias for recipe selection priority. 746 Specifies a weak bias for recipe selection priority.
746 Use this variable when more than one provider/version
747 satisfies a dependency.
748 </para> 747 </para>
749 <para> 748 <para>
750 The most common usage of this is variable is to set 749 The most common usage of this is variable is to set
@@ -759,7 +758,7 @@ Core layer for images cannot be removed
759 The bias provided by <filename>DEFAULT_PREFERENCE</filename> 758 The bias provided by <filename>DEFAULT_PREFERENCE</filename>
760 is weak and is overridden by 759 is weak and is overridden by
761 <filename><link linkend='var-BBFILE_PRIORITY'>BBFILE_PRIORITY</link></filename> 760 <filename><link linkend='var-BBFILE_PRIORITY'>BBFILE_PRIORITY</link></filename>
762 if the selection priority is different between two layers 761 if the that variable is different between two layers
763 that contain different versions of the same recipe. 762 that contain different versions of the same recipe.
764 </note> 763 </note>
765 </glossdef> 764 </glossdef>
@@ -1279,7 +1278,8 @@ Core layer for images cannot be removed
1279 <glossdef> 1278 <glossdef>
1280 <para> 1279 <para>
1281 Specifies the system, including the architecture and the 1280 Specifies the system, including the architecture and the
1282 operating system, being built in the context of the current 1281 operating system, for with the build is occurring
1282 in the context of the current
1283 recipe. 1283 recipe.
1284 The OpenEmbedded build system automatically sets this 1284 The OpenEmbedded build system automatically sets this
1285 variable. 1285 variable.
@@ -1389,7 +1389,7 @@ Core layer for images cannot be removed
1389 <glossdef> 1389 <glossdef>
1390 <para> 1390 <para>
1391 Specifies the list of locales to install into the image 1391 Specifies the list of locales to install into the image
1392 during the packaging process. 1392 during the root filesystem construction process.
1393 The OpenEmbedded build system automatically splits locale 1393 The OpenEmbedded build system automatically splits locale
1394 files, which are used for localization, into separate 1394 files, which are used for localization, into separate
1395 packages. 1395 packages.
@@ -1648,8 +1648,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
1648 For example, to skip the check for symbolic link 1648 For example, to skip the check for symbolic link
1649 <filename>.so</filename> files in the main package of a 1649 <filename>.so</filename> files in the main package of a
1650 recipe, add the following to the recipe. 1650 recipe, add the following to the recipe.
1651 In this example, the package name override 1651 The package name override must be used, which in this
1652 <filename>${PN}</filename> must be used: 1652 example is <filename>${PN}</filename>:
1653 <literallayout class='monospaced'> 1653 <literallayout class='monospaced'>
1654 INSANE_SKIP_${PN} += "dev-so" 1654 INSANE_SKIP_${PN} += "dev-so"
1655 </literallayout> 1655 </literallayout>
@@ -3158,8 +3158,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
3158 <glossentry id='var-RSUGGESTS'><glossterm>RSUGGESTS</glossterm> 3158 <glossentry id='var-RSUGGESTS'><glossterm>RSUGGESTS</glossterm>
3159 <glossdef> 3159 <glossdef>
3160 <para> 3160 <para>
3161 A list of additional packages that you can suggest the 3161 A list of additional packages that you can suggest for
3162 package manager installs. 3162 installation by the package manager at the time a package
3163 is installed.
3163 Not all package managers support this functionality. 3164 Not all package managers support this functionality.
3164 </para> 3165 </para>
3165 <para> 3166 <para>
@@ -3214,7 +3215,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
3214 Identifiers consist of the host distributor ID 3215 Identifiers consist of the host distributor ID
3215 followed by the release, 3216 followed by the release,
3216 as reported by the <filename>lsb_release</filename> tool 3217 as reported by the <filename>lsb_release</filename> tool
3217 or as read from <filename>/etc/lsb-release</filename>.) 3218 or as read from <filename>/etc/lsb-release</filename>.
3218 Separate the list items with explicit newline 3219 Separate the list items with explicit newline
3219 characters (<filename>\n</filename>). 3220 characters (<filename>\n</filename>).
3220 If <filename>SANITY_TESTED_DISTROS</filename> is not empty 3221 If <filename>SANITY_TESTED_DISTROS</filename> is not empty
@@ -3281,9 +3282,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
3281 thus force rebuilds when the recipe changes. 3282 thus force rebuilds when the recipe changes.
3282 <caution> 3283 <caution>
3283 If you add an inappropriate variable to this list, 3284 If you add an inappropriate variable to this list,
3284 other recipes might break when the interface of the 3285 the software might break at runtime if the
3285 recipe changes after the other recipes have been 3286 interface of the recipe was changed after the other
3286 built. 3287 had been built.
3287 </caution> 3288 </caution>
3288 </para> 3289 </para>
3289 </glossdef> 3290 </glossdef>
@@ -3309,9 +3310,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
3309 recipe changes. 3310 recipe changes.
3310 <caution> 3311 <caution>
3311 If you add an inappropriate dependency for a recipe 3312 If you add an inappropriate dependency for a recipe
3312 relationship, the build might break when the interface 3313 relationship, the software might break during
3313 of the second recipe changes after the first recipe has 3314 runtime if the interface of the second recipe was
3314 been built. 3315 changed after the first recipe had been built.
3315 </caution> 3316 </caution>
3316 </para> 3317 </para>
3317 </glossdef> 3318 </glossdef>
@@ -3387,24 +3388,6 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
3387 which are assumed to be a subdirectories of the directory in which the 3388 which are assumed to be a subdirectories of the directory in which the
3388 recipe file resides: 3389 recipe file resides:
3389 <itemizedlist> 3390 <itemizedlist>
3390 <listitem><para><emphasis><filename>${PN}</filename> -</emphasis> The recipe name
3391 with any special suffix or prefix, if applicable.
3392 For example, using <filename>bash</filename> to build for the native
3393 machine, <filename>PN</filename> is <filename>bash-native</filename>.
3394 Using <filename>bash</filename> to build for the target and for Multilib,
3395 <link linkend='var-PN'><filename>PN</filename></link>
3396 would be <filename>bash</filename> and
3397 <filename>lib64-bash</filename>, respectively.
3398 </para></listitem>
3399 <listitem><para><emphasis><filename>${PF}</filename> - </emphasis>
3400 <filename>${PN}-${EXTENDPE}${<link linkend='var-PV'>PV</link>}-${<link linkend='var-PR'>PR</link>}</filename>.
3401 The recipe name including all version and revision numbers
3402 (i.e. <filename>eglibc-2.13-r20+svnr15508/</filename> and
3403 <filename>bash-4.2-r1/</filename>).</para></listitem>
3404 <listitem><para><emphasis><filename>${P}</filename> -</emphasis>
3405 <filename>${PN}-${PV}</filename>.
3406 The recipe name and version (i.e. <filename>bash-4.2</filename>).
3407 </para></listitem>
3408 <listitem><para><emphasis><filename>${BPN}</filename> -</emphasis> The 3391 <listitem><para><emphasis><filename>${BPN}</filename> -</emphasis> The
3409 base recipe name without any special suffix or version numbers. 3392 base recipe name without any special suffix or version numbers.
3410 </para></listitem> 3393 </para></listitem>
@@ -3683,9 +3666,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
3683 <para> 3666 <para>
3684 A list of functions to execute after files are staged into 3667 A list of functions to execute after files are staged into
3685 the sysroot. 3668 the sysroot.
3686 The OpenEmbedded build system usually uses such functions 3669 These functions are usually used to apply additional
3687 to apply additional processing on the 3670 processing on the staged files, or to stage additional
3688 staged files, or to stage additional files. 3671 files.
3689 </para> 3672 </para>
3690 </glossdef> 3673 </glossdef>
3691 </glossentry> 3674 </glossentry>