diff options
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r-- | documentation/dev-manual/common-tasks.rst | 16 |
1 files changed, 8 insertions, 8 deletions
diff --git a/documentation/dev-manual/common-tasks.rst b/documentation/dev-manual/common-tasks.rst index 9950ad364c..7e1cf1dd70 100644 --- a/documentation/dev-manual/common-tasks.rst +++ b/documentation/dev-manual/common-tasks.rst | |||
@@ -1826,8 +1826,8 @@ out-of-tree modules. Your recipe will also need the following:: | |||
1826 | Compilation | 1826 | Compilation |
1827 | ----------- | 1827 | ----------- |
1828 | 1828 | ||
1829 | During a build, the ``do_compile`` task happens after source is fetched, | 1829 | During a build, the :ref:`ref-tasks-compile` task happens after source is fetched, |
1830 | unpacked, and configured. If the recipe passes through ``do_compile`` | 1830 | unpacked, and configured. If the recipe passes through :ref:`ref-tasks-compile` |
1831 | successfully, nothing needs to be done. | 1831 | successfully, nothing needs to be done. |
1832 | 1832 | ||
1833 | However, if the compile step fails, you need to diagnose the failure. | 1833 | However, if the compile step fails, you need to diagnose the failure. |
@@ -2337,7 +2337,7 @@ Single .c File Package (Hello World!) | |||
2337 | Building an application from a single file that is stored locally (e.g. | 2337 | Building an application from a single file that is stored locally (e.g. |
2338 | under ``files``) requires a recipe that has the file listed in the | 2338 | under ``files``) requires a recipe that has the file listed in the |
2339 | :term:`SRC_URI` variable. Additionally, you need to manually write the | 2339 | :term:`SRC_URI` variable. Additionally, you need to manually write the |
2340 | ``do_compile`` and :ref:`ref-tasks-install` tasks. The :term:`S` variable defines the | 2340 | :ref:`ref-tasks-compile` and :ref:`ref-tasks-install` tasks. The :term:`S` variable defines the |
2341 | directory containing the source code, which is set to | 2341 | directory containing the source code, which is set to |
2342 | :term:`WORKDIR` in this case --- the | 2342 | :term:`WORKDIR` in this case --- the |
2343 | directory BitBake uses for the build. | 2343 | directory BitBake uses for the build. |
@@ -2401,7 +2401,7 @@ Makefile-Based Package | |||
2401 | 2401 | ||
2402 | Applications that use GNU ``make`` also require a recipe that has the | 2402 | Applications that use GNU ``make`` also require a recipe that has the |
2403 | source archive listed in :term:`SRC_URI`. You do not need to add a | 2403 | source archive listed in :term:`SRC_URI`. You do not need to add a |
2404 | ``do_compile`` step since by default BitBake starts the ``make`` command | 2404 | :ref:`ref-tasks-compile` step since by default BitBake starts the ``make`` command |
2405 | to compile the application. If you need additional ``make`` options, you | 2405 | to compile the application. If you need additional ``make`` options, you |
2406 | should store them in the | 2406 | should store them in the |
2407 | :term:`EXTRA_OEMAKE` or | 2407 | :term:`EXTRA_OEMAKE` or |
@@ -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 :ref:`ref-tasks-configure` and ``do_compile`` with custom | 2554 | that replaces :ref:`ref-tasks-configure` and :ref:`ref-tasks-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:: |
@@ -3446,7 +3446,7 @@ Follow these general steps: | |||
3446 | you added to the patch. | 3446 | you added to the patch. |
3447 | 3447 | ||
3448 | 6. *Test Your Changes:* Once you have modified the source code, the | 3448 | 6. *Test Your Changes:* Once you have modified the source code, the |
3449 | easiest way to test your changes is by calling the ``do_compile`` | 3449 | easiest way to test your changes is by calling the :ref:`ref-tasks-compile` |
3450 | task as shown in the following example:: | 3450 | task as shown in the following example:: |
3451 | 3451 | ||
3452 | $ bitbake -c compile -f package | 3452 | $ bitbake -c compile -f package |
@@ -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 | :ref:`ref-tasks-configure`, ``do_compile``, :ref:`ref-tasks-install`, ``do_package``, | 9597 | :ref:`ref-tasks-configure`, :ref:`ref-tasks-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 |
@@ -9637,7 +9637,7 @@ The following example shows one way you can use the ``-f`` option:: | |||
9637 | 9637 | ||
9638 | This sequence first builds and then recompiles ``matchbox-desktop``. The | 9638 | This sequence first builds and then recompiles ``matchbox-desktop``. The |
9639 | last command reruns all tasks (basically the packaging tasks) after the | 9639 | last command reruns all tasks (basically the packaging tasks) after the |
9640 | compile. BitBake recognizes that the ``do_compile`` task was rerun and | 9640 | compile. BitBake recognizes that the :ref:`ref-tasks-compile` task was rerun and |
9641 | therefore understands that the other tasks also need to be run again. | 9641 | therefore understands that the other tasks also need to be run again. |
9642 | 9642 | ||
9643 | Another, shorter way to rerun a task and all | 9643 | Another, shorter way to rerun a task and all |