diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index aabc71a561..3148d0f154 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -273,12 +273,12 @@
 
                 <para>
                     It is important to realize that if you choose to not install
-                    a package using this variable and some other package is
-                    dependent on it (i.e. listed in a recipe's
+                    packages using this variable and some other packages are
+                    dependent on them (i.e. listed in a recipe's
                     <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link>
-                    variable), the OpenEmbedded build system does not notify
-                    you with a dependency error.
-                    The specified package is simply not installed.
+                    variable), the OpenEmbedded build system ignores your
+                    request and will install the packages to avoid dependency
+                    errors.
                 </para>
 
                 <para>
@@ -3222,9 +3222,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     packages using this variable and some other packages are
                     dependent on them (i.e. listed in a recipe's
                     <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link>
-                    variable), the OpenEmbedded build system does not notify
-                    you with dependency errors.
-                    The packages are simply not installed.
+                    variable), the OpenEmbedded build system ignores your
+                    request and will install the packages to avoid dependency
+                    errors.
                     <note>
                         Some recommended packages might be required for certain
                         system functionality, such as kernel modules.
@@ -3412,14 +3412,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
         <glossentry id='var-PACKAGE_EXCLUDE'><glossterm>PACKAGE_EXCLUDE</glossterm>
             <glossdef>
                 <para>
-                    Lists "recommended-only" packages to not install.
-                    Recommended-only packages are packages installed only
-                    through the
-                    <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>
-                    variable.
-                    You can prevent any of these "recommended" packages from
-                    being installed by listing them with the
-                    <filename>PACKAGE_EXCLUDE</filename> variable:
+                    Lists packages that should not be installed into an image.
+                    For example:
                     <literallayout class='monospaced'>
      PACKAGE_EXCLUDE = "&lt;package_name&gt; &lt;package_name&gt; &lt;package_name&gt; ..."
                     </literallayout>