diff options
Diffstat (limited to 'documentation/overview-manual/concepts.rst')
-rw-r--r-- | documentation/overview-manual/concepts.rst | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst index 06220401bc..f3f8cbd95c 100644 --- a/documentation/overview-manual/concepts.rst +++ b/documentation/overview-manual/concepts.rst | |||
@@ -1801,14 +1801,14 @@ from the :ref:`deploy <ref-classes-deploy>` class:: | |||
1801 | 1801 | ||
1802 | The following list explains the previous example: | 1802 | The following list explains the previous example: |
1803 | 1803 | ||
1804 | - Adding "do_deploy" to ``SSTATETASKS`` adds some required | 1804 | - Adding ``do_deploy`` to ``SSTATETASKS`` adds some required |
1805 | sstate-related processing, which is implemented in the | 1805 | sstate-related processing, which is implemented in the |
1806 | :ref:`sstate <ref-classes-sstate>` class, to | 1806 | :ref:`sstate <ref-classes-sstate>` class, to |
1807 | before and after the | 1807 | before and after the |
1808 | :ref:`ref-tasks-deploy` task. | 1808 | :ref:`ref-tasks-deploy` task. |
1809 | 1809 | ||
1810 | - The ``do_deploy[sstate-inputdirs] = "${DEPLOYDIR}"`` declares that | 1810 | - The ``do_deploy[sstate-inputdirs] = "${DEPLOYDIR}"`` declares that |
1811 | ``do_deploy`` places its output in ``${DEPLOYDIR}`` when run normally | 1811 | :ref:`ref-tasks-deploy` places its output in ``${DEPLOYDIR}`` when run normally |
1812 | (i.e. when not using the sstate cache). This output becomes the input | 1812 | (i.e. when not using the sstate cache). This output becomes the input |
1813 | to the shared state cache. | 1813 | to the shared state cache. |
1814 | 1814 | ||
@@ -1818,15 +1818,15 @@ The following list explains the previous example: | |||
1818 | 1818 | ||
1819 | .. note:: | 1819 | .. note:: |
1820 | 1820 | ||
1821 | If ``do_deploy`` is not already in the shared state cache or if its input | 1821 | If :ref:`ref-tasks-deploy` is not already in the shared state cache or if its input |
1822 | checksum (signature) has changed from when the output was cached, the task | 1822 | checksum (signature) has changed from when the output was cached, the task |
1823 | runs to populate the shared state cache, after which the contents of the | 1823 | runs to populate the shared state cache, after which the contents of the |
1824 | shared state cache is copied to ${:term:`DEPLOY_DIR_IMAGE`}. If | 1824 | shared state cache is copied to ${:term:`DEPLOY_DIR_IMAGE`}. If |
1825 | ``do_deploy`` is in the shared state cache and its signature indicates | 1825 | :ref:`ref-tasks-deploy` is in the shared state cache and its signature indicates |
1826 | that the cached output is still valid (i.e. if no relevant task inputs | 1826 | that the cached output is still valid (i.e. if no relevant task inputs |
1827 | have changed), then the contents of the shared state cache copies | 1827 | have changed), then the contents of the shared state cache copies |
1828 | directly to ${:term:`DEPLOY_DIR_IMAGE`} by the ``do_deploy_setscene`` task | 1828 | directly to ${:term:`DEPLOY_DIR_IMAGE`} by the ``do_deploy_setscene`` task |
1829 | instead, skipping the ``do_deploy`` task. | 1829 | instead, skipping the :ref:`ref-tasks-deploy` task. |
1830 | 1830 | ||
1831 | - The following task definition is glue logic needed to make the | 1831 | - The following task definition is glue logic needed to make the |
1832 | previous settings effective:: | 1832 | previous settings effective:: |
@@ -1836,16 +1836,16 @@ The following list explains the previous example: | |||
1836 | } | 1836 | } |
1837 | addtask do_deploy_setscene | 1837 | addtask do_deploy_setscene |
1838 | 1838 | ||
1839 | ``sstate_setscene()`` takes the flags above as input and accelerates the ``do_deploy`` task | 1839 | ``sstate_setscene()`` takes the flags above as input and accelerates the :ref:`ref-tasks-deploy` task |
1840 | through the shared state cache if possible. If the task was | 1840 | through the shared state cache if possible. If the task was |
1841 | accelerated, ``sstate_setscene()`` returns True. Otherwise, it | 1841 | accelerated, ``sstate_setscene()`` returns True. Otherwise, it |
1842 | returns False, and the normal ``do_deploy`` task runs. For more | 1842 | returns False, and the normal :ref:`ref-tasks-deploy` task runs. For more |
1843 | information, see the ":ref:`bitbake:bitbake-user-manual/bitbake-user-manual-execution:setscene`" | 1843 | information, see the ":ref:`bitbake:bitbake-user-manual/bitbake-user-manual-execution:setscene`" |
1844 | section in the BitBake User Manual. | 1844 | section in the BitBake User Manual. |
1845 | 1845 | ||
1846 | - The ``do_deploy[dirs] = "${DEPLOYDIR} ${B}"`` line creates | 1846 | - The ``do_deploy[dirs] = "${DEPLOYDIR} ${B}"`` line creates |
1847 | ``${DEPLOYDIR}`` and ``${B}`` before the ``do_deploy`` task runs, and | 1847 | ``${DEPLOYDIR}`` and ``${B}`` before the :ref:`ref-tasks-deploy` task runs, and |
1848 | also sets the current working directory of ``do_deploy`` to ``${B}``. | 1848 | also sets the current working directory of :ref:`ref-tasks-deploy` to ``${B}``. |
1849 | For more information, see the ":ref:`bitbake:bitbake-user-manual/bitbake-user-manual-metadata:variable flags`" | 1849 | For more information, see the ":ref:`bitbake:bitbake-user-manual/bitbake-user-manual-metadata:variable flags`" |
1850 | section in the BitBake | 1850 | section in the BitBake |
1851 | User Manual. | 1851 | User Manual. |