[PATCH 00/19] Updates from Poky master

[PATCH 00/19] Updates from Poky master

[Antonin Godard]

Update the documentation with regards to the latest changes on Poky's
master branch.

This covers commits from c4a5e590b53b ("rust-llvm: Compile llvm to use
dynamic libraries") to 2a832e6af1b6 ("orc: set CVE_PRODUCT") in Poky.

This series depends on:
https://lore.kernel.org/r/20250724-bb-defer-bbclasses-v1-1-70f1826d4b83@bootlin.com
and
https://lore.kernel.org/r/20250728-refactor-qa-checks-v2-0-9e0737979f05@bootlin.com

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
Antonin Godard (19):
      ref-manual/tasks.rst: add documentation for do_recipe_qa
      ref-manual/variables.rst: document SPDX_PACKAGE_URL
      ref-manual/variables.rst: document KMETA_CONFIG_FEATURES
      ref-manual/variables.rst: document TESTSDK_SUITES
      ref-manual/variables.rst: document PSEUDO_INCLUDE_PATHS
      Drop the icecc class and related variables
      ref-manual/variables.rst: document the FIT_CONF_PREFIX variable
      ref-manual/variables.rst: add link for BB_DEFER_BBCLASSES
      ref-manual/variables.rst: document SPL_DTB_BINARY
      ref-manual/variables.rst: document UBOOT_VERSION
      ref-manual/classes.rst: document the go-mod-update-modules class
      ref-manual/variables.rst: document OE_SHARED_UMASK
      ref-manual/variables.rst: document CVE_CHECK_VEX_JUSTIFICATION
      ref-manual/classes.rst: document the testexport class
      docs-wide: update wic source plugin names
      ref-manual/tasks.rst: do_package_qa: update link to qa checks
      ref-manual/qa-checks.rst: add space around equal warning
      docs-wide: fix space around equal assignments
      migration-guides/release-notes-5.3: updates

 documentation/bsp-guide/bsp.rst                    |   4 +-
 documentation/dev-manual/building.rst              |   8 +-
 documentation/dev-manual/layers.rst                |   2 +-
 documentation/dev-manual/new-recipe.rst            |   2 +-
 documentation/dev-manual/qemu.rst                  |   4 +-
 documentation/dev-manual/wic.rst                   |  16 +-
 documentation/migration-guides/migration-4.0.rst   |  10 +-
 documentation/migration-guides/migration-5.3.rst   |  89 ++++
 .../migration-guides/release-notes-5.3.rst         | 564 ++++++++++++++++++++-
 documentation/ref-manual/classes.rst               | 113 ++---
 documentation/ref-manual/qa-checks.rst             |  16 +
 documentation/ref-manual/tasks.rst                 |  13 +-
 documentation/ref-manual/variables.rst             | 161 +++---
 documentation/sdk-manual/appendix-customizing.rst  |   4 +-
 14 files changed, 808 insertions(+), 198 deletions(-)
---
base-commit: dc984e5f54c38748603243053fde8b4d078ba586
change-id: 20250717-release-note-5-3-first-bunch-13e949a3113d

Best regards,
--  
Antonin Godard <antonin.godard@bootlin.com>

[PATCH 01/19] ref-manual/tasks.rst: add documentation for do_recipe_qa

[Antonin Godard]

Document the do_recipe_qa task in classes.rst and link to the insane
class documentation.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/tasks.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/documentation/ref-manual/tasks.rst b/documentation/ref-manual/tasks.rst
index e379c424d..d7b19e04b 100644
--- a/documentation/ref-manual/tasks.rst
+++ b/documentation/ref-manual/tasks.rst
@@ -397,6 +397,17 @@ Installs the files into the individual recipe specific sysroots (i.e.
 dependencies specified by :term:`DEPENDS`). See the
 ":ref:`ref-classes-staging`" class for more information.
 
+.. _ref-tasks-recipe-qa:
+
+``do_recipe_qa``
+----------------
+
+Performs QA check on recipes that can operate entirely from recipe metadata and
+do not need any of the build artefacts or source code.
+
+The list of QA checks that this tasks defines are documented in
+:doc:`/ref-manual/qa-checks`.
+
 .. _ref-tasks-rm_work:
 
 ``do_rm_work``

-- 
2.50.1

[PATCH 02/19] ref-manual/variables.rst: document SPDX_PACKAGE_URL

[Antonin Godard]

Used for SPDX3 software_packageUrl field.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/variables.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 038e5541e..03839ac0a 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -8875,6 +8875,12 @@ system and gives an overview of their function and contents.
       output (``software_packageVersion``). The default value for this variable
       is :term:`PV`.
 
+   :term:`SPDX_PACKAGE_URL`
+      Provides a place for the SPDX data creator to record the package URL
+      string (``software_packageUrl``, in accordance with the Package URL
+      specification) for a software Package. The default value of this variable
+      is an empty string.
+
    :term:`SPDX_PRETTY`
       This option makes the SPDX output more human-readable, using
       identation and newlines, instead of the default output in a

-- 
2.50.1

[PATCH 03/19] ref-manual/variables.rst: document KMETA_CONFIG_FEATURES

[Antonin Godard]

The KMETA_CONFIG_FEATURES variable defines kernel-yocto features to
enable.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/variables.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 03839ac0a..1a4e8a254 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -5468,6 +5468,19 @@ system and gives an overview of their function and contents.
       Linux Kernel configuration auditing feature, see :term:`KCONF_AUDIT_LEVEL`
       and :term:`KCONF_BSP_AUDIT_LEVEL`.
 
+   :term:`KMETA_CONFIG_FEATURES`
+      The :term:`KMETA_CONFIG_FEATURES` variable defines features enabled for the
+      :ref:`ref-classes-kernel-yocto` class. The following list of features are
+      supported:
+
+      -  ``prefer-modules``: prefer a kernel configuration to be set as ``m``
+         instead of the default value ``y`` if the kernel configuration was
+         defined as follows::
+
+            CONFIG_FOO=y # OVERRIDE:$MODULE_OR_Y
+
+      The default value of this variable is an empty string.
+
    :term:`KTYPE`
       Defines the kernel type to be used in assembling the configuration.
       The linux-yocto recipes define "standard", "tiny", and "preempt-rt"

-- 
2.50.1

[PATCH 04/19] ref-manual/variables.rst: document TESTSDK_SUITES

[Antonin Godard]

The TESTSDK_SUITES variable can be used to control the list of test
modules run with the testsdk class.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/classes.rst   | 3 +++
 documentation/ref-manual/variables.rst | 6 ++++++
 2 files changed, 9 insertions(+)

diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index ee583fe9b..7c2b4fb27 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -3069,6 +3069,9 @@ using the following::
 
    $ bitbake -c testsdk image
 
+The list of test modules that are run can be controlled with the
+:term:`TESTSDK_SUITES` variable.
+
 .. note::
 
    Best practices include using :term:`IMAGE_CLASSES` rather than
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 1a4e8a254..a5d43966c 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -10165,6 +10165,12 @@ system and gives an overview of their function and contents.
       :term:`TESTIMAGE_FAILED_QA_ARTIFACTS`  lists space-separated paths on the
       target to retrieve onto the host.
 
+   :term:`TESTSDK_SUITES`
+      When using the :ref:`ref-classes-testsdk` class, the
+      :term:`TESTSDK_SUITES` variable can be used to control the list of test
+      modules to run. The default value for this variable is an empty string
+      and all test modules that can be found are run.
+
    :term:`THISDIR`
       The directory in which the file BitBake is currently parsing is
       located. Do not manually set this variable.

-- 
2.50.1

[PATCH 05/19] ref-manual/variables.rst: document PSEUDO_INCLUDE_PATHS

[Antonin Godard]

Added by commit 2502da81709f ("bitbake.conf/pseudo: Switch from
exclusion list to inclusion list") in OE-Core.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/variables.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index a5d43966c..a6962bb9d 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -7585,6 +7585,13 @@ system and gives an overview of their function and contents.
       reduce pseudo's overhead. A path is ignored if it matches any prefix in the list
       and can include partial directory (or file) names.
 
+   :term:`PSEUDO_INCLUDE_PATHS`
+      A comma-separated (without spaces) list of path prefixes that should be included
+      by pseudo when monitoring and recording file operations, in order to avoid
+      problems with files being written to outside of the pseudo context and
+      reduce :ref:`pseudo <overview-manual/concepts:Fakeroot and Pseudo>`'s overhead.
+      A path is included if it matches any prefix in the list and can include
+      partial directory (or file) names.
 
    :term:`PTEST_ENABLED`
       Specifies whether or not :ref:`Package

-- 
2.50.1

[PATCH 06/19] Drop the icecc class and related variables

[Antonin Godard]

Dropped by commit ecf8c386cf83 ("classes/recipes-devtools: Drop icecc
from OE-Core") in OE-Core.

Remove documentation for the class and the related variables. Remove the
references to this class.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/migration-guides/migration-4.0.rst  | 10 +--
 documentation/ref-manual/classes.rst              | 74 -------------------
 documentation/ref-manual/variables.rst            | 89 +----------------------
 documentation/sdk-manual/appendix-customizing.rst |  4 +-
 4 files changed, 9 insertions(+), 168 deletions(-)

diff --git a/documentation/migration-guides/migration-4.0.rst b/documentation/migration-guides/migration-4.0.rst
index 0e9e741458..c8c2b856d9 100644
--- a/documentation/migration-guides/migration-4.0.rst
+++ b/documentation/migration-guides/migration-4.0.rst
@@ -33,11 +33,11 @@ The following variables have changed their names:
 - ``BB_SETSCENE_ENFORCE_WHITELIST`` became ``BB_SETSCENE_ENFORCE_IGNORE_TASKS``
 - ``CVE_CHECK_PN_WHITELIST`` became :term:`CVE_CHECK_SKIP_RECIPE`
 - ``CVE_CHECK_WHITELIST`` became :term:`CVE_CHECK_IGNORE`
-- ``ICECC_USER_CLASS_BL`` became :term:`ICECC_CLASS_DISABLE`
-- ``ICECC_SYSTEM_CLASS_BL`` became :term:`ICECC_CLASS_DISABLE`
-- ``ICECC_USER_PACKAGE_WL`` became :term:`ICECC_RECIPE_ENABLE`
-- ``ICECC_USER_PACKAGE_BL`` became :term:`ICECC_RECIPE_DISABLE`
-- ``ICECC_SYSTEM_PACKAGE_BL`` became :term:`ICECC_RECIPE_DISABLE`
+- ``ICECC_USER_CLASS_BL`` became ``ICECC_CLASS_DISABLE``
+- ``ICECC_SYSTEM_CLASS_BL`` became ``ICECC_CLASS_DISABLE``
+- ``ICECC_USER_PACKAGE_WL`` became ``ICECC_RECIPE_ENABLE``
+- ``ICECC_USER_PACKAGE_BL`` became ``ICECC_RECIPE_DISABLE``
+- ``ICECC_SYSTEM_PACKAGE_BL`` became ``ICECC_RECIPE_DISABLE``
 - ``LICENSE_FLAGS_WHITELIST`` became :term:`LICENSE_FLAGS_ACCEPTED`
 - ``MULTI_PROVIDER_WHITELIST`` became :term:`BB_MULTI_PROVIDER_ALLOWED`
 - ``PNBLACKLIST`` became :term:`SKIP_RECIPE`
diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index 7c2b4fb278..748f0395c2 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -1143,80 +1143,6 @@ The :ref:`ref-classes-gzipnative` class enables the use of different native vers
 ``gzip`` and ``pigz`` rather than the versions of these tools from the
 build host.
 
-.. _ref-classes-icecc:
-
-``icecc``
-=========
-
-The :ref:`ref-classes-icecc` class supports
-`Icecream <https://github.com/icecc/icecream>`__, which facilitates
-taking compile jobs and distributing them among remote machines.
-
-The class stages directories with symlinks from ``gcc`` and ``g++`` to
-``icecc``, for both native and cross compilers. Depending on each
-configure or compile, the OpenEmbedded build system adds the directories
-at the head of the ``PATH`` list and then sets the ``ICECC_CXX`` and
-``ICECC_CC`` variables, which are the paths to the ``g++`` and ``gcc``
-compilers, respectively.
-
-For the cross compiler, the class creates a ``tar.gz`` file that
-contains the Yocto Project toolchain and sets ``ICECC_VERSION``, which
-is the version of the cross-compiler used in the cross-development
-toolchain, accordingly.
-
-The class handles all three different compile stages (i.e native,
-cross-kernel and target) and creates the necessary environment
-``tar.gz`` file to be used by the remote machines. The class also
-supports SDK generation.
-
-If :term:`ICECC_PATH` is not set in your
-``local.conf`` file, then the class tries to locate the ``icecc`` binary
-using ``which``. If :term:`ICECC_ENV_EXEC` is set
-in your ``local.conf`` file, the variable should point to the
-``icecc-create-env`` script provided by the user. If you do not point to
-a user-provided script, the build system uses the default script
-provided by the recipe :oe_git:`icecc-create-env_0.1.bb
-</openembedded-core/tree/meta/recipes-devtools/icecc-create-env/icecc-create-env_0.1.bb>`.
-
-.. note::
-
-   This script is a modified version and not the one that comes with
-   ``icecream``.
-
-If you do not want the Icecream distributed compile support to apply to
-specific recipes or classes, you can ask them to be ignored by Icecream
-by listing the recipes and classes using the
-:term:`ICECC_RECIPE_DISABLE` and
-:term:`ICECC_CLASS_DISABLE` variables,
-respectively, in your ``local.conf`` file. Doing so causes the
-OpenEmbedded build system to handle these compilations locally.
-
-Additionally, you can list recipes using the
-:term:`ICECC_RECIPE_ENABLE` variable in
-your ``local.conf`` file to force ``icecc`` to be enabled for recipes
-using an empty :term:`PARALLEL_MAKE` variable.
-
-Inheriting the :ref:`ref-classes-icecc` class changes all sstate signatures.
-Consequently, if a development team has a dedicated build system that
-populates :term:`SSTATE_MIRRORS` and they want to
-reuse sstate from :term:`SSTATE_MIRRORS`, then all developers and the build
-system need to either inherit the :ref:`ref-classes-icecc` class or nobody should.
-
-At the distribution level, you can inherit the :ref:`ref-classes-icecc` class to be
-sure that all builders start with the same sstate signatures. After
-inheriting the class, you can then disable the feature by setting the
-:term:`ICECC_DISABLED` variable to "1" as follows::
-
-   INHERIT_DISTRO:append = " icecc"
-   ICECC_DISABLED ??= "1"
-
-This practice
-makes sure everyone is using the same signatures but also requires
-individuals that do want to use Icecream to enable the feature
-individually as follows in your ``local.conf`` file::
-
-   ICECC_DISABLED = ""
-
 .. _ref-classes-image:
 
 ``image``
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index a6962bb9d4..d8e6a81ea7 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -9,7 +9,7 @@ system and gives an overview of their function and contents.
 
 :term:`A <ABIEXTENSION>` :term:`B` :term:`C <CACHE>`
 :term:`D` :term:`E <EFI_PROVIDER>` :term:`F <FAKEROOT>`
-:term:`G <GCCPIE>` :term:`H <HGDIR>` :term:`I <ICECC_CLASS_DISABLE>`
+:term:`G <GCCPIE>` :term:`H <HGDIR>` :term:`I <IMAGE_BASENAME>`
 :term:`K <KARCH>` :term:`L <LABELS>` :term:`M <MACHINE>`
 :term:`N <NATIVELSBSTRING>` :term:`O <OBJCOPY>` :term:`P`
 :term:`Q <QA_EMPTY_DIRS>` :term:`R <RANLIB>` :term:`S` :term:`T`
@@ -2686,7 +2686,7 @@ system and gives an overview of their function and contents.
       :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class sets the
       default value::
 
-         ESDK_CLASS_INHERIT_DISABLE ?= "buildhistory icecc"
+         ESDK_CLASS_INHERIT_DISABLE ?= "buildhistory"
 
       Some classes are not generally applicable within the extensible SDK
       context. You can use this variable to disable those classes.
@@ -3818,91 +3818,6 @@ system and gives an overview of their function and contents.
       :term:`HOSTTOOLS_NONFATAL` is not found on the build host. Thus, you can
       use :term:`HOSTTOOLS_NONFATAL` to filter optional host tools.
 
-   :term:`ICECC_CLASS_DISABLE`
-      Identifies user classes that you do not want the Icecream distributed
-      compile support to consider. This variable is used by the
-      :ref:`ref-classes-icecc` class. You set this variable in
-      your ``local.conf`` file.
-
-      When you list classes using this variable, the recipes inheriting
-      those classes will not benefit from distributed compilation across
-      remote hosts. Instead they will be built locally.
-
-   :term:`ICECC_DISABLED`
-      Disables or enables the ``icecc`` (Icecream) function. For more
-      information on this function and best practices for using this
-      variable, see the ":ref:`ref-classes-icecc`"
-      section.
-
-      Setting this variable to "1" in your ``local.conf`` disables the
-      function::
-
-         ICECC_DISABLED ??= "1"
-
-      To enable the function, set the variable as follows::
-
-         ICECC_DISABLED = ""
-
-   :term:`ICECC_ENV_EXEC`
-      Points to the ``icecc-create-env`` script that you provide. This
-      variable is used by the :ref:`ref-classes-icecc` class. You
-      set this variable in your ``local.conf`` file.
-
-      If you do not point to a script that you provide, the OpenEmbedded
-      build system uses the default script provided by the
-      :oe_git:`icecc-create-env_0.1.bb
-      </openembedded-core/tree/meta/recipes-devtools/icecc-create-env/icecc-create-env_0.1.bb>`
-      recipe, which is a modified version and not the one that comes with
-      ``icecream``.
-
-   :term:`ICECC_PARALLEL_MAKE`
-      Extra options passed to the ``make`` command during the
-      :ref:`ref-tasks-compile` task that specify parallel
-      compilation. This variable usually takes the form of "-j x", where x
-      represents the maximum number of parallel threads ``make`` can run.
-
-      .. note::
-
-         The options passed affect builds on all enabled machines on the
-         network, which are machines running the ``iceccd`` daemon.
-
-      If your enabled machines support multiple cores, coming up with the
-      maximum number of parallel threads that gives you the best
-      performance could take some experimentation since machine speed,
-      network lag, available memory, and existing machine loads can all
-      affect build time. Consequently, unlike the
-      :term:`PARALLEL_MAKE` variable, there is no
-      rule-of-thumb for setting :term:`ICECC_PARALLEL_MAKE` to achieve optimal
-      performance.
-
-      If you do not set :term:`ICECC_PARALLEL_MAKE`, the build system does not
-      use it (i.e. the system does not detect and assign the number of
-      cores as is done with :term:`PARALLEL_MAKE`).
-
-   :term:`ICECC_PATH`
-      The location of the ``icecc`` binary. You can set this variable in
-      your ``local.conf`` file. If your ``local.conf`` file does not define
-      this variable, the :ref:`ref-classes-icecc` class attempts
-      to define it by locating ``icecc`` using ``which``.
-
-   :term:`ICECC_RECIPE_DISABLE`
-      Identifies user recipes that you do not want the Icecream distributed
-      compile support to consider. This variable is used by the
-      :ref:`ref-classes-icecc` class. You set this variable in
-      your ``local.conf`` file.
-
-      When you list recipes using this variable, you are excluding them
-      from distributed compilation across remote hosts. Instead they will
-      be built locally.
-
-   :term:`ICECC_RECIPE_ENABLE`
-      Identifies user recipes that use an empty
-      :term:`PARALLEL_MAKE` variable that you want to
-      force remote distributed compilation on using the Icecream
-      distributed compile support. This variable is used by the
-      :ref:`ref-classes-icecc` class. You set this variable in
-      your ``local.conf`` file.
-
    :term:`IMAGE_BASENAME`
       The base name of image output files. This variable defaults to the
       recipe name (``${``\ :term:`PN`\ ``}``).
diff --git a/documentation/sdk-manual/appendix-customizing.rst b/documentation/sdk-manual/appendix-customizing.rst
index 61091d83ba..e08630dce0 100644
--- a/documentation/sdk-manual/appendix-customizing.rst
+++ b/documentation/sdk-manual/appendix-customizing.rst
@@ -48,8 +48,8 @@ build system applies them against ``local.conf`` and ``auto.conf``:
    :term:`ESDK_CLASS_INHERIT_DISABLE` are disabled. Using
    :term:`ESDK_CLASS_INHERIT_DISABLE` to disable these classes is the typical
    method to disable classes that are problematic or unnecessary in the SDK
-   context. The default value disables the
-   :ref:`ref-classes-buildhistory` and :ref:`ref-classes-icecc` classes.
+   context. The default value disables the :ref:`ref-classes-buildhistory`
+   class.
 
 Additionally, the contents of ``conf/sdk-extra.conf``, when present, are
 appended to the end of ``conf/local.conf`` within the produced SDK,

-- 
2.50.1

[PATCH 07/19] ref-manual/variables.rst: document the FIT_CONF_PREFIX variable

[Antonin Godard]

Added by commit 7892ee3dc37d ("kernel-fitimage: allow overriding FIT
configuration prefix") in OE-Core, but never documented.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/variables.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index d8e6a81ea..25879b9b4 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -3360,6 +3360,10 @@ system and gives an overview of their function and contents.
 
       This variable is used in the :ref:`ref-classes-kernel-fit-image` class.
 
+   :term:`FIT_CONF_PREFIX`
+      When using the :ref:`ref-classes-kernel-fit-image`, this is the prefix
+      used for creating FIT configuration nodes. Its default value is "conf-".
+
    :term:`FIT_DESC`
       Specifies the description string encoded into a FIT image. The
       default value is set by the :ref:`ref-classes-kernel-fit-image` class as

-- 
2.50.1

[PATCH 08/19] ref-manual/variables.rst: add link for BB_DEFER_BBCLASSES

[Antonin Godard]

Added by commit 8e741b2e885a ("ast/BBHandler: Add support for
BB_DEFER_BBCLASSES") in BitBake.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/variables.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 25879b9b4..bd82b9484 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -406,6 +406,9 @@ system and gives an overview of their function and contents.
    :term:`BB_DEFAULT_UMASK`
       See :term:`bitbake:BB_DEFAULT_UMASK` in the BitBake manual.
 
+   :term:`BB_DEFER_BBCLASSES`
+      See :term:`bitbake:BB_DEFER_BBCLASSES` in the BitBake manual.
+
    :term:`BB_DISKMON_DIRS`
       Monitors disk space and available inodes during the build and allows
       you to control the build based on these parameters.

-- 
2.50.1

[PATCH 09/19] ref-manual/variables.rst: document SPL_DTB_BINARY

[Antonin Godard]

This variable is part of uboot-sign but not documented.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/classes.rst   | 3 +++
 documentation/ref-manual/variables.rst | 5 +++++
 2 files changed, 8 insertions(+)

diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index 748f0395c..0f4405b98 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -3166,6 +3166,9 @@ The variables used by this class are:
 -  :term:`SPL_SIGN_ENABLE`: enable signing the FIT image.
 -  :term:`SPL_SIGN_KEYDIR`: directory containing the signing keys.
 -  :term:`SPL_SIGN_KEYNAME`: base filename of the signing keys.
+-  :term:`SPL_DTB_BINARY`: Name of the SPL device tree binary. Can be set to an
+   empty string to indicate that no SPL should be created and added to the FIT
+   image.
 -  :term:`UBOOT_FIT_ADDRESS_CELLS`: ``#address-cells`` value for the FIT image.
 -  :term:`UBOOT_FIT_DESC`: description string encoded into the FIT image.
 -  :term:`UBOOT_FIT_GENERATE_KEYS`: generate the keys if they don't exist yet.
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index bd82b9484..d722d722f 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -8875,6 +8875,11 @@ system and gives an overview of their function and contents.
       section in the Yocto Project Board Support Package Developer's Guide
       for additional information.
 
+   :term:`SPL_DTB_BINARY`
+      When inheriting the :ref:`ref-classes-uboot-sign` class, the
+      :term:`SPL_DTB_BINARY` variable contains the name of the SPL binary to be
+      compiled.
+
    :term:`SPL_MKIMAGE_DTCOPTS`
       Options for the device tree compiler passed to ``mkimage -D`` feature
       while creating a FIT image with the :ref:`ref-classes-uboot-sign`

-- 
2.50.1

[PATCH 10/19] ref-manual/variables.rst: document UBOOT_VERSION

[Antonin Godard]

Added by commit debc691853e2 ("u-boot: Allow for customizing
installed/deployed file names") in OE-Core.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/variables.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index d722d722f..a41fa951a 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -10804,6 +10804,12 @@ system and gives an overview of their function and contents.
       passes and uses "all" for the target during the U-Boot building
       process.
 
+   :term:`UBOOT_VERSION`
+      When naming the files that are installed and deployed, the package version
+      (:term:`PV`) and revision (:term:`PR`) are part of the filename. The
+      :term:`UBOOT_VERSION` variable contains this information, but can be
+      overridden if desired.
+
    :term:`UKIFY_CMD`
       When inheriting the :ref:`ref-classes-uki` class,
       `ukify <https://www.freedesktop.org/software/systemd/man/latest/ukify.html>`__ command to build

-- 
2.50.1

[PATCH 11/19] ref-manual/classes.rst: document the go-mod-update-modules class

[Antonin Godard]

Added by commit 34bb889ffaae ("classes/go-mod-update-modules: add class
to generate module list") in OE-Core.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/classes.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index 0f4405b98..586930f66 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -1003,6 +1003,21 @@ The :ref:`ref-classes-go-mod` class allows to use Go modules, and inherits the
 
 See the associated :term:`GO_WORKDIR` variable.
 
+.. _ref-classes-go-mod-update-modules:
+
+``go-mod-update-modules``
+=========================
+
+The :ref:`ref-classes-go-mod-update-modules` class can be used in Go recipes and
+defines a ``do_update_modules`` task that can be run manually to update two
+files ("BPN" below corresponds to :term:`BPN`):
+
+-  ``BPN-go-mods.inc``: list of Go modules the recipe depends on.
+-  ``BPN-licenses.inc``: list of licenses for each Go modules the recipe depends
+   on.
+
+These files can then updated automatically with the ``do_update_modules`` task.
+
 .. _ref-classes-go-vendor:
 
 ``go-vendor``

-- 
2.50.1

[PATCH 12/19] ref-manual/variables.rst: document OE_SHARED_UMASK

[Antonin Godard]

Added by commit ce32daa9843b ("bitbake.conf/sstate: Introduce
OE_SHARED_UMASK to standarise shared area umask") in OE-Core.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/variables.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index a41fa951a..d918446db 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -6230,6 +6230,11 @@ system and gives an overview of their function and contents.
       If you use a custom script to set up your build environment, set the
       :term:`OE_INIT_ENV_SCRIPT` variable to its name.
 
+   :term:`OE_SHARED_UMASK`
+      The :term:`OE_SHARED_UMASK` variable contains the :manpage:`umask`
+      definition for shared files (for example files in :term:`SSTATE_DIR` or
+      :term:`DL_DIR`).
+
    :term:`OE_TERMINAL`
       Controls how the OpenEmbedded build system spawns interactive
       terminals on the host development system (e.g. using the BitBake

-- 
2.50.1

[PATCH 13/19] ref-manual/variables.rst: document CVE_CHECK_VEX_JUSTIFICATION

[Antonin Godard]

Added by commit c0fa3d92cefa ("spdx30: Allow VEX Justification to be
configurable") in OE-Core.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/variables.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index d918446db..3369bf67f 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -2054,6 +2054,13 @@ system and gives an overview of their function and contents.
 
          CVE_CHECK_STATUSMAP[cpe-incorrect] = "Ignored"
 
+   :term:`CVE_CHECK_VEX_JUSTIFICATION`
+      Mapping variable for :term:`CVE_STATUS` reasons
+      (for example ``not-applicable-platform``) to :ref:`ref-classes-vex`
+      justifications. Should be set as follows::
+
+         CVE_CHECK_VEX_JUSTIFICATION[not-applicable-config] = "vulnerableCodeNotPresent"
+
    :term:`CVE_VERSION`
       In a recipe, defines the version used to match the recipe version
       against the version in the `NIST CVE database <https://nvd.nist.gov/>`__

-- 
2.50.1

[PATCH 14/19] ref-manual/classes.rst: document the testexport class

[Antonin Godard]

This class has been in OE-Core for a while but never documented in the
reference manual. Add some description for it and link to the existing
documentation on it.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/classes.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index 586930f66..d12b1c56b 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -2968,6 +2968,22 @@ class assuming :term:`PATCHRESOLVE` is set to "user", the
 :ref:`ref-classes-cml1` class, and the :ref:`ref-classes-devshell` class all
 use the :ref:`ref-classes-terminal` class.
 
+.. _ref-classes-testexport:
+
+``testexport``
+==============
+
+Based on the :ref:`ref-classes-testimage` class, the
+:ref:`ref-classes-testexport` class can be used to export the test environment
+outside of the :term:`OpenEmbedded Build System`. This will generate the
+directory structure to execute the runtime tests using the
+:oe_git:`runexported.py </openembedded-core/tree/meta/lib/oeqa/runexported.py>`
+Python script.
+
+For more details on how to use :ref:`ref-classes-testexport`, see
+the :ref:`test-manual/runtime-testing:Exporting Tests` section in the Yocto
+Project Test Environment Manual.
+
 .. _ref-classes-testimage:
 
 ``testimage``

-- 
2.50.1

[PATCH 15/19] docs-wide: update wic source plugin names

[Antonin Godard]

WIC plugins were renamed after commit 2de444fc3ef4 ("wic: plugins source
bootimage/isoimage rename to allow be imported") in OE-Core. They no
longer contain dashes, but underscores.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/bsp-guide/bsp.rst        |  4 ++--
 documentation/dev-manual/wic.rst       | 16 ++++++++--------
 documentation/ref-manual/classes.rst   |  2 +-
 documentation/ref-manual/variables.rst |  4 ++--
 4 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst
index 7eaa4d870..a6444d9af 100644
--- a/documentation/bsp-guide/bsp.rst
+++ b/documentation/bsp-guide/bsp.rst
@@ -1425,8 +1425,8 @@ Project Reference Manual.
 
 -  :term:`IMAGE_BOOT_FILES`:
    Files installed into the device's boot partition when preparing the
-   image using the Wic tool with the ``bootimg-partition`` or
-   ``bootimg-efi`` source plugin.
+   image using the Wic tool with the ``bootimg_partition`` or
+   ``bootimg_efi`` source plugin.
 
 BSP Kernel Recipe Example
 -------------------------
diff --git a/documentation/dev-manual/wic.rst b/documentation/dev-manual/wic.rst
index fced0e170..07170537b 100644
--- a/documentation/dev-manual/wic.rst
+++ b/documentation/dev-manual/wic.rst
@@ -309,7 +309,7 @@ Here are the actual partition language commands used in the
 
    # short-description: Create an EFI disk image for genericx86*
    # long-description: Creates a partitioned EFI disk image for genericx86* machines
-   part /boot --source bootimg-efi --sourceparams="loader=grub-efi" --ondisk sda --label msdos --active --align 1024
+   part /boot --source bootimg_efi --sourceparams="loader=grub-efi" --ondisk sda --label msdos --active --align 1024
    part / --source rootfs --ondisk sda --fstype=ext4 --label platform --align 1024 --use-uuid
    part swap --ondisk sda --size 44 --label swap1 --fstype=swap
 
@@ -348,7 +348,7 @@ populate a specific Wic image partition.
 
 Source plugins are subclasses of the ``SourcePlugin`` class, which is
 defined in the ``poky/scripts/lib/wic/pluginbase.py`` file. For example,
-the ``BootimgEFIPlugin`` source plugin found in the ``bootimg-efi.py``
+the ``BootimgEFIPlugin`` source plugin found in the ``bootimg_efi.py``
 file is a subclass of the ``SourcePlugin`` class, which is found in the
 ``pluginbase.py`` file.
 
@@ -365,14 +365,14 @@ implementation, it looks for the plugin with the same name as the
 partition. For example, if the partition is set up using the following
 command in a kickstart file::
 
-   part /boot --source bootimg-pcbios --ondisk sda --label boot --active --align 1024
+   part /boot --source bootimg_pcbios --ondisk sda --label boot --active --align 1024
 
 The methods defined as class
-members of the matching source plugin (i.e. ``bootimg-pcbios``) in the
-``bootimg-pcbios.py`` plugin file are used.
+members of the matching source plugin (i.e. ``bootimg_pcbios``) in the
+``bootimg_pcbios.py`` plugin file are used.
 
 To be more concrete, here is the corresponding plugin definition from
-the ``bootimg-pcbios.py`` file for the previous command along with an
+the ``bootimg_pcbios.py`` file for the previous command along with an
 example method called by the Wic implementation when it needs to prepare
 a partition using an implementation-specific function::
 
@@ -384,7 +384,7 @@ a partition using an implementation-specific function::
        Create MBR boot partition and install syslinux on it.
        """
 
-      name = 'bootimg-pcbios'
+      name = 'bootimg_pcbios'
                 .
                 .
                 .
@@ -550,7 +550,7 @@ changes all instances of "``--ondisk sda``" to "``--ondisk sdb``". The
 example changes the following two lines and leaves the remaining lines
 untouched::
 
-   part /boot --source bootimg-pcbios --ondisk sdb --label boot --active --align 1024
+   part /boot --source bootimg_pcbios --ondisk sdb --label boot --active --align 1024
    part / --source rootfs --ondisk sdb --fstype=ext4 --label platform --align 1024 --use-uuid
 
 Once the lines are changed, the
diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index d12b1c56b..662121ed9 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -3265,7 +3265,7 @@ The variables used by this class are:
    :oe_git:`meta/conf/image-uefi.conf
    </openembedded-core/tree/meta/conf/image-uefi.conf>`
 -  :term:`IMAGE_EFI_BOOT_FILES`: files to install to EFI boot partition
-   created by the ``bootimg-efi`` Wic plugin
+   created by the ``bootimg_efi`` Wic plugin
 -  :term:`INITRAMFS_IMAGE`: initramfs recipe name
 -  :term:`KERNEL_DEVICETREE`: optional devicetree files to embed into UKI
 -  :term:`UKIFY_CMD`: `ukify
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 3369bf67f..cefbfd096 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -3839,7 +3839,7 @@ system and gives an overview of their function and contents.
    :term:`IMAGE_BOOT_FILES`
       A space-separated list of files installed into the boot partition
       when preparing an image using the Wic tool with the
-      ``bootimg-partition`` source plugin. By default,
+      ``bootimg_partition`` source plugin. By default,
       the files are
       installed under the same name as the source files. To change the
       installed name, separate it from the original name with a semi-colon
@@ -3917,7 +3917,7 @@ system and gives an overview of their function and contents.
    :term:`IMAGE_EFI_BOOT_FILES`
       A space-separated list of files installed into the boot partition
       when preparing an image using the Wic tool with the
-      ``bootimg-efi`` source plugin. By default,
+      ``bootimg_efi`` source plugin. By default,
       the files are
       installed under the same name as the source files. To change the
       installed name, separate it from the original name with a semi-colon

-- 
2.50.1

[PATCH 16/19] ref-manual/tasks.rst: do_package_qa: update link to qa checks

[Antonin Godard]

Link to the updated qa-checks document that contains the entire list of
checks. The insane class was recently updated to remove all its checks
description and move them to qa-checks.rst.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/tasks.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/documentation/ref-manual/tasks.rst b/documentation/ref-manual/tasks.rst
index d7b19e04b..90f70c1ac 100644
--- a/documentation/ref-manual/tasks.rst
+++ b/documentation/ref-manual/tasks.rst
@@ -225,7 +225,7 @@ section in the Yocto Project Overview and Concepts Manual.
 -----------------
 
 Runs QA checks on packaged files. For more information on these checks,
-see the :ref:`ref-classes-insane` class.
+see the :doc:`/ref-manual/qa-checks` document.
 
 .. _ref-tasks-package_write_deb:
 

-- 
2.50.1

[PATCH 17/19] ref-manual/qa-checks.rst: add space around equal warning

[Antonin Godard]

After commit 24772dd2ae6c ("parse/ConfHandler: Add warning for
deprecated whitespace usage") in BitBake, a warning is printed is
there's a missing space around an equal assignment in recipes.

Add a qa-check entry to qa-checks.rst.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/qa-checks.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/documentation/ref-manual/qa-checks.rst b/documentation/ref-manual/qa-checks.rst
index 91a0f6149..69ecad74b 100644
--- a/documentation/ref-manual/qa-checks.rst
+++ b/documentation/ref-manual/qa-checks.rst
@@ -649,6 +649,22 @@ Errors and Warnings
     on the operating system. If you are seeing this message then the specified script
     may need to be patched to have a shorter in order to avoid runtime problems.
 
+.. _qa-check-space-around-equal:
+
+-  ``<filename>:<line number> has a lack of whitespace around the assignment: '<assignment>'``
+
+   This warning indicated that there is missing spaces around an assignment.
+
+   For example, the following assignments would print a warning::
+
+      FOO="bar"
+      FOO= "bar"
+      FOO ="bar"
+
+   These should be replaced by::
+
+      FOO = "bar"
+
 .. _qa-check-src-uri-bad:
 
 - ``<recipename>: SRC_URI uses unstable GitHub archives [src-uri-bad]``

-- 
2.50.1

[PATCH 18/19] docs-wide: fix space around equal assignments

[Antonin Godard]

Since commit 24772dd2ae6c ("parse/ConfHandler: Add warning for
deprecated whitespace usage") in BitBake, a warning is printed when
there are no spaces around an `=` assignment.

Adjust the documentation to show good examples only.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/dev-manual/building.rst   | 8 ++++----
 documentation/dev-manual/layers.rst     | 2 +-
 documentation/dev-manual/new-recipe.rst | 2 +-
 documentation/dev-manual/qemu.rst       | 4 ++--
 documentation/ref-manual/variables.rst  | 6 +++---
 5 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/documentation/dev-manual/building.rst b/documentation/dev-manual/building.rst
index 32c7aa5da..04c150094 100644
--- a/documentation/dev-manual/building.rst
+++ b/documentation/dev-manual/building.rst
@@ -243,9 +243,9 @@ Bundling an Initramfs Image From a Separate Multiconfig
 
 There may be a case where we want to build an :term:`Initramfs` image which does not
 inherit the same distro policy as our main image, for example, we may want
-our main image to use ``TCLIBC="glibc"``, but to use ``TCLIBC="musl"`` in our :term:`Initramfs`
+our main image to use ``TCLIBC = "glibc"``, but to use ``TCLIBC = "musl"`` in our :term:`Initramfs`
 image to keep a smaller footprint. However, by performing the steps mentioned
-above the :term:`Initramfs` image will inherit ``TCLIBC="glibc"`` without allowing us
+above the :term:`Initramfs` image will inherit ``TCLIBC = "glibc"`` without allowing us
 to override it.
 
 To achieve this, you need to perform some additional steps:
@@ -255,8 +255,8 @@ To achieve this, you need to perform some additional steps:
    For the sake of simplicity let's assume such multiconfig is called: ``initramfscfg.conf`` and
    contains the variables::
 
-      TMPDIR="${TOPDIR}/tmp-initramfscfg"
-      TCLIBC="musl"
+      TMPDIR = "${TOPDIR}/tmp-initramfscfg"
+      TCLIBC = "musl"
 
 #. *Set additional Initramfs variables on your main configuration:*
    Additionally, on your main configuration (``local.conf``) you need to set the
diff --git a/documentation/dev-manual/layers.rst b/documentation/dev-manual/layers.rst
index 67482bf54..fbf3f1a33 100644
--- a/documentation/dev-manual/layers.rst
+++ b/documentation/dev-manual/layers.rst
@@ -609,7 +609,7 @@ file is in the layer at ``recipes-graphics/xorg-xserver``::
        file://xorg.conf.d/99-calibration.conf \
    "
    do_install:append:rpi () {
-       PITFT="${@bb.utils.contains("MACHINE_FEATURES", "pitft", "1", "0", d)}"
+       PITFT = "${@bb.utils.contains("MACHINE_FEATURES", "pitft", "1", "0", d)}"
        if [ "${PITFT}" = "1" ]; then
            install -d ${D}/${sysconfdir}/X11/xorg.conf.d/
            install -m 0644 ${UNPACKDIR}/xorg.conf.d/98-pitft.conf ${D}/${sysconfdir}/X11/xorg.conf.d/
diff --git a/documentation/dev-manual/new-recipe.rst b/documentation/dev-manual/new-recipe.rst
index 832aa300e..aa4fb97a4 100644
--- a/documentation/dev-manual/new-recipe.rst
+++ b/documentation/dev-manual/new-recipe.rst
@@ -298,7 +298,7 @@ a ``+`` sign in its definition. Here is an example from the recipe
    SRC_URI = "git://github.com/stevenhoneyman/l3afpad.git;branch=master;protocol=https"
 
    PV = "0.8.18.1.11+git"
-   SRCREV ="3cdccdc9505643e50f8208171d9eee5de11a42ff"
+   SRCREV = "3cdccdc9505643e50f8208171d9eee5de11a42ff"
 
 If your :term:`SRC_URI` statement includes URLs pointing to individual files
 fetched from a remote server other than a version control system,
diff --git a/documentation/dev-manual/qemu.rst b/documentation/dev-manual/qemu.rst
index 92c93a82a..9e0b8b813 100644
--- a/documentation/dev-manual/qemu.rst
+++ b/documentation/dev-manual/qemu.rst
@@ -424,9 +424,9 @@ command line:
    in the :term:`Build Directory` ``deploy/image`` directory.
    Examples::
 
-      QB_SLIRP_OPT="-netdev user,id=net0,hostfwd=tcp::8080-:80"
+      QB_SLIRP_OPT = "-netdev user,id=net0,hostfwd=tcp::8080-:80"
 
-      QB_SLIRP_OPT="-netdev user,id=net0,hostfwd=tcp::8080-:80,hostfwd=tcp::2222-:22"
+      QB_SLIRP_OPT = "-netdev user,id=net0,hostfwd=tcp::8080-:80,hostfwd=tcp::2222-:22"
 
    The first example forwards TCP port 80 from the emulated system to
    port 8080 (or the next free port) on the host system,
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index cefbfd096..e4d5a9c97 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -3360,7 +3360,7 @@ system and gives an overview of their function and contents.
       Here is an example setting "0x400000000" as a load address::
 
          FIT_ADDRESS_CELLS = "2"
-         UBOOT_LOADADDRESS= "0x04 0x00000000"
+         UBOOT_LOADADDRESS = "0x04 0x00000000"
 
       See `more details about #address-cells <https://elinux.org/Device_Tree_Usage#How_Addressing_Works>`__.
 
@@ -4101,7 +4101,7 @@ system and gives an overview of their function and contents.
       The :ref:`rootfs-postcommands <ref-classes-rootfs*>` class defines the manifest
       file as follows::
 
-         IMAGE_MANIFEST ="${IMGDEPLOYDIR}/${IMAGE_NAME}${IMAGE_NAME_SUFFIX}.manifest"
+         IMAGE_MANIFEST = "${IMGDEPLOYDIR}/${IMAGE_NAME}${IMAGE_NAME_SUFFIX}.manifest"
 
       The location is
       derived using the :term:`IMGDEPLOYDIR`
@@ -10496,7 +10496,7 @@ system and gives an overview of their function and contents.
       Here is an example setting "0x400000000" as a load address::
 
          UBOOT_FIT_ADDRESS_CELLS = "2"
-         UBOOT_LOADADDRESS= "0x04 0x00000000"
+         UBOOT_LOADADDRESS = "0x04 0x00000000"
 
       See `more details about #address-cells <https://elinux.org/Device_Tree_Usage#How_Addressing_Works>`__.
 

-- 
2.50.1

[PATCH 19/19] migration-guides/release-notes-5.3: updates

[Antonin Godard]

Update the release notes and migration manual for 5.3.

This covers commits from c4a5e590b53b ("rust-llvm: Compile llvm to use
dynamic libraries") to 2a832e6af1b6 ("orc: set CVE_PRODUCT") in Poky.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/migration-guides/migration-5.3.rst   |  89 ++++
 .../migration-guides/release-notes-5.3.rst         | 564 ++++++++++++++++++++-
 2 files changed, 648 insertions(+), 5 deletions(-)

diff --git a/documentation/migration-guides/migration-5.3.rst b/documentation/migration-guides/migration-5.3.rst
index 4d2e1763c..97e41605f 100644
--- a/documentation/migration-guides/migration-5.3.rst
+++ b/documentation/migration-guides/migration-5.3.rst
@@ -64,6 +64,60 @@ The first change can introduce a lot of consecutive empty lines, so those can be
 
    sed -i -z -E 's/([ \t\f\v\r]*\n){3,}/\n\n/g' `find . -name *.bb -o -name *.inc`
 
+
+BitBake Git fetcher ``tag`` parameter
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The ``tag=`` parameter of the Git fetcher (``git://``) was updated. The tag
+commit SHA will be compared against the value supplied by the :term:`SRCREV`
+variable or the ``rev=`` parameter in the URI in :term:`SRC_URI`. This is
+strongly recommended to add to the URIs when using the Git fetcher for
+repositories using tag releases.
+
+Space around equal assignment
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+A new warning is now printed when there are no whitespaces around an ``=``
+assignment in recipes::
+
+   <filename>:<line number> has a lack of whitespace around the assignment: '<assignment>'
+
+For example, the following assignments would print a warning::
+
+   FOO="bar"
+   FOO= "bar"
+   FOO ="bar"
+
+These should be replaced by::
+
+   FOO = "bar"
+
+Wic plugins containing dashes should be renamed
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+After a Python upgrade, :ref:`Wic <dev-manual/wic:creating partitioned images
+using wic>` plugins containing dashes (``-``) for their filenames are **no
+longer supported**. One must rename the plugin file and convert the dashes to
+underscores (``_``).
+
+It is also recommended to update any WKS file to convert dashes to underscores.
+For example, the ``bootimg-partition.py`` plugin was renamed to
+``bootimg_partition.py``. This means that any WKS file using this plugin must
+change each ``--source bootimg-partition`` to ``--source bootimg_partition``.
+
+However, the current WIC code automatically converts dashes to underscore for
+any ``--source`` call, so existing WKS files will not break if they use upstream
+plugins from :term:`OpenEmbedded-Core (OE-Core)`.
+
+``fitImage`` no longer supporter for :term:`KERNEL_IMAGETYPE`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The ``fitImage`` type for :term:`KERNEL_IMAGETYPE` is no longer supported. The
+logic for creating a FIT image was moved out of the :ref:`ref-classes-kernel`
+class. Instead, one should create a new recipe to build this FIT image, as
+described in the :ref:`Removed Classes <migration-guides/migration-5.3:Removed
+Classes>` section of the Migration notes for |yocto-ver| (|yocto-codename|).
+
 Supported kernel versions
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -99,11 +153,38 @@ Removed variables
 
 The following variables have been removed:
 
+-  ``BUILDHISTORY_RESET``: Setting this to non-empty used to remove the old
+   content of the :ref:`ref-classes-buildhistory` as part of the current
+   :term:`BitBake` invocation and replace it with information about what was
+   built during the build. This was partly broken and hard to maintain.
+
 Removed recipes
 ~~~~~~~~~~~~~~~
 
 The following recipes have been removed in this release:
 
+-  ``libsoup``: The last user in :term:`OpenEmbedded-Core (OE-Core)` was
+   ``gst-examples``, which has been upgraded with its ``libsoup`` dependency
+   dropped.
+
+-  ``glibc-y2038-tests``: removed as the recipe only provides tests which are
+   now provided by ``glibc-testsuite``.
+
+-  ``python3-ndg-httpsclient``: The last dependency in core on this recipe was
+   removed in May 2024 with dfa482f1998 ("python3-requests: cleanup RDEPENDS"),
+   and there is no other user of this variable.
+
+Removed :term:`PACKAGECONFIG` entries
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+-  ``dropbear``: ``enable-x11-forwarding`` (renamed to ``x11``)
+
+-  ``libxml2``: ``ipv6``
+
+-  ``squashfs-tools``: ``reproducible``
+
+-  ``mesa``: ``kmsro``, ``osmesa``, ``xa``
+
 Removed classes
 ~~~~~~~~~~~~~~~
 
@@ -151,6 +232,11 @@ The following classes have been removed in this release:
 
    See the :ref:`ref-classes-kernel-fit-image` section for more information.
 
+-  ``icecc.bbclass``: Reports show that this class has been broken since Yocto
+   Mickledore which suggests there are limited numbers of users. It doesn't have
+   any automated testing and it would be hard to setup and maintain a testing
+   environment for it. The original users/maintainers aren't using it now.
+
 Removed features
 ~~~~~~~~~~~~~~~~
 
@@ -158,3 +244,6 @@ The following features have been removed in this release:
 
 Miscellaneous changes
 ~~~~~~~~~~~~~~~~~~~~~
+
+-  ``xserver-xorg``: remove sub-package ``${PN}-xwayland``, as ``xwayland`` is
+   now its own recipe.
diff --git a/documentation/migration-guides/release-notes-5.3.rst b/documentation/migration-guides/release-notes-5.3.rst
index 181f1a401..92c718e24 100644
--- a/documentation/migration-guides/release-notes-5.3.rst
+++ b/documentation/migration-guides/release-notes-5.3.rst
@@ -11,63 +11,617 @@ Release notes for |yocto-ver| (|yocto-codename|)
 New Features / Enhancements in |yocto-ver|
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
--  Linux kernel XXX, gcc XXX, glibc XXX, LLVM XXX, and over XXX other
+-  Linux kernel XXX, gcc 15, glibc XXX, LLVM XXX, and over XXX other
    recipe upgrades.
 
 -  Minimum Python version required on the host: XXX.
 
+-  BitBake changes:
+
+   -  ``codeparser``: Add function decorators for ``vardeps``
+
+      Adds ``bb.parse.vardeps`` and ``bb.parse.excludevardeps`` function
+      decorators that can be used to explicitly add or exclude variables from a
+      Python function parsed by :term:`BitBake`.
+
+      Move ``vardepexclude`` flag entries alongside functions for
+      maintainability.
+
+   -  Fetcher:
+
+      -  Check for ``git-lfs`` existence before using it.
+
+      -  Add support for ``.debs`` files containing uncompressed data tarballs.
+
+      -  ``az``: Add sanity check to check that :term:`AZ_SAS` starts with ``?``
+         to mark the start of the query parameters.
+
+      -  ``git``: Add the tag to shallow clone tarball name.
+
+   -  ``knotty``: pass failed task logs through the log infrastructure (use
+      ``bb.plain()`` instead of ``print()``)
+
+   -  Add support for automatically promoting class inherits to deferred
+      inherits by listing them in the :term:`BB_DEFER_BBCLASSES` variable.
+
+   -  "Built-in" fragments support is now added to the :ref:`addfragments
+      <bitbake-user-manual/bitbake-user-manual-metadata:\`\`addfragments\`\`
+      directive>` directive. This is the fourth parameter to this directive, and
+      should be the name of the variable that contains definitions of built-in
+      fragments. Refer to the documentation of :ref:`addfragments
+      <bitbake-user-manual/bitbake-user-manual-metadata:\`\`addfragments\`\`
+      directive>` to learn how to define new built-in fragments.
+
+      Listing these built-in fragments can be done with
+      :oe_git:`bitbake-config-build
+      list-fragments</bitbake/tree/bin/bitbake-config-build>`, which could
+      list::
+
+         Available built-in fragments:
+         machine/...     Sets MACHINE = ...
+         distro/...      Sets DISTRO = ...
+
+      In the above example, this means that the :term:`MACHINE` of
+      :term:`DISTRO` can be overridden with::
+
+         OE_FRAGMENTS += "machine/qemuarm64 distro/poky-bleeding"
+
+      This would set :term:`MACHINE` to ``qemuarm64`` and the :term:`DISTRO` to
+      ``poky-bleeding``.
+
+   -  The ``tag-`` parameter in URLs can now be specified alongside the ``rev=``
+      parameter and :term:`SRCREV` variable, and will ensure that the
+      specified tag matches the specified revision.
+
+      It is **strongly encouraged** to include the ``tag=`` parameter to the
+      :term:`SRC_URI` definition when possible.
+
+   -  ``tinfoil``: add a ``wait_for`` decorator to wrap a function that makes an
+      asynchronous tinfoil call wait for event to say that the call has been
+      successful, or an error has occurred.
+
+   -  New ``bb.utils.to_filemode()`` helper function which is a helper to take a
+      variable's content containing a filemode and convert it to the proper
+      Python representation of the number.
+
+   -  ``cooker``: Use a shared counter for processing parser jobs. This allows
+      the parser processes to run independently of needing to be feed by the
+      parent process, and load balances them much better.
+
+   -  ``cooker/process/utils``: Add a ``-P`` (``--profile``) option to
+      :term:`BitBake` to specify what to profile. Can be "main", "idle" or
+      "parsing". Split the reports in separate files.
+
+-  Toolchain changes:
+
+   -  The Clang/LLVM toolchain can now be used as part of the build.
+
+      The :term:`PREFERRED_TOOLCHAIN_TARGET`, :term:`PREFERRED_TOOLCHAIN_NATIVE`
+      and :term:`PREFERRED_TOOLCHAIN_SDK` variables can be used to customize the
+      selected toolchain globally.
+
+      There are two supported toolchains: "gcc" and "clang". See the
+      documentation of :term:`PREFERRED_TOOLCHAIN_TARGET` for more details.
+
+      The toolchain is also customizable on a per-recipe basis, using the
+      :term:`TOOLCHAIN` and :term:`TOOLCHAIN_NATIVE` variables.
+
+   -  Multiple recipes were pinned to use the GCC/Binutils toolchain as they do
+      not support being built with Clang/LLVM yet. In these recipes the
+      :term:`TOOLCHAIN` variable is set to "gcc".
+
+-  Global configuration changes:
+
+   -  ``bitbake.conf/pseudo``: Switch from exclusion list to inclusion list by
+      swapping :term:`PSEUDO_IGNORE_PATHS` for :term:`PSEUDO_INCLUDE_PATHS`
+      which should be easier and more explicit to maintain.
+
+   -  ``bitbake.conf``: Drop ``lz4`` from :term:`HOSTTOOLS`, as it is not
+      required anymore, and the ``lz4-native`` package is used instead.
+
+   -  ``conf/fragments``: add a fragment for the CDN :ref:`sstate-cache
+      <overview-manual/concepts:shared state cache>` mirror.
+
+   -  ``default-distrovars``: set an empty default for :term:`LICENSE_PATH`.
+
+   -  The default definition of :term:`UNPACKDIR` is no longer
+      ``sources-unpack`` but ``sources``.
+
 -  New variables:
 
+   -  The ``VIRTUAL-RUNTIME_dbus`` variable, to allow changing the runtime
+      implementation of D-Bus. See :term:`VIRTUAL-RUNTIME`.
+
+   -  The ``VIRTUAL-RUNTIME_libsdl2`` variable, to allow changing the runtime
+      implementation of `libsdl2 <https://www.libsdl.org/>`__. See
+      :term:`VIRTUAL-RUNTIME`.
+
+   -  The :term:`SPDX_PACKAGE_URL` variable can be used in recipes to set the
+      output ``software_packageUrl`` field in their associated SPDX 3.0 output
+      (default value: empty string).
+
+   -  The :term:`KMETA_CONFIG_FEATURES` variable can be used to control
+      :ref:`ref-classes-kernel-yocto` configuration features. For now only
+      ``prefer-modules`` is supported for this variable.
+
+   -  The :term:`TESTSDK_SUITES` variable can be used to control the list of
+      tests run for the :ref:`ref-classes-testsdk` class.
+
+   -  The :term:`UBOOT_FIT_CONF_FIRMWARE` can be used to specify a ``firmware``
+      entry in the configuration node of a FIT image.
+
+   -  The :term:`SPDX_INCLUDE_COMPILED_SOURCES` option allows the same as
+      :term:`SPDX_INCLUDE_SOURCES` but including only the sources used to
+      compile the host tools and the target packages.
+
+   -  The :term:`UBOOT_VERSION` variable holds the package version
+      (:term:`PV`) and revision (:term:`PR`) which are part of the installed and
+      deployed filenames. Users can now override :term:`UBOOT_VERSION` to
+      changes the output filenames.
+
 -  Kernel-related changes:
 
+   -  ``linux/generate-cve-exclusions``: use data from CVEProject instead of
+      the archived https://linuxkernelcves.com.
+
+   -  ``kernel-yocto``: allow annotated options to be modified. For example if
+      the following kernel configuration is set::
+
+         CONFIG_INET_TUNNEL=y # OVERRIDE:$MODULE_OR_Y
+
+      And if the :term:`KMETA_CONFIG_FEATURES` variable contains
+      ``prefer-modules``, ``CONFIG_INET_TUNNEL`` will be set to ``m`` instead of
+      ``y``.
+
+   -  ``kernel-devsrc``: Replace the extra ``System.map`` file with symbolic
+      link.
+
+   -  ``kernel-module-split``: Allow for external configuration files being
+      assigned to the correct kernel module package.
+
+   -  When built for the RISC-V architecture, ensure that the minimum required
+      features set by :term:`TUNE_FEATURES` are set using the
+      :ref:`ref-classes-features_check` class.
+
+   -  ``linux-yocto``: when built for RISC-V, enable features in
+      :term:`KERNEL_FEATURES` based on features listed in :term:`TUNE_FEATURES`.
+
 -  New core recipes:
 
+   -  ``python3-pdm``, ``python3-pdm-backend`` and ``python3-pdm-build-locked``,
+      which are dependencies of ``python3-webcolors``. ``python3-pdm`` itself
+      depends on ``python3-pdm-build-locked``
+
+   -  ``bindgen-cli``: a tool to generate Rust bindings.
+
+   -  ``python3-colorama``: Cross-platform colored terminal text, needed by
+      ``pytest`` as a dependency.
+
+   -  ``libglvnd``: imported from :oe_git:`meta-oe
+      </meta-openembedded/tree/meta-oe>` which provides a vendor neutral
+      approach to handling OpenGL / OpenGL ES / EGL / GLX libraries.
+
+   -  ``python3-sphinx-argparse``: A sphinx extension that automatically
+      documents ``argparse`` commands and options. It is part of
+      ``buildtools-docs-tarball`` for later use in the Yocto Project
+      documentation.
+
+   -  ``python3-sphinx-copybutton``: A sphinx extension that adds a copy button
+      to code blocks in Sphinx. It is part of ``buildtools-docs-tarball`` for later
+      use in the Yocto Project documentation.
+
+   -  LLVM/Clang related recipes:
+
+      -  ``clang``: LLVM based C/C++ compiler.
+
+      -  ``compiler-rt``: LLVM based C/C++ compiler Runtime.
+
+      -  ``libclc``: Implementation of the library requirements of the OpenCL C
+         programming language.
+
+      -  ``libcxx``: new implementation of the C++ standard library, targeting
+         C++11 and above
+
+      -  ``llvm-tblgen-native``: LLVM TableGen binaries for the build host,
+         often used to build LLVM projects.
+
+      -  ``lldb``: LLDB debugger for LLVM projects.
+
+      -  ``llvm-project-source``: canonical git mirror of the LLVM subversion
+         repository.
+
+      -  ``openmp``: LLVM OpenMP compiler Runtime.
+
+  -  ``kernel-signing-keys-native``: this recipe is used in the
+     :ref:`ref-classes-kernel-fit-image` class to generate a pair of RSA
+     public/private key. It replaces the ``do_generate_rsa_keys`` of the
+     :ref:`ref-classes-kernel-fit-image` class.
+
+-  New :term:`DISTRO_FEATURES`:
+
+   -  ``glvnd``, which enables OpenGL Vendor Neutral Dispatch Library
+      support when using recipes such as ``mesa``.
+
 -  New core classes:
 
+   -  The new :ref:`ref-classes-kernel-fit-image` class replaces the previous
+      ``kernel-fitimage`` class. It has been rewritten and improved to fix
+      :yocto_bugs:`bug 12912</show_bug.cgi?id=12912>`. See the :ref:`Removed
+      Classes <migration-guides/migration-5.3:Removed Classes>` section of the
+      Migration notes for |yocto-ver| (|yocto-codename|) for more details on how
+      to switch to this new class.
+
+   -  The new :ref:`ref-classes-go-mod-update-modules` class can be used to
+      maintain Go recipes that use a ``BPN-go-mods.inc`` and
+      ``BPN-licenses.inc`` and update these files automatically.
+
 -  Architecture-specific changes:
 
+   -  Rework the RISC-V :term:`TUNE_FEATURES` to make them based of the RISC-V
+      ISA (Instruction Set Architecture) implementation.
+
+      This implements the following base ISAs:
+
+      -  ``rv32i``, ``rv64i``
+      -  ``rv32e``, ``rv64i``
+
+      The following ABIs:
+
+      -  ``ilp32``, ``ilp32e``, ``ilp32f``, ``ilp32d``
+      -  ``lp64``, ``lp64e``, ``lp64f``, ``lp64d``
+
+      The following ISA extension are also implemented:
+
+      -  M: Integer Multiplication and Division Extension
+      -  A: Atomic Memory Extension
+      -  F: Single-Precision Floating-Point Extension
+      -  D: Double-Precision Floating-Point Extension
+      -  C: Compressed Extension
+      -  B: Bit Manipulation Extension (implies Zba, Zbb, Zbs)
+      -  V: Vector Operations Extension
+      -  Zicsr: Control and Status Register Access Extension
+      -  Zifencei: Instruction-Fetch Fence Extension
+      -  Zba: Address bit manipulation extension
+      -  Zbb: Basic bit manipulation extension
+      -  Zbc: Carry-less multiplication extension
+      -  Zbs: Single-bit manipulation extension
+      -  Zicbom: Cache-block management extension
+
+      The existing processors tunes are preserved:
+
+      -  ``riscv64`` (``rv64gc``)
+      -  ``riscv32`` (``rv32gc``)
+      -  ``riscv64nf`` (``rv64imac_zicsr_zifencei``)
+      -  ``riscv32nf`` (``rv32imac_zicsr_zifencei``)
+      -  ``riscv64nc`` (``rv64imafd_zicsr_zifencei``)
+
+      See :oe_git:`meta/conf/machine/include/riscv/README
+      </openembedded-core/tree/meta/conf/machine/include/riscv/README>` for more
+      information.
+
+   -  ``arch-mips.inc``: Use ``-EB``/``-EL`` for denoting Endianness.
+
+   -  Enable ``riscv32`` as supported arch for ``musl`` systems.
+
+   -  Powerpc: Use ``-maltivec`` in compiler flags if ``altivec`` is in
+      :term:`TUNE_FEATURES`.
+
 -  QEMU / ``runqemu`` changes:
 
+   -  Refactor :ref:`ref-classes-qemu` functions into library functions (in
+      :oe_git:`lib/oe/qemu.py </openembedded-core/tree/meta/lib/oe/qemu.py>`).
+
 -  Documentation changes:
 
+   -  Part of :term:`BitBake` internals are now documented at
+      :yocto_docs:`/bitbake/bitbake-user-manual/bitbake-user-manual-library-functions.html`.
+
+   -  A new :doc:`/dev-manual/limiting-resources` guide was created to help
+      users limit the host resources used by the :term:`OpenEmbedded Build
+      System`.
+
+-  Core library changes:
+
+   -  Add :oe_git:`license_finder.py </openembedded-core/tree/meta/lib/oe/license_finder.py>`,
+      which was extracted from ``recipetool`` to be shared for multiple users.
+      Improve its functionalities.
+
 -  Go changes:
 
 -  Rust changes:
 
+   -  ``rust-llvm``:
+
+      -  Compile LLVM to use dynamic libraries. This reduces the
+         size of ``llvm-rust`` to about a third.
+
+      -  Disable the following feature through configuration
+         (:ref:`ref-tasks-configure`): libedit, benchmarks.
+
 -  Wic Image Creator changes:
 
+   -  After a Python upgrade, WIC plugins containing dashes (``-``) for their
+      filenames are **no longer supported**. One must convert the dashed to
+      underscores (``_``) and update users of the plugins accordingly.
+
+      See the :ref:`migration-guides/migration-5.3:Wic plugins containing dashes
+      should be renamed` section of the Yocto Project 5.3 Migration Guide for
+      more information.
+
+   -  ``wic``: do not ignore :term:`IMAGE_ROOTFS_SIZE` if the Rootfs is
+      modified.
+
+   -  Several improvements in WIC selftests.
+
+   -  ``bootimg_efi.py``: fail build if no binaries are installed.
+
+   -  Add new options to the ``wic`` ``ls``, ``cp``, ``rm``, and ``write``
+      commands:
+
+      -  ``--image-name``: name of the image to use the artifacts from.
+      -  ``--vars``: directory with ``<image>.env`` files that store
+         :term:`BitBake` variables. This directory is usually found in
+         :term:`STAGING_DIR`.
+
 -  SDK-related changes:
 
+   -  Include additional information about Meson setting in the SDK environment
+      setup script (host system, CPU family, etc.).
+
 -  Testing-related changes:
 
+   -  ``bitbake/tests/fetch``: Add tests for ``gitsm`` with git-lfs.
+
+   -  ``bitbake/lib/bb/tests/fetch``: add a test case to ensure Git shallow
+      fetch works for tag containing slashes.
+
+   -  OEQA:
+
+      -  SDK:
+
+         -  Add a test to sanity check that the generated SDK manifest was
+            parsed correctly and isn't empty.
+
+         -  Add a test to verify the manifests are generated correctly.
+
+         -  Add helpers to check for and install packages.
+
+         -  Add check that meson has detected the target correctly.
+
+         -  Simplify test specification and discovery:
+
+            -  Introduce the ``TESTSDK_CASE_DIRS`` variable to specify test
+               directory types, replacing the need to modify the ``default_cases``
+               class member.
+
+            -  Discover tests from configured layers using a common discovery
+               pattern (``<LAYER_DIR>/lib/oeqa/<dirname>/cases``) where
+               ``<dirname>`` is specified in ``TESTSDK_CASE_DIRS``.
+
+            -  The "buildtools" directories were renamed to follow the common
+               discovery pattern (``<LAYER_DIR>/lib/oeqa/<dirname>/cases``) for
+               consistency across all SDK configurations.
+
+      -  ``selftest/reproducible``: Limit memory used by ``diffoscope`` to avoid
+         triggering OOM kills.
+
+      -  Add tests for the :ref:`ref-classes-devicetree` class.
+
+      -  Tests for the :ref:`ref-classes-kernel-fit-image` class have been
+         reworked and improved.
+
+      -  ``data.py``: add ``skipIfNotBuildArch`` decorator, to skip tests if
+         :term:`BUILD_ARCH` is not in present in the specified tuple.
+
+      -  ``selftest``: add new test for toolchain switching.
+
+      -  ``utils/command``: add a fast-path ``get_bb_var()`` that uses
+         ``bitbake-getvar`` instead of ``bitbake -e`` when there is not
+         ``postconfig`` argument passed.
+
+      -  ``core/case``: add file exists assertion test case.
+
+      -  ``context.py``: use :term:`TEST_SUITES` if set.
+
+   -  :ref:`ref-classes-testexport`: capture all tests and data from all layers
+      (instead of the :term:`OpenEmbedded-Core (OE-Core)` layer only).
+
 -  Utility script changes:
 
--  BitBake changes:
+   -  ``sstate-cache-management``: add a ``--dry-run`` argument
+
+   -  ``yocto-check-layer``:
+
+      -  Expect success for ``test_patches_upstream_status``. This means that
+         patch files *must* include an ``Upstream-Status`` to pass with this
+         script.
+
+      -  :ref:`ref-classes-yocto-check-layer` class:
+
+         -  Refactor to be extended easily.
+
+         -  Add a ``check_network_flag`` test that checks that no tasks other
+            than :ref:`ref-tasks-fetch` can access the network.
+
+   -  ``send-error-report``:
+
+      -  Respect URL scheme in server name if it exists.
+
+      -  Drop ``--no-ssl`` as the server URL specifies it with ``http://`` or
+         ``https://``.
+
+   -  ``buildstats.py``:
+
+      -  Extend disk stats support for NVMe and flexible token count.
+
+      -  Add tracking of network I/O per interface.
+
+   -  ``buildstats-diff``: find last two Buildstats files if none are specified.
+
+   -  ``pybootchartgui``: visualize ``/proc/net/dev`` network stats in graphs.
 
 -  Packaging changes:
 
+   -  Export ``debugsources`` in :term:`PKGDESTWORK` as JSON. The source
+      information used during packaging can be use from other tasks to have more
+      detailed information on the files used during the compilation and improve
+      SPDX accuracy.
+
 -  LLVM related changes:
 
+   -  Like ``gcc-source``, the LLVM project sources are part of ``work-shared``
+      under :term:`TMPDIR`. The project codebase is large and sharing it offers
+      performance improvements.
+
 -  SPDX-related changes:
 
--  ``devtool`` changes:
+   -  ``spdx30``: Provide ``software_packageUrl`` field
 
--  Patchtest-related changes:
+   -  ``spdx30_tasks``: Change recipe license to "declared" (instead of
+      "concluded")
+
+   -  ``create-spdx-2.2``: support to override the version of a package in SPDX
+      2 through :term:`SPDX_PACKAGE_VERSION`.
+
+-  ``devtool`` and ``recipetool`` changes:
+
+   -  Use ``lib/oe/license_finder`` to extract the license from source code.
+
+   -  Calculate source paths relative to :term:`UNPACKDIR`.
 
--  :ref:`ref-classes-insane` class related changes:
+   -  Allow ``recipe create`` handlers to specify bitbake tasks to run.
+
+   -  ``create_go``: Use :ref:`ref-classes-go-mod` class instead of
+      :ref:`ref-classes-go-vendor`.
+
+   -  Go recipes are now generated with help of the new
+      :ref:`ref-classes-go-mod-update-modules` class.
+
+   -  Add a new :oe_git:`improve_kernel_cve_report.py
+      </openembedded-core/tree/meta/scripts/contrib/improve_kernel_cve_report.py>`
+      script in ``scripts/contrib`` for post-processing of kernel CVE data.
+
+   -  Handle workspaces for multiconfig.
+
+-  Patchtest-related changes:
 
 -  Security changes:
 
+   -  ``openssl``: add FIPS support. This can be enabled through the ``fips``
+      :term:`PACKAGECONFIG`.
+
 -  :ref:`ref-classes-cve-check` changes:
 
 -  New :term:`PACKAGECONFIG` options for individual recipes:
 
+   -  ``ppp``: ``l2tp``, ``pptp``
+   -  ``dropbear``: ``x11`` (renamed from ``enable-x11-forwarding``)
+   -  ``gdb``: ``source-highlight``
+   -  ``gstreamer1.0-plugins-bad``: ``analytics``
+   -  ``mtd-utils``: ``ubihealthd-service``
+   -  ``openssl``: ``fips``
+   -  ``qemu``: ``sdl-image``, ``pixman``
+   -  ``wget``: ``pcre2``
+   -  ``mesa``: ``asahi``, ``amd``, ``svga``, ``teflon``, ``nouveau``
+
 -  Systemd related changes:
 
+   -  Enable getty generator by default by adding ``serial-getty-generator`` to
+      :term:`PACKAGECONFIG`.
+
 -  :ref:`ref-classes-sanity` class changes:
 
+   -  :ref:`ref-classes-insane`: Move test for invalid :term:`PACKAGECONFIG` to
+      :ref:`ref-tasks-recipe-qa`.
+
+   -  Add ``unimplemented-ptest`` detection for cargo-based tests, allowing to
+      detect when a cargo package has available tests that could be enable with
+      :doc:`Ptest </test-manual/ptest>`.
+
+   -  Add a test for recipe naming/class mismatches.
+
+   -  Add a sanity test for "bad" gcc installs on Ubuntu 24.04. The host should
+      install ``libstdc++-14-dev`` instead of ``libgcc-14-dev`` to avoid build
+      issues when building :ref:`ref-classes-native` with Clang.
+
+-  U-boot related changes:
+
+   -  :ref:`ref-classes-uboot-sign`: Add support for setting firmware property
+      in FIT configuration with :term:`UBOOT_FIT_CONF_FIRMWARE`.
+
+   -  :ref:`ref-classes-uboot-sign`: Add support for signing U-Boot FIT image
+      without an SPL. The :term:`SPL_DTB_BINARY` variable can be set to an empty
+      string to indicate that no SPL is present.
+
+   -  When built for the RISC-V architecture, read the :term:`TUNE_FEATURES`
+      variable to automatically set U-boot configuration options (for example
+      ``CONFIG_RISCV_ISA_F``).
+
 -  Miscellaneous changes:
 
+   -  ``dropbear``: The ``dropbearkey.service`` can now take extra arguments for
+      key generation, through ``/etc/default/dropbear``.
+
+   -  ``initscripts``: add ``log_success_msg``/``log_failure_msg``/``log_warning_msg``
+      functions for logging in initscripts.
+
+   -  ``connman``:
+
+      -  Mark ``iptables`` and ``nftables`` feature of :term:`PACKAGECONFIG`
+         mutually incompatible.
+
+      -  Set ``dns-backend`` automatically to ``systemd-resolved``
+         when ``systemd-resolved`` is part of :term:`DISTRO_FEATURES`.
+
+   -  ``uninative``: show errors if installing fails.
+
+   -  ``meson``: Allow user to override setup command options by exporting
+      ``MESON_SETUP_OPTS`` in a recipe.
+
+   -  :ref:`ref-classes-cmake`: Enhance to emit a native toolchain CMake file.
+      This is part of improvements allowing to use ``clang`` in an SDK.
+
+   -  Fix the runtime version of several recipes (they now return the effective
+      version instead of a default string like "Unknown").
+
+   -  :ref:`ref-classes-module`: add ``KBUILD_EXTRA_SYMBOLS`` to the install
+      command.
+
+   -  ``rpm-sequoia``: add :doc:`Ptest </test-manual/ptest>` support.
+
+   -  ``libunwind``: disable installation of tests directory with
+      ``--disable-tests``, which can be installed with the ``libunwind-ptest``
+      package instead.
+
+   -  ``boost``: add ``process`` library to the list of built libraries.
+
+   -  ``base-files``: add ``nsswitch-resolved.conf``, only installed if
+      ``systemd`` and ``systemd-resolved`` is part of :term:`DISTRO_FEATURES`.
+
+   -  ``nfs-utils``: don't use signals to shut down the NFS server in the
+      associated initscript, instead use ``rpc.nfsd 0``.
+
+   -  ``readline``: enable HOME, END, INSERT, and DELETE key bindings in
+      ``inputrc``.
+
+   -  Switch to a new :ref:`sstate-cache <overview-manual/concepts:shared state
+      cache>` CDN (http://sstate.yoctoproject.org).
+
+   -  :ref:`ref-classes-sstate`: Apply a proper :manpage:`umask` when fetching
+      from :term:`SSTATE_MIRRORS`.
+
+   -  ``kernel-devsrc``: make package version consistent with kernel source (by
+      inheriting :ref:`ref-classes-kernelsrc`).
+
+   -  :ref:`ref-classes-externalsrc`: Always ask Git for location of ``.git``
+      directory (may be different from the default ``${S}/.git``).
+
+   -  :ref:`ref-classes-features_check`: Add support for required
+      :term:`TUNE_FEATURES`.
+
+   -  ``openssh``: limit read access to ``sshd_config`` file (set its filemode
+      to ``0600``).
+
 Known Issues in |yocto-ver|
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

-- 
2.50.1

Re: [PATCH 00/19] Updates from Poky master

[Antonin Godard]

On Tue, 29 Jul 2025 11:56:34 +0200, Antonin Godard wrote:
> Update the documentation with regards to the latest changes on Poky's
> master branch.
> 
> This covers commits from c4a5e590b53b ("rust-llvm: Compile llvm to use
> dynamic libraries") to 2a832e6af1b6 ("orc: set CVE_PRODUCT") in Poky.
> 
> This series depends on:
> https://lore.kernel.org/r/20250724-bb-defer-bbclasses-v1-1-70f1826d4b83@bootlin.com
> and
> https://lore.kernel.org/r/20250728-refactor-qa-checks-v2-0-9e0737979f05@bootlin.com
> 
> [...]

Applied, thanks!

[01/19] ref-manual/tasks.rst: add documentation for do_recipe_qa
        commit: d3f172b600413b58ee51c70e9dd4f69b32fdc5f8
[02/19] ref-manual/variables.rst: document SPDX_PACKAGE_URL
        commit: 108549dae76a582bc98d3b7bd976e0239a6b92a6
[03/19] ref-manual/variables.rst: document KMETA_CONFIG_FEATURES
        commit: 1a9f68b875a78c1c7681ed300111399de97631e6
[04/19] ref-manual/variables.rst: document TESTSDK_SUITES
        commit: fbc6db0ab525c7e46774c01fc595f30d6d0fe3c1
[05/19] ref-manual/variables.rst: document PSEUDO_INCLUDE_PATHS
        commit: 5fc49ee007d22c7dc28c11ea579c804881b9cb8f
[06/19] Drop the icecc class and related variables
        commit: 30c9413c5106bcbcc1600ef16b8d0cece86d8158
[07/19] ref-manual/variables.rst: document the FIT_CONF_PREFIX variable
        commit: 860891492b96eb127af5e7bab6348fca12167c68
[08/19] ref-manual/variables.rst: add link for BB_DEFER_BBCLASSES
        commit: bf3c2ade55e4d90dd50f39d01405352cd48c1703
[09/19] ref-manual/variables.rst: document SPL_DTB_BINARY
        commit: 05eb461cb1da76ad9cbaf634da7f47447b3f6765
[10/19] ref-manual/variables.rst: document UBOOT_VERSION
        commit: a9a4bcc754b9400fa6d3c0297e86771f03325590
[11/19] ref-manual/classes.rst: document the go-mod-update-modules class
        commit: b1a9848d2bba9e1392d153ff992304b83b259318
[12/19] ref-manual/variables.rst: document OE_SHARED_UMASK
        commit: b0a6f80a3216faf6c6add785aab2257a53b667dc
[13/19] ref-manual/variables.rst: document CVE_CHECK_VEX_JUSTIFICATION
        commit: cee3eb30cc736d990f2232ede0bc6d9686a63713
[14/19] ref-manual/classes.rst: document the testexport class
        commit: 362a331255525fc853dab3af4ec905c417fabb0b
[15/19] docs-wide: update wic source plugin names
        commit: 7224d7733e9e0f423475e1b9c5b48aff0de1f744
[16/19] ref-manual/tasks.rst: do_package_qa: update link to qa checks
        commit: 0fcd1a352ae364bee191e7d160b2fec35431fcfd
[17/19] ref-manual/qa-checks.rst: add space around equal warning
        commit: da2e9d45a4c70c5d78d225277a85cc4173e4ee7a
[18/19] docs-wide: fix space around equal assignments
        commit: 77ce1544dd793036b1135817c02e090138fe6407
[19/19] migration-guides/release-notes-5.3: updates
        commit: c8d852ad63219d067e497a77d489a4011b0d0a26

Best regards,
-- 
Antonin Godard <antonin.godard@bootlin.com>