diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index f3dadf0e62..c82fe31890 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -2610,8 +2610,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
 
         <glossentry id='var-PRINC'><glossterm>PRINC</glossterm>
             <glossdef>
-                <para>Causes the <filename>PR</filename> variable of
-                    <filename>.bbappend</filename> files to dynamically increment.
+                <para>Causes the <link linkend='var-PR'><filename>PR</filename></link>
+                    variable of <filename>.bbappend</filename> files to
+                    dynamically increment.
                     This increment minimizes the impact of layer ordering.</para>
                 <para>In order to ensure multiple <filename>.bbappend</filename> files can co-exist,
                     <filename>PRINC</filename> should be self referencing.
@@ -2622,7 +2623,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     </literallayout>
                     It is adviseable not to use strings such as ".= '.1'" with the variable because
                     this usage is very sensitive to layer ordering.
-                    Explicit assignments should be avoided as they cannot adequately represent multiple
+                    You should avoid explicit assignments as they cannot
+                    adequately represent multiple
                     <filename>.bbappend</filename> files.</para>
             </glossdef>
         </glossentry>