From 6a3d16d7b8b9adc096a048e0b2ad463688a23dec Mon Sep 17 00:00:00 2001 From: "Robert P. J. Day" Date: Tue, 24 Feb 2026 10:07:35 -0500 Subject: [PATCH] variables.rst: expand explanation of RSUGGESTS Add that the RSUGGESTS variable would be processed only by a supporting package manager when installing packages from a package feed, and add a link to the appropriate section in the Developers Manual. (From yocto-docs rev: 2c80b891d85e0a7d9b70fc7b4a9c032325b56eca) Signed-off-by: Robert P. J. Day Signed-off-by: Antonin Godard (cherry picked from commit 48c832376cc3d33785d790a3e76b52ed2f8895bf) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker --- documentation/ref-manual/variables.rst | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 29f94dc530..e7e5400d3b 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -7718,7 +7718,9 @@ system and gives an overview of their function and contents. :term:`RSUGGESTS` A list of additional packages that you can suggest for installation by the package manager at the time a package is installed. Not all - package managers support this functionality. + package managers support this functionality. This feature takes effect + only when the package manager is being used to install packages on + the target system from a package feed. As with all package-controlling variables, you must always use this variable in conjunction with a package name override. Here is an @@ -7726,6 +7728,10 @@ system and gives an overview of their function and contents. RSUGGESTS:${PN} = "useful_package another_package" + For more information on package management, see the + :ref:`dev-manual/packages:Using Runtime Package Management` section + of the Yocto Project Development Tasks Manual. + :term:`RUST_CHANNEL` Specifies which version of Rust to build - "stable", "beta" or "nightly". The default value is "stable". Set this at your own risk, as values other