diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index da7a986b68..90762e3aa3 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -309,7 +309,7 @@
 
                 <para>
                     The default value is "${PACKAGES}", which causes the
-                    OpenEmbedded build system to act on all packages that are
+                    debian class to act on all packages that are
                     explicitly generated by the recipe.
                 </para>
             </glossdef>
@@ -2072,7 +2072,7 @@
 
         <glossentry id='var-DEBIANNAME'><glossterm><imagedata fileref="figures/define-generic.png" />DEBIANNAME</glossterm>
             <info>
-                DEBIANNAME[doc] = "Allows you to override the library name for an individual package."
+                DEBIANNAME[doc] = "Allows you to override the library name for an individual package for Debian library package renaming."
             </info>
             <glossdef>
                 <para>
@@ -2924,7 +2924,8 @@
             </info>
             <glossdef>
                 <para>
-                    For recipes inheriting the <filename>autoconf</filename>
+                    For recipes inheriting the
+                    <link linkend='ref-classes-autotools'><filename>autotools</filename></link>
                     class, you can use <filename>EXTRA_AUTORECONF</filename> to
                     specify extra options to pass to the
                     <filename>autoreconf</filename> command that is
@@ -5365,7 +5366,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                 <para>
                     <filename>KERNEL_IMAGE_MAXSIZE</filename> is useful for
                     target devices that have a limited amount of space in
-                    which the kernel image file must be stored.
+                    which the kernel image must be stored.
                 </para>
 
                 <para>
@@ -7269,7 +7270,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
 
         <glossentry id='var-PACKAGEGROUP_DISABLE_COMPLEMENTARY'><glossterm><imagedata fileref="figures/define-generic.png" />PACKAGEGROUP_DISABLE_COMPLEMENTARY</glossterm>
             <info>
-                PACKAGEGROUP_DISABLE_COMPLEMENTARY[doc] = "Prevents the packagegroup recipe from automatically creating the normal complementary packages such as -dev and -dbg."
+                PACKAGEGROUP_DISABLE_COMPLEMENTARY[doc] = "Prevents automatic creation of the normal complementary packages such as -dev and -dbg in a packagegroup recipe."
             </info>
             <glossdef>
                 <para>
@@ -10339,6 +10340,11 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     Specifies a suffix to be appended onto the
                     <link linkend='var-TMPDIR'><filename>TMPDIR</filename></link>
                     value.
+                    When you are building for multiple variants with the same
+                    <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>,
+                    this mechanism ensures that output for different
+                    <filename>libc</filename> variants is kept separate to
+                    avoid potential conflicts.
                     The suffix identifies the <filename>libc</filename> variant
                     for building.
                 </para>