diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 7f850ca941..0265bdffb5 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -1384,13 +1384,14 @@ Core layer for images cannot be removed
                 <para>Suppose, for example, you have a set of recipes that
                     are used across several projects.
                     And, within each of those recipes the revision
-                    (its <filename>PR</filename> value) is set accordingly.
-                    In this case, when the revision of those recipes changes
+                    (its <link linkend='var-PR'><filename>PR</filename></link>
+                    value) is set accordingly.
+                    In this case, when the revision of those recipes changes,
                     the burden is on you to find all those recipes and
                     be sure that they get changed to reflect the updated
                     version of the recipe.
                     In this scenario, it can get complicated when recipes
-                    used in many places and that provide common functionality
+                    that are used in many places and provide common functionality
                     are upgraded to a new revision.</para>
                 <para>A more efficient way of dealing with this situation is
                     to set the <filename>INC_PR</filename> variable inside