diff mbox series

[v2] variables.rst: expand explanation of RSUGGESTS

Message ID 6fe6124f-27f7-01b4-43f8-b48de5b5db58@crashcourse.ca
State Under Review
Headers show
Series [v2] variables.rst: expand explanation of RSUGGESTS | expand

Commit Message

Robert P. J. Day Feb. 24, 2026, 3:07 p.m. UTC
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.

Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>

---
diff mbox series

Patch

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 208b5e43d..8281d66a2 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -8361,7 +8361,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
@@ -8369,6 +8371,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