1 files changed, 4 insertions, 3 deletions

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index a8b2aa7661..9abfdced0d 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -2785,7 +2785,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
         <glossentry id='var-RRECOMMENDS'><glossterm>RRECOMMENDS</glossterm>
             <glossdef>
                 <para>
-                    A list of packages that extend the usability of a package being
+                    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.
@@ -2810,8 +2810,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     <literallayout class='monospaced'>
      RRECOMMENDS_${PN}-dev += "&lt;wireless_package_name&gt;"
                     </literallayout>
-                    In the example, the package name (<filename>${PN}-dev</filename>) must
-                    appear as it would in the
+                    In the example, the package name
+                    (<filename>${<link linkend='var-PN'>PN</link>}-dev</filename>)
+                    must appear as it would in the
                     <filename><link linkend='var-PACKAGES'>PACKAGES</link></filename> namespace before any
                     renaming of the output package by classes like <filename>debian.bbclass</filename>.
                 </para>