[2/3] docs: dev-manual-common-tasks: remove paragraph about race when missing DEPENDS

Submitted by Quentin Schulz on Oct. 18, 2020, 5:57 p.m. | Patch ID: 177582


Message ID 20201018175712.23800-2-foss@0leil.net
State New
Headers show

Commit Message

Quentin Schulz Oct. 18, 2020, 5:57 p.m.
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.

Signed-off-by: Quentin Schulz <foss@0leil.net>

 .../dev-manual/dev-manual-common-tasks.rst    | 23 ++++++-------------
 1 file changed, 7 insertions(+), 16 deletions(-)

Links: You receive all messages sent to this group.
View/Reply Online (#466): https://lists.yoctoproject.org/g/docs/message/466
Mute This Topic: https://lists.yoctoproject.org/mt/77641251/1003190
Group Owner: docs+owner@lists.yoctoproject.org
Unsubscribe: https://lists.yoctoproject.org/g/docs/unsub [mhalstead@linuxfoundation.org]

Patch hide | download patch | download mbox

diff --git a/documentation/dev-manual/dev-manual-common-tasks.rst b/documentation/dev-manual/dev-manual-common-tasks.rst
index 0df5e1e4c..75ef5c98c 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.rst
+++ b/documentation/dev-manual/dev-manual-common-tasks.rst
@@ -1612,25 +1612,16 @@  Within a recipe, you specify build-time dependencies using the
 :term:`DEPENDS` variable. Although
 nuances exist, items specified in ``DEPENDS`` should be names of other
 recipes. It is important that you specify all build-time dependencies
-explicitly. If you do not, due to the parallel nature of BitBake's
-execution, you can end up with a race condition where the dependency is
-present for one task of a recipe (e.g.
-:ref:`ref-tasks-configure`) and
-then gone when the next task runs (e.g.
 Another consideration is that configure scripts might automatically
 check for optional dependencies and enable corresponding functionality
-if those dependencies are found. This behavior means that to ensure
-deterministic results and thus avoid more race conditions, you need to
-either explicitly specify these dependencies as well, or tell the
-configure script explicitly to disable the functionality. If you wish to
-make a recipe that is more generally useful (e.g. publish the recipe in
-a layer for others to use), instead of hard-disabling the functionality,
-you can use the
-:term:`PACKAGECONFIG` variable
-to allow functionality and the corresponding dependencies to be enabled
-and disabled easily by other users of the recipe.
+if those dependencies are found. If you wish to make a recipe that is
+more generally useful (e.g. publish the recipe in a layer for others to
+use), instead of hard-disabling the functionality, you can use the
+:term:`PACKAGECONFIG` variable to allow functionality and the
+corresponding dependencies to be enabled and disabled easily by other
+users of the recipe.
 Similar to build-time dependencies, you specify runtime dependencies
 through a variable -