diff options
author | Paul Eggleton <paul.eggleton@linux.intel.com> | 2012-10-10 14:24:15 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2012-10-15 14:45:11 +0100 |
commit | c4659cd17ccb25dc72d6d72a80a400db66b81d07 (patch) | |
tree | e50b71212f52844a90e8e95748004e287496eb07 /documentation | |
parent | 56bdedd1da724cae75bec2170b2f88376e7490a3 (diff) | |
download | openembedded-core-contrib-c4659cd17ccb25dc72d6d72a80a400db66b81d07.tar.gz |
documentation: poky-ref-manual - New PACKAGECONFIG glossary entry.
Add a description of the PACKAGECONFIG variable to the variable
glossary.
(From yocto-docs rev: 07d08314d3151de7073567a7800156f69fdb549e)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/poky-ref-manual/ref-variables.xml | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml index 916366e88e..7d60758226 100644 --- a/documentation/poky-ref-manual/ref-variables.xml +++ b/documentation/poky-ref-manual/ref-variables.xml @@ -1605,6 +1605,39 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" </glossdef> </glossentry> + <glossentry id='var-PACKAGECONFIG'><glossterm>PACKAGECONFIG</glossterm> + <glossdef> + <para> + This variable provides a means of enabling or disabling features of a recipe + on a per-recipe basis. + The <filename>PACKAGECONFIG</filename> + variable itself specifies a space-separated list of the features + to enable, while the named flags set on the variable specify + for each feature the additional build dependencies + (<filename><link linkend='var-DEPENDS'>DEPENDS</link></filename>) + that should be added if the feature is enabled, and any extra arguments + that should be added to the configure script argument list + (<filename><link linkend='var-EXTRA_OECONF'>EXTRA_OECONF</link></filename>) + if the feature is enabled or disabled. + </para> + <para> + For example, the following taken from the <filename>librsvg</filename> + recipe will add <filename>--with-croco</filename> to the + configure script arguments and <filename>libcroco</filename> to + <filename><link linkend='var-DEPENDS'>DEPENDS</link></filename> + by default. + However, if "croco" is removed from <filename>PACKAGECONFIG</filename> + (for example, by using a <filename>.bbappend</filename> file in another layer), then + <filename>--without-croco</filename> will be added to the configure + script arguments instead: + <literallayout class='monospaced'> + PACKAGECONFIG ??= "croco" + PACKAGECONFIG[croco] = "--with-croco,--without-croco,libcroco" + </literallayout> + </para> + </glossdef> + </glossentry> + <glossentry id='var-PACKAGES'><glossterm>PACKAGES</glossterm> <glossdef> <para>The list of packages to be created from the recipe. |