summaryrefslogtreecommitdiffstats
path: root/documentation/migration-guides
diff options
context:
space:
mode:
authorMichael Opdenacker <michael.opdenacker@bootlin.com>2022-09-23 17:20:26 +0200
committerRichard Purdie <richard.purdie@linuxfoundation.org>2022-10-07 10:54:25 +0100
commit9fece9c36125aeec1ee3b3845fc914ec0dbf3034 (patch)
tree9ee53e939349006219c1b325c5afa395e723dd14 /documentation/migration-guides
parent84251f8d24034163ec785d0f5715634b90f2c1bf (diff)
downloadpoky-9fece9c36125aeec1ee3b3845fc914ec0dbf3034.tar.gz
manuals: add reference to the "do_install" task
[YOCTO #14508] (From yocto-docs rev: 933ad27b81dfc4a28e7c48ca7bb2d1363e8c037f) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reported-by: Quentin Schulz <foss@0leil.net> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/migration-guides')
-rw-r--r--documentation/migration-guides/migration-3.2.rst4
-rw-r--r--documentation/migration-guides/migration-4.0.rst2
2 files changed, 3 insertions, 3 deletions
diff --git a/documentation/migration-guides/migration-3.2.rst b/documentation/migration-guides/migration-3.2.rst
index a4d0479d92..8d251deaf7 100644
--- a/documentation/migration-guides/migration-3.2.rst
+++ b/documentation/migration-guides/migration-3.2.rst
@@ -60,7 +60,7 @@ pseudo as the interprocess round trip to the server is avoided.
60 60
61There is a possible complication where some existing recipe may break, for 61There is a possible complication where some existing recipe may break, for
62example, a recipe was found to be writing to ``${B}/install`` for 62example, a recipe was found to be writing to ``${B}/install`` for
63``make install`` in ``do_install`` and since ``${B}`` is listed as not to be tracked, 63``make install`` in :ref:`ref-tasks-install` and since ``${B}`` is listed as not to be tracked,
64there were errors trying to ``chown root`` for files in this location. Another 64there were errors trying to ``chown root`` for files in this location. Another
65example was the ``tcl`` recipe where the source directory :term:`S` is set to a 65example was the ``tcl`` recipe where the source directory :term:`S` is set to a
66subdirectory of the source tree but files were written out to the directory 66subdirectory of the source tree but files were written out to the directory
@@ -207,7 +207,7 @@ files into a subdirectory and reference that instead.
207deploy class now cleans ``DEPLOYDIR`` before ``do_deploy`` 207deploy class now cleans ``DEPLOYDIR`` before ``do_deploy``
208---------------------------------------------------------- 208----------------------------------------------------------
209 209
210``do_deploy`` as implemented in the :ref:`deploy <ref-classes-deploy>` class now cleans up ${:term:`DEPLOYDIR`} before running, just as ``do_install`` cleans up ${:term:`D`} before running. This reduces the risk of :term:`DEPLOYDIR` being accidentally contaminated by files from previous runs, possibly even with different config, in case of incremental builds. 210``do_deploy`` as implemented in the :ref:`deploy <ref-classes-deploy>` class now cleans up ${:term:`DEPLOYDIR`} before running, just as :ref:`ref-tasks-install` cleans up ${:term:`D`} before running. This reduces the risk of :term:`DEPLOYDIR` being accidentally contaminated by files from previous runs, possibly even with different config, in case of incremental builds.
211 211
212Most recipes and classes that inherit the :ref:`deploy <ref-classes-deploy>` class or interact with ``do_deploy`` are unlikely to be affected by this unless they add ``prefuncs`` to ``do_deploy`` *which also* put files into ``${DEPLOYDIR}`` --- these should be refactored to use ``do_deploy_prepend`` instead. 212Most recipes and classes that inherit the :ref:`deploy <ref-classes-deploy>` class or interact with ``do_deploy`` are unlikely to be affected by this unless they add ``prefuncs`` to ``do_deploy`` *which also* put files into ``${DEPLOYDIR}`` --- these should be refactored to use ``do_deploy_prepend`` instead.
213 213
diff --git a/documentation/migration-guides/migration-4.0.rst b/documentation/migration-guides/migration-4.0.rst
index ce3212a464..02d3c3e2bd 100644
--- a/documentation/migration-guides/migration-4.0.rst
+++ b/documentation/migration-guides/migration-4.0.rst
@@ -145,7 +145,7 @@ Python changes
145 :ref:`python_setuptools_build_meta <ref-classes-python_setuptools_build_meta>` 145 :ref:`python_setuptools_build_meta <ref-classes-python_setuptools_build_meta>`
146 and :ref:`python_poetry_core <ref-classes-python_poetry_core>`. 146 and :ref:`python_poetry_core <ref-classes-python_poetry_core>`.
147 147
148- The :ref:`setuptools3 <ref-classes-setuptools3>` class ``do_install()`` task now 148- The :ref:`setuptools3 <ref-classes-setuptools3>` class :ref:`ref-tasks-install` task now
149 installs the ``wheel`` binary archive. In current versions of ``setuptools`` the 149 installs the ``wheel`` binary archive. In current versions of ``setuptools`` the
150 legacy ``setup.py install`` method is deprecated. If the ``setup.py`` cannot be used 150 legacy ``setup.py install`` method is deprecated. If the ``setup.py`` cannot be used
151 with wheels, for example it creates files outside of the Python module or standard 151 with wheels, for example it creates files outside of the Python module or standard