From 84251f8d24034163ec785d0f5715634b90f2c1bf Mon Sep 17 00:00:00 2001 From: Michael Opdenacker Date: Fri, 23 Sep 2022 17:11:53 +0200 Subject: manuals: add references to the "do_fetch" task [YOCTO #14508] (From yocto-docs rev: 17f2041647010d885f18f889c740588586c60d3a) Signed-off-by: Michael Opdenacker Reported-by: Quentin Schulz Signed-off-by: Richard Purdie --- documentation/dev-manual/common-tasks.rst | 2 +- documentation/migration-guides/migration-3.2.rst | 2 +- documentation/migration-guides/migration-4.0.rst | 4 ++-- documentation/overview-manual/concepts.rst | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/documentation/dev-manual/common-tasks.rst b/documentation/dev-manual/common-tasks.rst index 883a1adea7..3d96399047 100644 --- a/documentation/dev-manual/common-tasks.rst +++ b/documentation/dev-manual/common-tasks.rst @@ -9593,7 +9593,7 @@ Running Specific Tasks ---------------------- Any given recipe consists of a set of tasks. The standard BitBake -behavior in most cases is: ``do_fetch``, ``do_unpack``, ``do_patch``, +behavior in most cases is: :ref:`ref-tasks-fetch`, ``do_unpack``, ``do_patch``, ``do_configure``, ``do_compile``, ``do_install``, ``do_package``, ``do_package_write_*``, and ``do_build``. The default task is ``do_build`` and any tasks on which it depends build first. Some tasks, diff --git a/documentation/migration-guides/migration-3.2.rst b/documentation/migration-guides/migration-3.2.rst index cc6f05322a..a4d0479d92 100644 --- a/documentation/migration-guides/migration-3.2.rst +++ b/documentation/migration-guides/migration-3.2.rst @@ -191,7 +191,7 @@ Globbing no longer supported in ``file://`` entries in ``SRC_URI`` Globbing (``*`` and ``?`` wildcards) in ``file://`` URLs within :term:`SRC_URI` did not properly support file checksums, thus changes to the source files -would not always change the do_fetch task checksum, and consequently would +would not always change the :ref:`ref-tasks-fetch` task checksum, and consequently would not ensure that the changed files would be incorporated in subsequent builds. Unfortunately it is not practical to make globbing work generically here, so diff --git a/documentation/migration-guides/migration-4.0.rst b/documentation/migration-guides/migration-4.0.rst index 79e53f89ac..ce3212a464 100644 --- a/documentation/migration-guides/migration-4.0.rst +++ b/documentation/migration-guides/migration-4.0.rst @@ -93,8 +93,8 @@ Fetching changes do_mytask[network] = "1" - This is allowed by default from ``do_fetch`` but not from any of our other standard - tasks. Recipes shouldn't be accessing the network outside of ``do_fetch`` as it + This is allowed by default from :ref:`ref-tasks-fetch` but not from any of our other standard + tasks. Recipes shouldn't be accessing the network outside of :ref:`ref-tasks-fetch` as it usually undermines fetcher source mirroring, image and licence manifests, software auditing and supply chain security. diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst index 8e0303f0e0..fa060ce0de 100644 --- a/documentation/overview-manual/concepts.rst +++ b/documentation/overview-manual/concepts.rst @@ -1208,7 +1208,7 @@ end result. The build system has knowledge of the relationship between these tasks and other preceding tasks. For example, if BitBake runs ``do_populate_sysroot_setscene`` for something, it does not make sense -to run any of the ``do_fetch``, ``do_unpack``, ``do_patch``, +to run any of the :ref:`ref-tasks-fetch`, ``do_unpack``, ``do_patch``, ``do_configure``, ``do_compile``, and ``do_install`` tasks. However, if ``do_package`` needs to be run, BitBake needs to run those other tasks. -- cgit v1.2.3-54-g00ecf