diff options
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/dev-manual/common-tasks.rst | 6 | ||||
-rw-r--r-- | documentation/migration-guides/migration-1.8.rst | 2 | ||||
-rw-r--r-- | documentation/migration-guides/migration-2.1.rst | 4 | ||||
-rw-r--r-- | documentation/migration-guides/migration-2.6.rst | 2 | ||||
-rw-r--r-- | documentation/overview-manual/concepts.rst | 2 | ||||
-rw-r--r-- | documentation/ref-manual/tasks.rst | 2 | ||||
-rw-r--r-- | documentation/ref-manual/variables.rst | 4 |
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. | |||
2881 | If you are creating a new kernel recipe, normal recipe-writing rules | 2881 | If you are creating a new kernel recipe, normal recipe-writing rules |
2882 | apply for setting up a :term:`SRC_URI`. Thus, you need to specify any | 2882 | apply for setting up a :term:`SRC_URI`. Thus, you need to specify any |
2883 | necessary patches and set :term:`S` to point at the source code. You need to | 2883 | necessary patches and set :term:`S` to point at the source code. You need to |
2884 | create a ``do_configure`` task that configures the unpacked kernel with | 2884 | create a :ref:`ref-tasks-configure` task that configures the unpacked kernel with |
2885 | a ``defconfig`` file. You can do this by using a ``make defconfig`` | 2885 | a ``defconfig`` file. You can do this by using a ``make defconfig`` |
2886 | command or, more commonly, by copying in a suitable ``defconfig`` file | 2886 | command or, more commonly, by copying in a suitable ``defconfig`` file |
2887 | and then running ``make oldconfig``. By making use of ``inherit kernel`` | 2887 | and then running ``make oldconfig``. By making use of ``inherit kernel`` |
@@ -9594,7 +9594,7 @@ Running Specific Tasks | |||
9594 | 9594 | ||
9595 | Any given recipe consists of a set of tasks. The standard BitBake | 9595 | Any given recipe consists of a set of tasks. The standard BitBake |
9596 | behavior in most cases is: :ref:`ref-tasks-fetch`, ``do_unpack``, ``do_patch``, | 9596 | behavior 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, |
9600 | such as ``do_devshell``, are not part of the default build chain. If you | 9600 | such 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 | |||
128 | re-executed. | 128 | re-executed. |
129 | 129 | ||
130 | One of the improvements is to attempt to run "make clean" during the | 130 | One 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 |
132 | do not provide a working clean target within their make files. If you | 132 | do not provide a working clean target within their make files. If you |
133 | have such recipes, you need to set | 133 | have 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 | |||
108 | bypasses the standard :ref:`ref-tasks-configure` task | 108 | bypasses the standard :ref:`ref-tasks-configure` task |
109 | from the :ref:`autotools <ref-classes-autotools>` class and the software the recipe is building | 109 | from the :ref:`autotools <ref-classes-autotools>` class and the software the recipe is building |
110 | uses a very old version of ``autoconf``, the recipe might be incapable | 110 | uses a very old version of ``autoconf``, the recipe might be incapable |
111 | of determining the correct size of ``off_t`` during ``do_configure``. | 111 | of determining the correct size of ``off_t`` during :ref:`ref-tasks-configure`. |
112 | 112 | ||
113 | The best course of action is to patch the software as necessary to allow | 113 | The best course of action is to patch the software as necessary to allow |
114 | the default implementation from the :ref:`autotools <ref-classes-autotools>` class to work such | 114 | the default implementation from the :ref:`autotools <ref-classes-autotools>` class to work such |
115 | that ``autoreconf`` succeeds and produces a working configure script, | 115 | that ``autoreconf`` succeeds and produces a working configure script, |
116 | and to remove the overridden ``do_configure`` task such that the default | 116 | and to remove the overridden :ref:`ref-tasks-configure` task such that the default |
117 | implementation does get used. | 117 | implementation 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 | |||
135 | sysroot negatively affects the ability to reproduce builds. This type of | 135 | sysroot negatively affects the ability to reproduce builds. This type of |
136 | fetching is now explicitly disabled. Consequently, any missing | 136 | fetching is now explicitly disabled. Consequently, any missing |
137 | dependencies in Python recipes that use these classes now result in an | 137 | dependencies in Python recipes that use these classes now result in an |
138 | error during the ``do_configure`` task. | 138 | error 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 | |||
1209 | and other preceding tasks. For example, if BitBake runs | 1209 | and 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 |
1211 | to run any of the :ref:`ref-tasks-fetch`, ``do_unpack``, ``do_patch``, | 1211 | to 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 | ||
1215 | It becomes more complicated if everything can come from an sstate cache | 1215 | It 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 | |||
58 | makefile (``Makefile``, ``makefile``, or ``GNUmakefile``) is found and | 58 | makefile (``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 |
60 | file is found or the :term:`CLEANBROKEN` variable is set to "1", the | 60 | file 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` |