diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 8bf8aa4ec6..187741bf7e 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -2481,18 +2481,22 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     does not actually satisfy the dependencies, it only states that
                     they should be satisfied.
                     For example, if a hard, runtime dependency
-                    (<filename>RDEPENDS</filename>) of another package is satisfied
+                    (<link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link>)
+                    of another package is satisfied
                     at build time through the <filename>PACKAGES_DYNAMIC</filename>
                     variable, but a package with the module name is never actually
                     produced, then the other package will be broken.
                     Thus, if you attempt to include that package in an image,
                     you will get a dependency failure from the packaging system
                     during <filename>do_rootfs</filename>.
+                </para>
+                <para>
                     Typically, if there is a chance that such a situation can
                     occur and the package that is not created is valid
                     without the dependency being satisfied, then you should use
-                    <filename>RRECOMMENDS</filename> (a soft runtime dependency)
-                    instead of <filename>RDEPENDS</filename>.
+                    <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>
+                    (a soft runtime dependency) instead of
+                    <filename>RDEPENDS</filename>.
                 </para>
 
                 <para>