diff options
Diffstat (limited to 'documentation/migration-guides/migration-3.2.rst')
-rw-r--r-- | documentation/migration-guides/migration-3.2.rst | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/documentation/migration-guides/migration-3.2.rst b/documentation/migration-guides/migration-3.2.rst index a376eced52..92b7f91f2c 100644 --- a/documentation/migration-guides/migration-3.2.rst +++ b/documentation/migration-guides/migration-3.2.rst | |||
@@ -23,7 +23,7 @@ Removed recipes | |||
23 | The following recipes have been removed: | 23 | The following recipes have been removed: |
24 | 24 | ||
25 | - ``bjam-native``: replaced by ``boost-build-native`` | 25 | - ``bjam-native``: replaced by ``boost-build-native`` |
26 | - ``avahi-ui``: folded into the main ``avahi`` recipe - the GTK UI can be disabled using :term:`PACKAGECONFIG` for ``avahi``. | 26 | - ``avahi-ui``: folded into the main ``avahi`` recipe --- the GTK UI can be disabled using :term:`PACKAGECONFIG` for ``avahi``. |
27 | - ``build-compare``: no longer needed with the removal of the ``packagefeed-stability`` class | 27 | - ``build-compare``: no longer needed with the removal of the ``packagefeed-stability`` class |
28 | - ``dhcp``: obsolete, functionally replaced by ``dhcpcd`` and ``kea`` | 28 | - ``dhcp``: obsolete, functionally replaced by ``dhcpcd`` and ``kea`` |
29 | - ``libmodulemd-v1``: replaced by ``libmodulemd`` | 29 | - ``libmodulemd-v1``: replaced by ``libmodulemd`` |
@@ -37,7 +37,7 @@ Removed classes | |||
37 | 37 | ||
38 | The following classes (.bbclass files) have been removed: | 38 | The following classes (.bbclass files) have been removed: |
39 | 39 | ||
40 | - ``spdx``: obsolete - the Yocto Project is a strong supporter of SPDX, but this class was old code using a dated approach and had the potential to be misleading. The ``meta-sdpxscanner`` layer is a much more modern and active approach to handling this and is recommended as a replacement. | 40 | - ``spdx``: obsolete --- the Yocto Project is a strong supporter of SPDX, but this class was old code using a dated approach and had the potential to be misleading. The ``meta-sdpxscanner`` layer is a much more modern and active approach to handling this and is recommended as a replacement. |
41 | 41 | ||
42 | - ``packagefeed-stability``: this class had become obsolete with the advent of hash equivalence and reproducible builds. | 42 | - ``packagefeed-stability``: this class had become obsolete with the advent of hash equivalence and reproducible builds. |
43 | 43 | ||
@@ -46,7 +46,7 @@ pseudo path filtering and mismatch behaviour | |||
46 | -------------------------------------------- | 46 | -------------------------------------------- |
47 | 47 | ||
48 | pseudo now operates on a filtered subset of files. This is a significant change | 48 | pseudo now operates on a filtered subset of files. This is a significant change |
49 | to the way pseudo operates within OpenEmbedded - by default, pseudo monitors and | 49 | to the way pseudo operates within OpenEmbedded --- by default, pseudo monitors and |
50 | logs (adds to its database) any file created or modified whilst in a ``fakeroot`` | 50 | logs (adds to its database) any file created or modified whilst in a ``fakeroot`` |
51 | environment. However, there are large numbers of files that we simply don't care | 51 | environment. However, there are large numbers of files that we simply don't care |
52 | about the permissions of whilst in that ``fakeroot`` context, for example ${:term:`S`}, ${:term:`B`}, ${:term:`T`}, | 52 | about the permissions of whilst in that ``fakeroot`` context, for example ${:term:`S`}, ${:term:`B`}, ${:term:`T`}, |
@@ -68,7 +68,7 @@ structure above that subdirectory. For these types of cases in your own recipes, | |||
68 | extend :term:`PSEUDO_IGNORE_PATHS` to cover additional paths that pseudo should not | 68 | extend :term:`PSEUDO_IGNORE_PATHS` to cover additional paths that pseudo should not |
69 | be monitoring. | 69 | be monitoring. |
70 | 70 | ||
71 | In addition, pseudo's behaviour on mismatches has now been changed - rather | 71 | In addition, pseudo's behaviour on mismatches has now been changed --- rather |
72 | than doing what turns out to be a rather dangerous "fixup" if it sees a file | 72 | than doing what turns out to be a rather dangerous "fixup" if it sees a file |
73 | with a different path but the same inode as another file it has previously seen, | 73 | with a different path but the same inode as another file it has previously seen, |
74 | pseudo will throw an ``abort()`` and direct you to a :yocto_wiki:`wiki page </Pseudo_Abort>` | 74 | pseudo will throw an ``abort()`` and direct you to a :yocto_wiki:`wiki page </Pseudo_Abort>` |
@@ -137,10 +137,10 @@ DHCP server/client replaced | |||
137 | 137 | ||
138 | The ``dhcp`` software package has become unmaintained and thus has been | 138 | The ``dhcp`` software package has become unmaintained and thus has been |
139 | functionally replaced by ``dhcpcd`` (client) and ``kea`` (server). You will | 139 | functionally replaced by ``dhcpcd`` (client) and ``kea`` (server). You will |
140 | need to replace references to the recipe/package names as appropriate - most | 140 | need to replace references to the recipe/package names as appropriate --- most |
141 | commonly, at the package level ``dhcp-client`` should be replaced by | 141 | commonly, at the package level ``dhcp-client`` should be replaced by |
142 | ``dhcpcd`` and ``dhcp-server`` should be replaced by ``kea``. If you have any | 142 | ``dhcpcd`` and ``dhcp-server`` should be replaced by ``kea``. If you have any |
143 | custom configuration files for these they will need to be adapted - refer to | 143 | custom configuration files for these they will need to be adapted --- refer to |
144 | the upstream documentation for ``dhcpcd`` and ``kea`` for further details. | 144 | the upstream documentation for ``dhcpcd`` and ``kea`` for further details. |
145 | 145 | ||
146 | 146 | ||
@@ -181,7 +181,7 @@ In addition, the following new checks were added and default to triggering an er | |||
181 | 181 | ||
182 | - :ref:`missing-update-alternatives <qa-check-missing-update-alternatives>`: Check if the recipe sets the :term:`ALTERNATIVE` variable for any of its packages, and does not inherit the :ref:`update-alternatives <ref-classes-update-alternatives>` class. | 182 | - :ref:`missing-update-alternatives <qa-check-missing-update-alternatives>`: Check if the recipe sets the :term:`ALTERNATIVE` variable for any of its packages, and does not inherit the :ref:`update-alternatives <ref-classes-update-alternatives>` class. |
183 | 183 | ||
184 | - A trailing slash or duplicated slashes in the value of :term:`S` or :term:`B` will now trigger a warning so that they can be removed and path comparisons can be more reliable - remove any instances of these in your recipes if the warning is displayed. | 184 | - A trailing slash or duplicated slashes in the value of :term:`S` or :term:`B` will now trigger a warning so that they can be removed and path comparisons can be more reliable --- remove any instances of these in your recipes if the warning is displayed. |
185 | 185 | ||
186 | 186 | ||
187 | .. _migration-3.2-src-uri-file-globbing: | 187 | .. _migration-3.2-src-uri-file-globbing: |
@@ -209,7 +209,7 @@ deploy class now cleans ``DEPLOYDIR`` before ``do_deploy`` | |||
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 ``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. |
211 | 211 | ||
212 | Most 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. | 212 | Most 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 | ||
214 | 214 | ||
215 | .. _migration-3.2-nativesdk-sdk-provides-dummy: | 215 | .. _migration-3.2-nativesdk-sdk-provides-dummy: |
@@ -303,7 +303,7 @@ now need to be changed to ``inherit image-artifact-names``. | |||
303 | Miscellaneous changes | 303 | Miscellaneous changes |
304 | --------------------- | 304 | --------------------- |
305 | 305 | ||
306 | - Support for the long-deprecated ``PACKAGE_GROUP`` variable has now been removed - replace any remaining instances with :term:`FEATURE_PACKAGES`. | 306 | - Support for the long-deprecated ``PACKAGE_GROUP`` variable has now been removed --- replace any remaining instances with :term:`FEATURE_PACKAGES`. |
307 | - The ``FILESPATHPKG`` variable, having been previously deprecated, has now been removed. Replace any remaining references with appropriate use of :term:`FILESEXTRAPATHS`. | 307 | - The ``FILESPATHPKG`` variable, having been previously deprecated, has now been removed. Replace any remaining references with appropriate use of :term:`FILESEXTRAPATHS`. |
308 | - Erroneous use of ``inherit +=`` (instead of ``INHERIT +=``) in a configuration file now triggers an error instead of silently being ignored. | 308 | - Erroneous use of ``inherit +=`` (instead of ``INHERIT +=``) in a configuration file now triggers an error instead of silently being ignored. |
309 | - ptest support has been removed from the ``kbd`` recipe, as upstream has moved to autotest which is difficult to work with in a cross-compilation environment. | 309 | - ptest support has been removed from the ``kbd`` recipe, as upstream has moved to autotest which is difficult to work with in a cross-compilation environment. |