1 files changed, 9 insertions, 4 deletions

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index b584a9fb9c..1d0feb9463 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -7891,12 +7891,14 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
 
         <glossentry id='var-PKG_CONFIG_PATH'><glossterm><imagedata fileref="figures/define-generic.png" />PKG_CONFIG_PATH</glossterm>
             <info>
-                PKG_CONFIG_PATH[doc] = "Path to pkg-config files for the target."
+                PKG_CONFIG_PATH[doc] = "Path to pkg-config files for the current build context."
             </info>
             <glossdef>
                 <para>
                     The path to <filename>pkg-config</filename> files for the
-                    target.
+                    current build context.
+                    <filename>pkg-config</filename> reads this variable
+                    from the environment.
                 </para>
             </glossdef>
         </glossentry>
@@ -9283,11 +9285,14 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
 
         <glossentry id='var-SDKTARGETSYSROOT'><glossterm><imagedata fileref="figures/define-generic.png" />SDKTARGETSYSROOT</glossterm>
             <info>
-                SDKTARGETSYSROOT[doc] = "Path to the sysroot used for cross-compilation."
+                SDKTARGETSYSROOT[doc] = "Full path to the sysroot used for cross-compilation within an SDK as it will be when installed into the default SDKPATH."
             </info>
             <glossdef>
                 <para>
-                    The path to the sysroot used for cross-compilation.
+                    The full path to the sysroot used for cross-compilation
+                    within an SDK as it will be when installed into the
+                    default
+                    <link linkend='var-SDKPATH'><filename>SDKPATH</filename></link>.
                 </para>
             </glossdef>
         </glossentry>