summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentation/dev-manual/common-tasks.rst6
-rw-r--r--documentation/migration-guides/migration-1.8.rst2
-rw-r--r--documentation/migration-guides/migration-2.1.rst4
-rw-r--r--documentation/migration-guides/migration-2.6.rst2
-rw-r--r--documentation/overview-manual/concepts.rst2
-rw-r--r--documentation/ref-manual/tasks.rst2
-rw-r--r--documentation/ref-manual/variables.rst4
7 files changed, 11 insertions, 11 deletions
diff --git a/documentation/dev-manual/common-tasks.rst b/documentation/dev-manual/common-tasks.rst
index 2ae7874513..9950ad364c 100644
--- a/documentation/dev-manual/common-tasks.rst
+++ b/documentation/dev-manual/common-tasks.rst
@@ -2551,7 +2551,7 @@ doing the following:
2551 ``${``\ :term:`S`\ ``}``. 2551 ``${``\ :term:`S`\ ``}``.
2552 2552
2553 If ``${S}`` might contain a Makefile, or if you inherit some class 2553 If ``${S}`` might contain a Makefile, or if you inherit some class
2554 that replaces ``do_configure`` and ``do_compile`` with custom 2554 that replaces :ref:`ref-tasks-configure` and ``do_compile`` with custom
2555 versions, then you can use the 2555 versions, then you can use the
2556 ``[``\ :ref:`noexec <bitbake-user-manual/bitbake-user-manual-metadata:variable flags>`\ ``]`` 2556 ``[``\ :ref:`noexec <bitbake-user-manual/bitbake-user-manual-metadata:variable flags>`\ ``]``
2557 flag to turn the tasks into no-ops, as follows:: 2557 flag to turn the tasks into no-ops, as follows::
@@ -2881,7 +2881,7 @@ you can use as references.
2881If you are creating a new kernel recipe, normal recipe-writing rules 2881If you are creating a new kernel recipe, normal recipe-writing rules
2882apply for setting up a :term:`SRC_URI`. Thus, you need to specify any 2882apply for setting up a :term:`SRC_URI`. Thus, you need to specify any
2883necessary patches and set :term:`S` to point at the source code. You need to 2883necessary patches and set :term:`S` to point at the source code. You need to
2884create a ``do_configure`` task that configures the unpacked kernel with 2884create a :ref:`ref-tasks-configure` task that configures the unpacked kernel with
2885a ``defconfig`` file. You can do this by using a ``make defconfig`` 2885a ``defconfig`` file. You can do this by using a ``make defconfig``
2886command or, more commonly, by copying in a suitable ``defconfig`` file 2886command or, more commonly, by copying in a suitable ``defconfig`` file
2887and then running ``make oldconfig``. By making use of ``inherit kernel`` 2887and then running ``make oldconfig``. By making use of ``inherit kernel``
@@ -9594,7 +9594,7 @@ Running Specific Tasks
9594 9594
9595Any given recipe consists of a set of tasks. The standard BitBake 9595Any given recipe consists of a set of tasks. The standard BitBake
9596behavior in most cases is: :ref:`ref-tasks-fetch`, ``do_unpack``, ``do_patch``, 9596behavior in most cases is: :ref:`ref-tasks-fetch`, ``do_unpack``, ``do_patch``,
9597``do_configure``, ``do_compile``, :ref:`ref-tasks-install`, ``do_package``, 9597:ref:`ref-tasks-configure`, ``do_compile``, :ref:`ref-tasks-install`, ``do_package``,
9598``do_package_write_*``, and :ref:`ref-tasks-build`. The default task is 9598``do_package_write_*``, and :ref:`ref-tasks-build`. The default task is
9599:ref:`ref-tasks-build` and any tasks on which it depends build first. Some tasks, 9599:ref:`ref-tasks-build` and any tasks on which it depends build first. Some tasks,
9600such as ``do_devshell``, are not part of the default build chain. If you 9600such as ``do_devshell``, are not part of the default build chain. If you
diff --git a/documentation/migration-guides/migration-1.8.rst b/documentation/migration-guides/migration-1.8.rst
index 51a13873e2..546c798196 100644
--- a/documentation/migration-guides/migration-1.8.rst
+++ b/documentation/migration-guides/migration-1.8.rst
@@ -128,7 +128,7 @@ when the :ref:`ref-tasks-configure` task needs to be
128re-executed. 128re-executed.
129 129
130One of the improvements is to attempt to run "make clean" during the 130One of the improvements is to attempt to run "make clean" during the
131``do_configure`` task if a ``Makefile`` exists. Some software packages 131:ref:`ref-tasks-configure` task if a ``Makefile`` exists. Some software packages
132do not provide a working clean target within their make files. If you 132do not provide a working clean target within their make files. If you
133have such recipes, you need to set 133have such recipes, you need to set
134:term:`CLEANBROKEN` to "1" within the recipe, for example:: 134:term:`CLEANBROKEN` to "1" within the recipe, for example::
diff --git a/documentation/migration-guides/migration-2.1.rst b/documentation/migration-guides/migration-2.1.rst
index b2d8a0b678..bfc600ccca 100644
--- a/documentation/migration-guides/migration-2.1.rst
+++ b/documentation/migration-guides/migration-2.1.rst
@@ -108,12 +108,12 @@ this change should not be a problem. However, if you have a recipe that
108bypasses the standard :ref:`ref-tasks-configure` task 108bypasses the standard :ref:`ref-tasks-configure` task
109from the :ref:`autotools <ref-classes-autotools>` class and the software the recipe is building 109from the :ref:`autotools <ref-classes-autotools>` class and the software the recipe is building
110uses a very old version of ``autoconf``, the recipe might be incapable 110uses a very old version of ``autoconf``, the recipe might be incapable
111of determining the correct size of ``off_t`` during ``do_configure``. 111of determining the correct size of ``off_t`` during :ref:`ref-tasks-configure`.
112 112
113The best course of action is to patch the software as necessary to allow 113The best course of action is to patch the software as necessary to allow
114the default implementation from the :ref:`autotools <ref-classes-autotools>` class to work such 114the default implementation from the :ref:`autotools <ref-classes-autotools>` class to work such
115that ``autoreconf`` succeeds and produces a working configure script, 115that ``autoreconf`` succeeds and produces a working configure script,
116and to remove the overridden ``do_configure`` task such that the default 116and to remove the overridden :ref:`ref-tasks-configure` task such that the default
117implementation does get used. 117implementation does get used.
118 118
119.. _migration-2.1-image-generation-split-out-from-filesystem-generation: 119.. _migration-2.1-image-generation-split-out-from-filesystem-generation:
diff --git a/documentation/migration-guides/migration-2.6.rst b/documentation/migration-guides/migration-2.6.rst
index 11e659de7c..32bb48bccc 100644
--- a/documentation/migration-guides/migration-2.6.rst
+++ b/documentation/migration-guides/migration-2.6.rst
@@ -135,7 +135,7 @@ Fetching these types of dependencies that are not provided in the
135sysroot negatively affects the ability to reproduce builds. This type of 135sysroot negatively affects the ability to reproduce builds. This type of
136fetching is now explicitly disabled. Consequently, any missing 136fetching is now explicitly disabled. Consequently, any missing
137dependencies in Python recipes that use these classes now result in an 137dependencies in Python recipes that use these classes now result in an
138error during the ``do_configure`` task. 138error during the :ref:`ref-tasks-configure` task.
139 139
140.. _migration-2.6-linux-yocto-configuration-audit-issues-now-correctly-reported: 140.. _migration-2.6-linux-yocto-configuration-audit-issues-now-correctly-reported:
141 141
diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst
index 2e1aa3df48..858118beec 100644
--- a/documentation/overview-manual/concepts.rst
+++ b/documentation/overview-manual/concepts.rst
@@ -1209,7 +1209,7 @@ The build system has knowledge of the relationship between these tasks
1209and other preceding tasks. For example, if BitBake runs 1209and other preceding tasks. For example, if BitBake runs
1210``do_populate_sysroot_setscene`` for something, it does not make sense 1210``do_populate_sysroot_setscene`` for something, it does not make sense
1211to run any of the :ref:`ref-tasks-fetch`, ``do_unpack``, ``do_patch``, 1211to run any of the :ref:`ref-tasks-fetch`, ``do_unpack``, ``do_patch``,
1212``do_configure``, ``do_compile``, and :ref:`ref-tasks-install` tasks. However, if 1212:ref:`ref-tasks-configure`, ``do_compile``, and :ref:`ref-tasks-install` tasks. However, if
1213``do_package`` needs to be run, BitBake needs to run those other tasks. 1213``do_package`` needs to be run, BitBake needs to run those other tasks.
1214 1214
1215It becomes more complicated if everything can come from an sstate cache 1215It becomes more complicated if everything can come from an sstate cache
diff --git a/documentation/ref-manual/tasks.rst b/documentation/ref-manual/tasks.rst
index 24203fcf78..35f6a1d349 100644
--- a/documentation/ref-manual/tasks.rst
+++ b/documentation/ref-manual/tasks.rst
@@ -58,7 +58,7 @@ The default behavior of this task is to run ``oe_runmake clean`` if a
58makefile (``Makefile``, ``makefile``, or ``GNUmakefile``) is found and 58makefile (``Makefile``, ``makefile``, or ``GNUmakefile``) is found and
59:term:`CLEANBROKEN` is not set to "1". If no such 59:term:`CLEANBROKEN` is not set to "1". If no such
60file is found or the :term:`CLEANBROKEN` variable is set to "1", the 60file is found or the :term:`CLEANBROKEN` variable is set to "1", the
61``do_configure`` task does nothing. 61:ref:`ref-tasks-configure` task does nothing.
62 62
63.. _ref-tasks-configure_ptest_base: 63.. _ref-tasks-configure_ptest_base:
64 64
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 1582664e62..16eeb7346e 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -1620,7 +1620,7 @@ system and gives an overview of their function and contents.
1620 the appropriate staging sysroot, given by the 1620 the appropriate staging sysroot, given by the
1621 :term:`STAGING_DIR* <STAGING_DIR>` variables, by the time the 1621 :term:`STAGING_DIR* <STAGING_DIR>` variables, by the time the
1622 :ref:`ref-tasks-configure` task for ``foo`` runs. 1622 :ref:`ref-tasks-configure` task for ``foo`` runs.
1623 This mechanism is implemented by having ``do_configure`` depend on 1623 This mechanism is implemented by having :ref:`ref-tasks-configure` depend on
1624 the :ref:`ref-tasks-populate_sysroot` task of 1624 the :ref:`ref-tasks-populate_sysroot` task of
1625 each recipe listed in :term:`DEPENDS`, through a 1625 each recipe listed in :term:`DEPENDS`, through a
1626 ``[``\ :ref:`deptask <bitbake:bitbake-user-manual/bitbake-user-manual-metadata:variable flags>`\ ``]`` 1626 ``[``\ :ref:`deptask <bitbake:bitbake-user-manual/bitbake-user-manual-metadata:variable flags>`\ ``]``
@@ -5563,7 +5563,7 @@ system and gives an overview of their function and contents.
5563 :ref:`cmake <ref-classes-cmake>` use :term:`PACKAGECONFIG_CONFARGS` to 5563 :ref:`cmake <ref-classes-cmake>` use :term:`PACKAGECONFIG_CONFARGS` to
5564 pass :term:`PACKAGECONFIG` options to ``configure`` and ``cmake``, 5564 pass :term:`PACKAGECONFIG` options to ``configure`` and ``cmake``,
5565 respectively. If you are using :term:`PACKAGECONFIG` but not a class that 5565 respectively. If you are using :term:`PACKAGECONFIG` but not a class that
5566 handles the ``do_configure`` task, then you need to use 5566 handles the :ref:`ref-tasks-configure` task, then you need to use
5567 :term:`PACKAGECONFIG_CONFARGS` appropriately. 5567 :term:`PACKAGECONFIG_CONFARGS` appropriately.
5568 5568
5569 :term:`PACKAGEGROUP_DISABLE_COMPLEMENTARY` 5569 :term:`PACKAGEGROUP_DISABLE_COMPLEMENTARY`