diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 3d4ee92e95..0eb5d98c58 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -7110,31 +7110,40 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
A list of packages that extends the usability of a package
being built.
The package being built does not depend on this list of
- packages in order to successfully build, but needs them for
- the extended usability.
+ packages in order to successfully build, but rather
+ uses them for extended usability.
To specify runtime dependencies for packages, see the
RDEPENDS
variable.
- The OpenEmbedded build process automatically installs the
- list of packages as part of the built package.
- However, you can remove these packages later if you want.
- If, during the build, a package from the
- RRECOMMENDS list cannot be
- found, the build process continues without an error.
-
-
-
- You can also prevent packages in the list from being
- installed by using several variables.
- See the
+ The package manager will automatically install the
+ RRECOMMENDS list of packages when
+ installing the built package.
+ However, you can prevent listed packages from being
+ installed by using the
BAD_RECOMMENDATIONS,
NO_RECOMMENDATIONS,
and
PACKAGE_EXCLUDE
- variables for more information.
+ variables.
+
+
+
+ Packages specified in
+ RRECOMMENDS need not actually be
+ produced.
+ However, a recipe must exist that provides each package,
+ either through the
+ PACKAGES
+ or
+ PACKAGES_DYNAMIC
+ variables or the
+ RPROVIDES
+ variable, or an error will occur during the build.
+ If such a recipe does exist and the package is not produced,
+ the build continues without error.