From 5f0dcc1dc6d97975d538870cb46c7f07f320f064 Mon Sep 17 00:00:00 2001 From: Antonin Godard Date: Mon, 27 Oct 2025 13:43:39 +0100 Subject: [PATCH] ref-manual/variables.rst: document the REQUIRED_MACHINE_FEATURES variable Added in OE-Core commit: 5f4875b950ce ("distro_features_check: expand with MACHINE_FEATURES and COMBINED_FEATURES, rename"). Reviewed-by: Quentin Schulz (From yocto-docs rev: 02d5f9664a71a4f1b72b28d7093c19cc03ec08f6) Signed-off-by: Antonin Godard (cherry picked from commit c0551456cba6016d5014c2be8d6906e58a324cc4) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman --- documentation/ref-manual/variables.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index ec40b3e6fc..3a08f78d30 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -6837,6 +6837,15 @@ system and gives an overview of their function and contents. the recipe will be skipped, and if the build system attempts to build the recipe then an error will be triggered. + :term:`REQUIRED_MACHINE_FEATURES` + When inheriting the :ref:`ref-classes-features_check` class, this variable + identifies :term:`MACHINE_FEATURES` that must exist in the current + configuration in order for the :term:`OpenEmbedded Build System` to build + the recipe. In other words, if the :term:`REQUIRED_MACHINE_FEATURES` variable + lists a feature that does not appear in :term:`MACHINE_FEATURES` within the + current configuration, then the recipe will be skipped, and if the build + system attempts to build the recipe then an error will be triggered. + :term:`REQUIRED_VERSION` If there are multiple versions of a recipe available, this variable determines which version should be given preference.