diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 24c0faa1ef..93c655926e 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -879,6 +879,18 @@
             </glossdef>
         </glossentry>
 
+        <glossentry id='var-BUILD_LDFLAGS'><glossterm>BUILD_LDFLAGS</glossterm>
+            <glossdef>
+                <para>
+                    Specifies the flags to pass to the linker when building
+                    for the build host.
+                    When building in the <filename>-native</filename> context,
+                    <link linkend='var-LDFLAGS'><filename>LDFLAGS</filename></link>
+                    is set to the value of this variable by default.
+                </para>
+            </glossdef>
+        </glossentry>
+
         <glossentry id='var-BUILDDIR'><glossterm>BUILDDIR</glossterm>
             <glossdef>
                 <para>
@@ -4177,8 +4189,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                             for the target
                             </para></listitem>
                         <listitem><para>
-                            <filename>BUILD_LDFLAGS</filename> when building
-                            for the build host (i.e.
+                            <link linkend='var-BUILD_LDFLAGS'><filename>BUILD_LDFLAGS</filename></link>
+                            when building for the build host (i.e.
                             <filename>-native</filename>)
                             </para></listitem>
                         <listitem><para>