diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index c82fe31890..e6e8613973 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -2659,10 +2659,10 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                 <para>
                     If multiple recipes provide an item, this variable
                     determines which recipe should be given preference.
-                    The variable must always be suffixed with the name of the
-                    provided item, and should be set to the
-                    <filename>PN</filename> of the recipe
-                    to which you want to give precedence.
+                    You should always suffix the variable with the name of the
+                    provided item, and you should set it to the
+                    <link linkend='var-PN'><filename>PN</filename></link>
+                    of the recipe to which you want to give precedence.
                     Here is an example:
                     <literallayout class='monospaced'>
      PREFERRED_PROVIDER_virtual/xserver = "xserver-xf86"