diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 62e2d0de45..8de8eed25e 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -990,8 +990,8 @@ Core layer for images cannot be removed
 
         <glossentry id='var-EXTRA_IMAGEDEPENDS'><glossterm>EXTRA_IMAGEDEPENDS</glossterm>
             <glossdef>
-                <para>A list of recipes to be built that do not provide packages to be installed in
-                    the root filesystem.
+                <para>A list of recipes to build that do not provide packages
+                    for installing into the root filesystem.
                 </para>
                 <para>Sometimes a recipe is required to build the final image but is not
                     needed in the root filesystem.
@@ -1001,7 +1001,8 @@ Core layer for images cannot be removed
                 </para>
                 <note>
                     To add packages to the root filesystem, see the various
-                    <filename>*DEPENDS</filename> and <filename>*RECOMMENDS</filename>
+                    <filename>*<link linkend='var-RDEPENDS'>RDEPENDS</link></filename>
+                    and <filename>*<link linkend='var-RRECOMMENDS'>RRECOMMENDS</link></filename>
                     variables.
                 </note>
             </glossdef>