summaryrefslogtreecommitdiffstats
path: root/documentation/poky-ref-manual/ref-variables.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/poky-ref-manual/ref-variables.xml')
-rw-r--r--documentation/poky-ref-manual/ref-variables.xml33
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"
1605 </glossdef> 1605 </glossdef>
1606 </glossentry> 1606 </glossentry>
1607 1607
1608 <glossentry id='var-PACKAGECONFIG'><glossterm>PACKAGECONFIG</glossterm>
1609 <glossdef>
1610 <para>
1611 This variable provides a means of enabling or disabling features of a recipe
1612 on a per-recipe basis.
1613 The <filename>PACKAGECONFIG</filename>
1614 variable itself specifies a space-separated list of the features
1615 to enable, while the named flags set on the variable specify
1616 for each feature the additional build dependencies
1617 (<filename><link linkend='var-DEPENDS'>DEPENDS</link></filename>)
1618 that should be added if the feature is enabled, and any extra arguments
1619 that should be added to the configure script argument list
1620 (<filename><link linkend='var-EXTRA_OECONF'>EXTRA_OECONF</link></filename>)
1621 if the feature is enabled or disabled.
1622 </para>
1623 <para>
1624 For example, the following taken from the <filename>librsvg</filename>
1625 recipe will add <filename>--with-croco</filename> to the
1626 configure script arguments and <filename>libcroco</filename> to
1627 <filename><link linkend='var-DEPENDS'>DEPENDS</link></filename>
1628 by default.
1629 However, if "croco" is removed from <filename>PACKAGECONFIG</filename>
1630 (for example, by using a <filename>.bbappend</filename> file in another layer), then
1631 <filename>--without-croco</filename> will be added to the configure
1632 script arguments instead:
1633 <literallayout class='monospaced'>
1634 PACKAGECONFIG ??= "croco"
1635 PACKAGECONFIG[croco] = "--with-croco,--without-croco,libcroco"
1636 </literallayout>
1637 </para>
1638 </glossdef>
1639 </glossentry>
1640
1608 <glossentry id='var-PACKAGES'><glossterm>PACKAGES</glossterm> 1641 <glossentry id='var-PACKAGES'><glossterm>PACKAGES</glossterm>
1609 <glossdef> 1642 <glossdef>
1610 <para>The list of packages to be created from the recipe. 1643 <para>The list of packages to be created from the recipe.