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"
PKG_CONFIG_PATH
- 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."
The path to pkg-config files for the
- target.
+ current build context.
+ pkg-config reads this variable
+ from the environment.
@@ -9283,11 +9285,14 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
SDKTARGETSYSROOT
- 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."
- 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
+ SDKPATH.