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.xml32
1 files changed, 32 insertions, 0 deletions
diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 282d9f3090..4e7f85c37d 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -2012,6 +2012,38 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
2012 </glossdef> 2012 </glossdef>
2013 </glossentry> 2013 </glossentry>
2014 2014
2015 <glossentry id='var-PACKAGES_DYNAMIC'><glossterm>PACKAGES_DYNAMIC</glossterm>
2016 <glossdef>
2017 <para>
2018 A promise that your recipe satisfies runtime dependencies
2019 for optional modules that are found in other recipes.
2020 <filename>PACKAGES_DYNAMIC</filename>
2021 does not actually satisfy the dependencies, it only states that
2022 they should be satisfied.
2023 For example, if a hard, runtime dependency
2024 (<filename>RDEPENDS</filename>) of another package is satisfied
2025 at build time through the <filename>PACKAGES_DYNAMIC</filename>
2026 variable, but a package with the module name is never actually
2027 produced, then the other package will be broken.
2028 Thus, if you attempt to include that package in an image,
2029 you will get a dependency failure from the packaging system
2030 during <filename>do_rootfs</filename>.
2031 Typically, if there is a chance that such a situation can
2032 occur and the package that is not created is valid
2033 without the dependency being satisfied, then you should use
2034 <filename>RRECOMMENDS</filename> (a soft runtime dependency)
2035 instead of <filename>RDEPENDS</filename>.
2036 </para>
2037
2038 <para>
2039 For an example of how to use the <filename>PACKAGES_DYNAMIC</filename>
2040 variable when you are splitting packages, see the
2041 "<ulink url='&YOCTO_DOCS_DEV_URL;#handling-optional-module-packaging'>Handling Optional Module Packaging</ulink>" section
2042 in the Yocto Project Development Manual.
2043 </para>
2044 </glossdef>
2045 </glossentry>
2046
2015 <glossentry id='var-PARALLEL_MAKE'><glossterm>PARALLEL_MAKE</glossterm> 2047 <glossentry id='var-PARALLEL_MAKE'><glossterm>PARALLEL_MAKE</glossterm>
2016 <glossdef> 2048 <glossdef>
2017 <para>Specifies extra options that are passed to the <filename>make</filename> command during the 2049 <para>Specifies extra options that are passed to the <filename>make</filename> command during the