diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index d35b6918b8..fbee742450 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -7494,6 +7494,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
 <!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
                     Lists the layers, separated by spaces, recommended for
                     use with this layer.
+                </para>
+
+                <para>
                     Optionally, you can specify a specific layer version for a
                     recommendation by adding the version to the end of the
                     layer name.
@@ -7507,8 +7510,6 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                 </para>
 
                 <para>
-                    An error is produced if any dependency is missing or the
-                    version numbers (if specified) do not match exactly.
                     This variable is used in the
                     <filename>conf/layer.conf</filename> file and must be
                     suffixed with the name of the specific layer (e.g.