diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 163f5760e1..4a2c79f1be 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -7485,6 +7485,38 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
+ LAYERRECOMMENDS
+
+ LAYERRECOMMENDS[doc] = "Lists the layers, separated by spaces, recommended for use with this layer."
+
+
+
+
+ Lists the layers, separated by spaces, recommended for
+ use with this layer.
+ Optionally, you can specify a specific layer version for a
+ recommendation by adding the version to the end of the
+ layer name.
+ Here is an example:
+
+ LAYERRECOMMENDS_mylayer = "anotherlayer (=3)"
+
+ In this previous example, version 3 of "anotherlayer" is
+ compared against
+ LAYERVERSION_anotherlayer.
+
+
+
+ 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
+ conf/layer.conf file and must be
+ suffixed with the name of the specific layer (e.g.
+ LAYERRECOMMENDS_mylayer).
+
+
+
+
LAYERVERSION
LAYERVERSION[doc] = "Optionally specifies the version of a layer as a single number. This variable is used in the conf/layer.conf file and must be suffixed with the name of the specific layer."