summaryrefslogtreecommitdiffstats
path: root/documentation/migration-guides
diff options
context:
space:
mode:
authorMichael Opdenacker <michael.opdenacker@bootlin.com>2021-11-23 18:47:55 +0100
committerRichard Purdie <richard.purdie@linuxfoundation.org>2021-12-13 23:31:34 +0000
commita19add4aaaa4ff64ae3403eae415c08713bbdb38 (patch)
tree35e27a4aa032849c826344fd99f0207c39cb18bb /documentation/migration-guides
parent2b578eae4e50774dd449282beb287e10b0485cbc (diff)
downloadpoky-a19add4aaaa4ff64ae3403eae415c08713bbdb38.tar.gz
migration-guides: add more class references
(From yocto-docs rev: 29031a9da0f1a500a8b2b6a642ee553a352255f8) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/migration-guides')
-rw-r--r--documentation/migration-guides/migration-1.5.rst3
-rw-r--r--documentation/migration-guides/migration-1.7.rst6
-rw-r--r--documentation/migration-guides/migration-2.1.rst6
-rw-r--r--documentation/migration-guides/migration-2.2.rst2
-rw-r--r--documentation/migration-guides/migration-2.3.rst2
-rw-r--r--documentation/migration-guides/migration-2.4.rst2
-rw-r--r--documentation/migration-guides/migration-2.5.rst8
-rw-r--r--documentation/migration-guides/migration-3.0.rst4
-rw-r--r--documentation/migration-guides/migration-3.1.rst4
-rw-r--r--documentation/migration-guides/migration-3.2.rst2
-rw-r--r--documentation/migration-guides/migration-3.3.rst2
11 files changed, 22 insertions, 19 deletions
diff --git a/documentation/migration-guides/migration-1.5.rst b/documentation/migration-guides/migration-1.5.rst
index 11c821265c..15b0b43092 100644
--- a/documentation/migration-guides/migration-1.5.rst
+++ b/documentation/migration-guides/migration-1.5.rst
@@ -95,7 +95,8 @@ The following changes have been made to the package QA checks:
95 this file within :ref:`ref-tasks-install` if "make 95 this file within :ref:`ref-tasks-install` if "make
96 install" is installing it. 96 install" is installing it.
97 97
98- If you are using the ``buildhistory`` class, the check for the package 98- If you are using the :ref:`buildhistory <ref-classes-buildhistory>` class,
99 the check for the package
99 version going backwards is now controlled using a standard QA check. 100 version going backwards is now controlled using a standard QA check.
100 Thus, if you have customized your :term:`ERROR_QA` or :term:`WARN_QA` values 101 Thus, if you have customized your :term:`ERROR_QA` or :term:`WARN_QA` values
101 and still wish to have this check performed, you should add 102 and still wish to have this check performed, you should add
diff --git a/documentation/migration-guides/migration-1.7.rst b/documentation/migration-guides/migration-1.7.rst
index 8c642da202..88a6855d50 100644
--- a/documentation/migration-guides/migration-1.7.rst
+++ b/documentation/migration-guides/migration-1.7.rst
@@ -43,7 +43,8 @@ The following :ref:`autotools <ref-classes-autotools>` class changes
43occurred: 43occurred:
44 44
45- *A separate build directory is now used by default:* The 45- *A separate build directory is now used by default:* The
46 ``autotools`` class has been changed to use a directory for building 46 :ref:`autotools <ref-classes-autotools>` class has been
47 changed to use a directory for building
47 (:term:`B`), which is separate from the source directory 48 (:term:`B`), which is separate from the source directory
48 (:term:`S`). This is commonly referred to as ``B != S``, or 49 (:term:`S`). This is commonly referred to as ``B != S``, or
49 an out-of-tree build. 50 an out-of-tree build.
@@ -54,7 +55,8 @@ occurred:
54 manner, you will need to either patch the software so that it can 55 manner, you will need to either patch the software so that it can
55 build separately, or you will need to change the recipe to inherit 56 build separately, or you will need to change the recipe to inherit
56 the :ref:`autotools-brokensep <ref-classes-autotools>` class 57 the :ref:`autotools-brokensep <ref-classes-autotools>` class
57 instead of the ``autotools`` or ``autotools_stage`` classes. 58 instead of the :ref:`autotools <ref-classes-autotools>`
59 or ``autotools_stage`` classes.
58 60
59- The ``--foreign`` option is no longer passed to ``automake`` when 61- The ``--foreign`` option is no longer passed to ``automake`` when
60 running ``autoconf``: This option tells ``automake`` that a 62 running ``autoconf``: This option tells ``automake`` that a
diff --git a/documentation/migration-guides/migration-2.1.rst b/documentation/migration-guides/migration-2.1.rst
index 3135d69caa..eb29694bb5 100644
--- a/documentation/migration-guides/migration-2.1.rst
+++ b/documentation/migration-guides/migration-2.1.rst
@@ -106,12 +106,12 @@ as was previously assumed. Rather, the value changes based on whether
106large file support is enabled. For most software that uses ``autoconf``, 106large file support is enabled. For most software that uses ``autoconf``,
107this change should not be a problem. However, if you have a recipe that 107this change should not be a problem. However, if you have a recipe that
108bypasses the standard :ref:`ref-tasks-configure` task 108bypasses the standard :ref:`ref-tasks-configure` task
109from the ``autotools`` class and the software the recipe is building 109from the :ref:`autotools <ref-classes-autotools>` class and the software the recipe is building
110uses a very old version of ``autoconf``, the recipe might be incapable 110uses a very old version of ``autoconf``, the recipe might be incapable
111of determining the correct size of ``off_t`` during ``do_configure``. 111of determining the correct size of ``off_t`` during ``do_configure``.
112 112
113The best course of action is to patch the software as necessary to allow 113The best course of action is to patch the software as necessary to allow
114the default implementation from the ``autotools`` class to work such 114the default implementation from the :ref:`autotools <ref-classes-autotools>` class to work such
115that ``autoreconf`` succeeds and produces a working configure script, 115that ``autoreconf`` succeeds and produces a working configure script,
116and to remove the overridden ``do_configure`` task such that the default 116and to remove the overridden ``do_configure`` task such that the default
117implementation does get used. 117implementation does get used.
@@ -262,7 +262,7 @@ The following changes have been made for the Poky distribution:
262 With this class enabled, a tarball containing a pre-built C library 262 With this class enabled, a tarball containing a pre-built C library
263 is downloaded at the start of the build. 263 is downloaded at the start of the build.
264 264
265 The ``uninative`` class is enabled through the 265 The :ref:`uninative <ref-classes-uninative>` class is enabled through the
266 ``meta/conf/distro/include/yocto-uninative.inc`` file, which for 266 ``meta/conf/distro/include/yocto-uninative.inc`` file, which for
267 those not using the Poky distribution, can include to easily enable 267 those not using the Poky distribution, can include to easily enable
268 the same functionality. 268 the same functionality.
diff --git a/documentation/migration-guides/migration-2.2.rst b/documentation/migration-guides/migration-2.2.rst
index cbdc6a739e..c063deb44b 100644
--- a/documentation/migration-guides/migration-2.2.rst
+++ b/documentation/migration-guides/migration-2.2.rst
@@ -439,7 +439,7 @@ The following miscellaneous changes have occurred:
439 439
440- ``packagegroup-core-tools-testapps``: Removed Piglit. 440- ``packagegroup-core-tools-testapps``: Removed Piglit.
441 441
442- ``image.bbclass``: Renamed COMPRESS(ION) to CONVERSION. This change 442- :ref:`image.bbclass <ref-classes-image>`: Renamed COMPRESS(ION) to CONVERSION. This change
443 means that ``COMPRESSIONTYPES``, ``COMPRESS_DEPENDS`` and 443 means that ``COMPRESSIONTYPES``, ``COMPRESS_DEPENDS`` and
444 ``COMPRESS_CMD`` are deprecated in favor of ``CONVERSIONTYPES``, 444 ``COMPRESS_CMD`` are deprecated in favor of ``CONVERSIONTYPES``,
445 ``CONVERSION_DEPENDS`` and ``CONVERSION_CMD``. The ``COMPRESS*`` 445 ``CONVERSION_DEPENDS`` and ``CONVERSION_CMD``. The ``COMPRESS*``
diff --git a/documentation/migration-guides/migration-2.3.rst b/documentation/migration-guides/migration-2.3.rst
index b79bc541c5..0b6b33d2cb 100644
--- a/documentation/migration-guides/migration-2.3.rst
+++ b/documentation/migration-guides/migration-2.3.rst
@@ -50,7 +50,7 @@ Consider the following:
50 post-installation script that is installed by a function added to 50 post-installation script that is installed by a function added to
51 :term:`SYSROOT_PREPROCESS_FUNCS`. 51 :term:`SYSROOT_PREPROCESS_FUNCS`.
52 52
53 For an example, see the ``pixbufcache`` class in ``meta/classes/`` in 53 For an example, see the :ref:`pixbufcache <ref-classes-pixbufcache>` class in ``meta/classes/`` in
54 the :ref:`overview-manual/development-environment:yocto project source repositories`. 54 the :ref:`overview-manual/development-environment:yocto project source repositories`.
55 55
56 .. note:: 56 .. note::
diff --git a/documentation/migration-guides/migration-2.4.rst b/documentation/migration-guides/migration-2.4.rst
index ae1a212b5d..ef5f32e6ef 100644
--- a/documentation/migration-guides/migration-2.4.rst
+++ b/documentation/migration-guides/migration-2.4.rst
@@ -273,7 +273,7 @@ The following are additional changes:
273 a single commit per build rather than one commit per subdirectory in 273 a single commit per build rather than one commit per subdirectory in
274 the repository. This behavior assumes the commits are enabled with 274 the repository. This behavior assumes the commits are enabled with
275 :term:`BUILDHISTORY_COMMIT` = "1", which 275 :term:`BUILDHISTORY_COMMIT` = "1", which
276 is typical. Previously, the ``buildhistory`` class made one commit 276 is typical. Previously, the :ref:`buildhistory <ref-classes-buildhistory>` class made one commit
277 per subdirectory in the repository in order to make it easier to see 277 per subdirectory in the repository in order to make it easier to see
278 the changes for a particular subdirectory. To view a particular 278 the changes for a particular subdirectory. To view a particular
279 change, specify that subdirectory as the last parameter on the 279 change, specify that subdirectory as the last parameter on the
diff --git a/documentation/migration-guides/migration-2.5.rst b/documentation/migration-guides/migration-2.5.rst
index 79f804fa1d..bd75522773 100644
--- a/documentation/migration-guides/migration-2.5.rst
+++ b/documentation/migration-guides/migration-2.5.rst
@@ -137,7 +137,7 @@ The following are BitBake changes:
137- Several explicit "run this task for all recipes in the dependency 137- Several explicit "run this task for all recipes in the dependency
138 tree" tasks have been removed (e.g. ``fetchall``, ``checkuriall``, 138 tree" tasks have been removed (e.g. ``fetchall``, ``checkuriall``,
139 and the ``*all`` tasks provided by the ``distrodata`` and 139 and the ``*all`` tasks provided by the ``distrodata`` and
140 ``archiver`` classes). There is a BitBake option to complete this for 140 :ref:`archiver <ref-classes-archiver>` classes). There is a BitBake option to complete this for
141 any arbitrary task. For example:: 141 any arbitrary task. For example::
142 142
143 bitbake <target> -c fetchall 143 bitbake <target> -c fetchall
@@ -187,7 +187,7 @@ Miscellaneous Changes
187 187
188The following are additional changes: 188The following are additional changes:
189 189
190- The ``kernel`` class supports building packages for multiple kernels. 190- The :ref:`kernel <ref-classes-kernel>` class supports building packages for multiple kernels.
191 If your kernel recipe or ``.bbappend`` file mentions packaging at 191 If your kernel recipe or ``.bbappend`` file mentions packaging at
192 all, you should replace references to the kernel in package names 192 all, you should replace references to the kernel in package names
193 with ``${KERNEL_PACKAGE_NAME}``. For example, if you disable 193 with ``${KERNEL_PACKAGE_NAME}``. For example, if you disable
@@ -195,7 +195,7 @@ The following are additional changes:
195 ``RDEPENDS_kernel-base = ""`` you can avoid warnings using 195 ``RDEPENDS_kernel-base = ""`` you can avoid warnings using
196 ``RDEPENDS_${KERNEL_PACKAGE_NAME}-base = ""`` instead. 196 ``RDEPENDS_${KERNEL_PACKAGE_NAME}-base = ""`` instead.
197 197
198- The ``buildhistory`` class commits changes to the repository by 198- The :ref:`buildhistory <ref-classes-buildhistory>` class commits changes to the repository by
199 default so you no longer need to set ``BUILDHISTORY_COMMIT = "1"``. 199 default so you no longer need to set ``BUILDHISTORY_COMMIT = "1"``.
200 If you want to disable commits you need to set 200 If you want to disable commits you need to set
201 ``BUILDHISTORY_COMMIT = "0"`` in your configuration. 201 ``BUILDHISTORY_COMMIT = "0"`` in your configuration.
@@ -207,7 +207,7 @@ The following are additional changes:
207 maintains a full-featured BSP in the ``meta-ti`` layer. This rename 207 maintains a full-featured BSP in the ``meta-ti`` layer. This rename
208 avoids the previous name clash that existed between the two BSPs. 208 avoids the previous name clash that existed between the two BSPs.
209 209
210- The ``update-alternatives`` class no longer works with SysV ``init`` 210- The :ref:`update-alternatives <ref-classes-update-alternatives>` class no longer works with SysV ``init``
211 scripts because this usage has been problematic. Also, the 211 scripts because this usage has been problematic. Also, the
212 ``sysklogd`` recipe no longer uses ``update-alternatives`` because it 212 ``sysklogd`` recipe no longer uses ``update-alternatives`` because it
213 is incompatible with other implementations. 213 is incompatible with other implementations.
diff --git a/documentation/migration-guides/migration-3.0.rst b/documentation/migration-guides/migration-3.0.rst
index 9a5f5714bd..610298bda6 100644
--- a/documentation/migration-guides/migration-3.0.rst
+++ b/documentation/migration-guides/migration-3.0.rst
@@ -47,7 +47,7 @@ The following recipes have been removed.
47- ``core-image-lsb-sdk``: Part of removed LSB support. 47- ``core-image-lsb-sdk``: Part of removed LSB support.
48 48
49- ``cve-check-tool``: Functionally replaced by the ``cve-update-db`` 49- ``cve-check-tool``: Functionally replaced by the ``cve-update-db``
50 recipe and ``cve-check`` class. 50 recipe and :ref:`cve-check <ref-classes-cve-check>` class.
51 51
52- ``eglinfo``: No longer maintained. ``eglinfo`` from ``mesa-demos`` is 52- ``eglinfo``: No longer maintained. ``eglinfo`` from ``mesa-demos`` is
53 an adequate and maintained alternative. 53 an adequate and maintained alternative.
@@ -142,7 +142,7 @@ CVE Checking
142------------ 142------------
143 143
144``cve-check-tool`` has been functionally replaced by a new 144``cve-check-tool`` has been functionally replaced by a new
145``cve-update-db`` recipe and functionality built into the ``cve-check`` 145``cve-update-db`` recipe and functionality built into the :ref:`cve-check <ref-classes-cve-check>`
146class. The result uses NVD JSON data feeds rather than the deprecated 146class. The result uses NVD JSON data feeds rather than the deprecated
147XML feeds that ``cve-check-tool`` was using, supports CVSSv3 scoring, 147XML feeds that ``cve-check-tool`` was using, supports CVSSv3 scoring,
148and makes other improvements. 148and makes other improvements.
diff --git a/documentation/migration-guides/migration-3.1.rst b/documentation/migration-guides/migration-3.1.rst
index 80b8f6baa5..cb0296717e 100644
--- a/documentation/migration-guides/migration-3.1.rst
+++ b/documentation/migration-guides/migration-3.1.rst
@@ -125,7 +125,7 @@ renamed to ``features_check``; the ``distro_features_check`` class still
125exists but generates a warning and redirects to the new class. In 125exists but generates a warning and redirects to the new class. In
126preparation for a future removal of the old class it is recommended that 126preparation for a future removal of the old class it is recommended that
127you update recipes currently inheriting ``distro_features_check`` to 127you update recipes currently inheriting ``distro_features_check`` to
128inherit ``features_check`` instead. 128inherit :ref:`features_check <ref-classes-features_check>` instead.
129 129
130.. _migration-3.1-removed-classes: 130.. _migration-3.1-removed-classes:
131 131
@@ -241,7 +241,7 @@ circumstances:
241 does not inherit the new ``mime-xdg`` class 241 does not inherit the new ``mime-xdg`` class
242 242
243- A recipe installs ``.xml`` files into ``${datadir}/mime/packages`` 243- A recipe installs ``.xml`` files into ``${datadir}/mime/packages``
244 but does not inherit the ``mime`` class 244 but does not inherit the :ref:`mime <ref-classes-mime>` class
245 245
246.. _migration-3.1-x86-live-wic: 246.. _migration-3.1-x86-live-wic:
247 247
diff --git a/documentation/migration-guides/migration-3.2.rst b/documentation/migration-guides/migration-3.2.rst
index a940f23238..d593effe97 100644
--- a/documentation/migration-guides/migration-3.2.rst
+++ b/documentation/migration-guides/migration-3.2.rst
@@ -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
212Most recipes and classes that inherit the ``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
214 214
215.. _migration-3.2-nativesdk-sdk-provides-dummy: 215.. _migration-3.2-nativesdk-sdk-provides-dummy:
diff --git a/documentation/migration-guides/migration-3.3.rst b/documentation/migration-guides/migration-3.3.rst
index 28857e820b..f065a17e68 100644
--- a/documentation/migration-guides/migration-3.3.rst
+++ b/documentation/migration-guides/migration-3.3.rst
@@ -64,7 +64,7 @@ New ``python3targetconfig`` class
64 64
65A new :ref:`python3targetconfig <ref-classes-python3targetconfig>` class has been 65A new :ref:`python3targetconfig <ref-classes-python3targetconfig>` class has been
66created for situations where you would previously have inherited the 66created for situations where you would previously have inherited the
67``python3native`` class but need access to target configuration data (such as 67:ref:`python3native <ref-classes-python3native>` class but need access to target configuration data (such as
68correct installation directories). Recipes where this situation applies should 68correct installation directories). Recipes where this situation applies should
69be changed to inherit ``python3targetconfig`` instead of ``python3native``. This 69be changed to inherit ``python3targetconfig`` instead of ``python3native``. This
70also adds a dependency on target ``python3``, so it should only be used where 70also adds a dependency on target ``python3``, so it should only be used where