summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorQuentin Schulz <foss@0leil.net>2020-10-18 19:57:11 +0200
committerRichard Purdie <richard.purdie@linuxfoundation.org>2020-10-20 11:12:06 +0100
commit5a154344cbb11dbe4befd0b997d00622df41eb5d (patch)
tree0d7c916d428ffcbd0824d766c03bde972ddd2c1b
parent9f8e2c0ea6a0f9de538a46ebbd94df609bee0dda (diff)
downloadpoky-5a154344cbb11dbe4befd0b997d00622df41eb5d.tar.gz
docs: dev-manual-common-tasks: remove paragraph about race when missing DEPENDS
Missing DEPENDS were an issue before rocko (2.4) because of a shared global sysroot. Since then, every recipe has its own sysroot, it is not possible to build successfully a recipe without all DEPENDS. Therefore, races in tasks possibly triggered by missing DEPENDS are a thing of the past. This paragraph is misleading and can be safely removed. (From yocto-docs rev: 9aec42794846a4bca37b49a9f920fa2887974ddf) Signed-off-by: Quentin Schulz <foss@0leil.net> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.rst23
1 files changed, 7 insertions, 16 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.rst b/documentation/dev-manual/dev-manual-common-tasks.rst
index 943180296c..7cb25c02cd 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.rst
+++ b/documentation/dev-manual/dev-manual-common-tasks.rst
@@ -1611,25 +1611,16 @@ Within a recipe, you specify build-time dependencies using the
1611:term:`DEPENDS` variable. Although 1611:term:`DEPENDS` variable. Although
1612nuances exist, items specified in ``DEPENDS`` should be names of other 1612nuances exist, items specified in ``DEPENDS`` should be names of other
1613recipes. It is important that you specify all build-time dependencies 1613recipes. It is important that you specify all build-time dependencies
1614explicitly. If you do not, due to the parallel nature of BitBake's 1614explicitly.
1615execution, you can end up with a race condition where the dependency is
1616present for one task of a recipe (e.g.
1617:ref:`ref-tasks-configure`) and
1618then gone when the next task runs (e.g.
1619:ref:`ref-tasks-compile`).
1620 1615
1621Another consideration is that configure scripts might automatically 1616Another consideration is that configure scripts might automatically
1622check for optional dependencies and enable corresponding functionality 1617check for optional dependencies and enable corresponding functionality
1623if those dependencies are found. This behavior means that to ensure 1618if those dependencies are found. If you wish to make a recipe that is
1624deterministic results and thus avoid more race conditions, you need to 1619more generally useful (e.g. publish the recipe in a layer for others to
1625either explicitly specify these dependencies as well, or tell the 1620use), instead of hard-disabling the functionality, you can use the
1626configure script explicitly to disable the functionality. If you wish to 1621:term:`PACKAGECONFIG` variable to allow functionality and the
1627make a recipe that is more generally useful (e.g. publish the recipe in 1622corresponding dependencies to be enabled and disabled easily by other
1628a layer for others to use), instead of hard-disabling the functionality, 1623users of the recipe.
1629you can use the
1630:term:`PACKAGECONFIG` variable
1631to allow functionality and the corresponding dependencies to be enabled
1632and disabled easily by other users of the recipe.
1633 1624
1634Similar to build-time dependencies, you specify runtime dependencies 1625Similar to build-time dependencies, you specify runtime dependencies
1635through a variable - 1626through a variable -