summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael Opdenacker <michael.opdenacker@bootlin.com>2022-09-23 18:21:00 +0200
committerRichard Purdie <richard.purdie@linuxfoundation.org>2022-10-07 10:54:26 +0100
commitec31647110eb96a83a253920cc5d26a164e09b3d (patch)
tree87d679876dd04a905f53e9cf6970f5738d1e63c9
parenta6a7676910669f4bd3a0d4a0ac9a850ea491b7b1 (diff)
downloadpoky-ec31647110eb96a83a253920cc5d26a164e09b3d.tar.gz
manuals: add references to "do_package_write_*" tasks
Using a reference to "do_package_write_deb", the first entry in the list. [YOCTO #14508] Reported-by: Quentin Schulz <foss@0leil.net> (From yocto-docs rev: 237cebcfa6215d75bbe28df677f18ebf7e1bb4f6) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/dev-manual/common-tasks.rst2
-rw-r--r--documentation/overview-manual/concepts.rst4
-rw-r--r--documentation/ref-manual/classes.rst2
-rw-r--r--documentation/ref-manual/tasks.rst2
-rw-r--r--documentation/ref-manual/variables.rst4
5 files changed, 7 insertions, 7 deletions
diff --git a/documentation/dev-manual/common-tasks.rst b/documentation/dev-manual/common-tasks.rst
index 94db146cc2..4249870974 100644
--- a/documentation/dev-manual/common-tasks.rst
+++ b/documentation/dev-manual/common-tasks.rst
@@ -9595,7 +9595,7 @@ Running Specific Tasks
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``, :ref:`ref-tasks-patch`, 9596behavior in most cases is: :ref:`ref-tasks-fetch`, ``do_unpack``, :ref:`ref-tasks-patch`,
9597:ref:`ref-tasks-configure`, :ref:`ref-tasks-compile`, :ref:`ref-tasks-install`, :ref:`ref-tasks-package`, 9597:ref:`ref-tasks-configure`, :ref:`ref-tasks-compile`, :ref:`ref-tasks-install`, :ref:`ref-tasks-package`,
9598``do_package_write_*``, and :ref:`ref-tasks-build`. The default task is 9598:ref:`do_package_write_* <ref-tasks-package_write_deb>`, 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
9601wish to run a task that is not part of the default build chain, you can 9601wish to run a task that is not part of the default build chain, you can
diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst
index f1457522da..a477139996 100644
--- a/documentation/overview-manual/concepts.rst
+++ b/documentation/overview-manual/concepts.rst
@@ -1198,7 +1198,7 @@ the work involved would be equal to or greater than the underlying task.
1198 1198
1199In the build system, the common tasks that have setscene variants are 1199In the build system, the common tasks that have setscene variants are
1200:ref:`ref-tasks-package`, 1200:ref:`ref-tasks-package`,
1201``do_package_write_*``, 1201:ref:`do_package_write_* <ref-tasks-package_write_deb>`,
1202:ref:`ref-tasks-deploy`, 1202:ref:`ref-tasks-deploy`,
1203:ref:`ref-tasks-packagedata`, and 1203:ref:`ref-tasks-packagedata`, and
1204:ref:`ref-tasks-populate_sysroot`. 1204:ref:`ref-tasks-populate_sysroot`.
@@ -1215,7 +1215,7 @@ to run any of the :ref:`ref-tasks-fetch`, ``do_unpack``, :ref:`ref-tasks-patch`,
1215It becomes more complicated if everything can come from an sstate cache 1215It becomes more complicated if everything can come from an sstate cache
1216because some objects are simply not required at all. For example, you do 1216because some objects are simply not required at all. For example, you do
1217not need a compiler or native tools, such as quilt, if there isn't anything 1217not need a compiler or native tools, such as quilt, if there isn't anything
1218to compile or patch. If the ``do_package_write_*`` packages are available 1218to compile or patch. If the :ref:`do_package_write_* <ref-tasks-package_write_deb>` packages are available
1219from sstate, BitBake does not need the :ref:`ref-tasks-package` task data. 1219from sstate, BitBake does not need the :ref:`ref-tasks-package` task data.
1220 1220
1221To handle all these complexities, BitBake runs in two phases. The first 1221To handle all these complexities, BitBake runs in two phases. The first
diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index a31e663452..6e2c01589d 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -47,7 +47,7 @@ splitting out of debug symbols during packaging).
47 even if the recipes do not produce architecture-specific output. 47 even if the recipes do not produce architecture-specific output.
48 48
49 Configuring such recipes for all architectures causes the 49 Configuring such recipes for all architectures causes the
50 ``do_package_write_*`` tasks to 50 :ref:`do_package_write_* <ref-tasks-package_write_deb>` tasks to
51 have different signatures for the machines with different tunings. 51 have different signatures for the machines with different tunings.
52 Additionally, unnecessary rebuilds occur every time an image for a 52 Additionally, unnecessary rebuilds occur every time an image for a
53 different :term:`MACHINE` is built even when the recipe never changes. 53 different :term:`MACHINE` is built even when the recipe never changes.
diff --git a/documentation/ref-manual/tasks.rst b/documentation/ref-manual/tasks.rst
index 414c972ad4..1674e3fa8c 100644
--- a/documentation/ref-manual/tasks.rst
+++ b/documentation/ref-manual/tasks.rst
@@ -170,7 +170,7 @@ Copies files that are to be packaged into the holding area
170working directory set to ``${``\ :term:`B`\ ``}``, which is the 170working directory set to ``${``\ :term:`B`\ ``}``, which is the
171compilation directory. The :ref:`ref-tasks-install` task, as well as other tasks 171compilation directory. The :ref:`ref-tasks-install` task, as well as other tasks
172that either directly or indirectly depend on the installed files (e.g. 172that either directly or indirectly depend on the installed files (e.g.
173:ref:`ref-tasks-package`, ``do_package_write_*``, and 173:ref:`ref-tasks-package`, :ref:`do_package_write_* <ref-tasks-package_write_deb>`, and
174:ref:`ref-tasks-rootfs`), run under 174:ref:`ref-tasks-rootfs`), run under
175:ref:`fakeroot <overview-manual/concepts:fakeroot and pseudo>`. 175:ref:`fakeroot <overview-manual/concepts:fakeroot and pseudo>`.
176 176
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index e4c2e8cf53..9cc6cdad2d 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -6242,7 +6242,7 @@ system and gives an overview of their function and contents.
6242 The practical effect of the above :term:`RDEPENDS` assignment is that 6242 The practical effect of the above :term:`RDEPENDS` assignment is that
6243 ``bar`` and ``baz`` will be declared as dependencies inside the 6243 ``bar`` and ``baz`` will be declared as dependencies inside the
6244 package ``foo`` when it is written out by one of the 6244 package ``foo`` when it is written out by one of the
6245 :ref:`do_package_write_\* <ref-tasks-package_write_deb>` tasks. 6245 :ref:`do_package_write_* <ref-tasks-package_write_deb>` tasks.
6246 Exactly how this is done depends on which package format is used, 6246 Exactly how this is done depends on which package format is used,
6247 which is determined by 6247 which is determined by
6248 :term:`PACKAGE_CLASSES`. When the 6248 :term:`PACKAGE_CLASSES`. When the
@@ -6254,7 +6254,7 @@ system and gives an overview of their function and contents.
6254 added. This dependency is from the recipe's 6254 added. This dependency is from the recipe's
6255 :ref:`ref-tasks-build` (not to be confused with 6255 :ref:`ref-tasks-build` (not to be confused with
6256 :ref:`ref-tasks-compile`) task to the 6256 :ref:`ref-tasks-compile`) task to the
6257 ``do_package_write_*`` task of the recipes that build ``bar`` and 6257 :ref:`do_package_write_* <ref-tasks-package_write_deb>` task of the recipes that build ``bar`` and
6258 ``baz``. 6258 ``baz``.
6259 6259
6260 The names of the packages you list within :term:`RDEPENDS` must be the 6260 The names of the packages you list within :term:`RDEPENDS` must be the