diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 89c7fbd4fe..0ef4beb1f3 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -797,12 +797,13 @@ FILESPATH = "${@base_set_filespath([ "${FILE_DIRNAME}/${PF}", \
IMAGE_FEATURES
- The list of features present in images.
- Typically, you configure this variable in image recipes.
- Note that you can add extra features to the image by using the
+ The list of features to include in an image.
+ Typically, you configure this variable in an image recipe.
+ Note that you can also add extra features to the image by using the
EXTRA_IMAGE_FEATURES variable.
See the "Images" section for the
- list of features present in images built by the OpenEmbedded build system.
+ full list of features that can be included in images built by the
+ OpenEmbedded build system.
@@ -1880,8 +1881,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
SECTION
- The section where package should be put.
- Package managers use this variable.
+ The section in which packages should be categorized.
+ Package management utilities can make use of this variable.
@@ -1918,7 +1919,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
Specifies the endian byte order of the target system.
- The variable is either "le" for little-endian or "be" for big-endian.
+ The value should be either "le" for little-endian or "be" for big-endian.
@@ -1927,7 +1928,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
Specifies the number of bits for the target system CPU.
- The variable is either "32" or "64".
+ The value should be either "32" or "64".