summaryrefslogtreecommitdiffstats
path: root/documentation/overview-manual
diff options
context:
space:
mode:
authorMichael Opdenacker <michael.opdenacker@bootlin.com>2022-09-23 18:04:29 +0200
committerRichard Purdie <richard.purdie@linuxfoundation.org>2022-10-07 10:54:25 +0100
commitb3dc55b0516da0ef9381baa034fa95f77a3c0119 (patch)
treec502144ff8533e1e42d96090e6cf9e3aea78e4ea /documentation/overview-manual
parent3c6b2798a0758c6a12f8ea8f451f3a294263da76 (diff)
downloadpoky-b3dc55b0516da0ef9381baa034fa95f77a3c0119.tar.gz
manuals: add references to the "do_package" task
[YOCTO #14508] Reported-by: Quentin Schulz <foss@0leil.net> (From yocto-docs rev: 179139e6710f6dde0de25200c372705ed8ef13bc) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/overview-manual')
-rw-r--r--documentation/overview-manual/concepts.rst12
1 files changed, 6 insertions, 6 deletions
diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst
index 3bb728f990..bbe0ec345b 100644
--- a/documentation/overview-manual/concepts.rst
+++ b/documentation/overview-manual/concepts.rst
@@ -905,7 +905,7 @@ the analysis and package splitting process use several areas:
905 individual packages. 905 individual packages.
906 906
907- :term:`PKGDESTWORK`: A 907- :term:`PKGDESTWORK`: A
908 temporary work area (i.e. ``pkgdata``) used by the ``do_package`` 908 temporary work area (i.e. ``pkgdata``) used by the :ref:`ref-tasks-package`
909 task to save package metadata. 909 task to save package metadata.
910 910
911- :term:`PKGDEST`: The parent 911- :term:`PKGDEST`: The parent
@@ -1210,13 +1210,13 @@ 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
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:ref:`ref-tasks-configure`, :ref:`ref-tasks-compile`, and :ref:`ref-tasks-install` tasks. However, if 1212:ref:`ref-tasks-configure`, :ref:`ref-tasks-compile`, and :ref:`ref-tasks-install` tasks. However, if
1213``do_package`` needs to be run, BitBake needs to run those other tasks. 1213:ref:`ref-tasks-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
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 ``do_package_write_*`` packages are available
1219from sstate, BitBake does not need the ``do_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
1222is the "setscene" stage. During this stage, BitBake first checks the 1222is the "setscene" stage. During this stage, BitBake first checks the
@@ -1854,7 +1854,7 @@ The following list explains the previous example:
1854 1854
1855 In cases where ``sstate-inputdirs`` and ``sstate-outputdirs`` would be 1855 In cases where ``sstate-inputdirs`` and ``sstate-outputdirs`` would be
1856 the same, you can use ``sstate-plaindirs``. For example, to preserve the 1856 the same, you can use ``sstate-plaindirs``. For example, to preserve the
1857 ${:term:`PKGD`} and ${:term:`PKGDEST`} output from the ``do_package`` 1857 ${:term:`PKGD`} and ${:term:`PKGDEST`} output from the :ref:`ref-tasks-package`
1858 task, use the following:: 1858 task, use the following::
1859 1859
1860 do_package[sstate-plaindirs] = "${PKGD} ${PKGDEST}" 1860 do_package[sstate-plaindirs] = "${PKGD} ${PKGDEST}"
@@ -2101,7 +2101,7 @@ dependencies, you must manually declare the dependencies.
2101 :term:`PRIVATE_LIBS` inside 2101 :term:`PRIVATE_LIBS` inside
2102 the package's recipe. 2102 the package's recipe.
2103 2103
2104- ``pcdeps``: During the ``do_package`` task of each recipe, all 2104- ``pcdeps``: During the :ref:`ref-tasks-package` task of each recipe, all
2105 pkg-config modules (``*.pc`` files) installed by the recipe are 2105 pkg-config modules (``*.pc`` files) installed by the recipe are
2106 located. For each module, the package that contains the module is 2106 located. For each module, the package that contains the module is
2107 registered as providing the module. The resulting module-to-package 2107 registered as providing the module. The resulting module-to-package
@@ -2147,7 +2147,7 @@ dependencies, you must manually declare the dependencies.
2147 :term:`ALLOW_EMPTY` variable 2147 :term:`ALLOW_EMPTY` variable
2148 for more information. 2148 for more information.
2149 2149
2150The ``do_package`` task depends on the ``do_packagedata`` task of each 2150The :ref:`ref-tasks-package` task depends on the ``do_packagedata`` task of each
2151recipe in :term:`DEPENDS` through use 2151recipe in :term:`DEPENDS` through use
2152of a ``[``\ :ref:`deptask <bitbake:bitbake-user-manual/bitbake-user-manual-metadata:variable flags>`\ ``]`` 2152of a ``[``\ :ref:`deptask <bitbake:bitbake-user-manual/bitbake-user-manual-metadata:variable flags>`\ ``]``
2153declaration, which guarantees that the required 2153declaration, which guarantees that the required