diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index f8b41bf54d..1b57e60d05 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -606,23 +606,21 @@
EXTRA_IMAGE_FEATURES
- You might want to customize your image by adding image
- features.
- You add features to the existing set by using the
+ You might want to customize your image by enabling or
+ disabling high-level image features by using the
IMAGE_FEATURES
and EXTRA_IMAGE_FEATURES
variables.
- Although both variables are nearly identical, best practices
- dictate using the IMAGE_FEATURES from
- within a recipe and using
+ Although both variables function nearly equivalent, best
+ practices dictate using IMAGE_FEATURES
+ from within a recipe and using
EXTRA_IMAGE_FEATURES from within
your local.conf, which is found in the
- .
+ Build Directory.
- To understand how to add features from within a recipe,
- the best reference is
+ To understand how these features work, the best reference is
meta/classes/core-image.bbclass.
In summary, the file looks at the contents of the
IMAGE_FEATURES variable and then maps
@@ -631,7 +629,7 @@
adds the appropriate packages to the
IMAGE_INSTALL
variable.
- Effectively, you are adding extra features by extending the
+ Effectively, you are enabling extra features by extending the
class or creating a custom class for use with specialized image
.bb files.
@@ -639,10 +637,13 @@
Use the EXTRA_IMAGE_FEATURES variable
from within your local configuration file.
- Using a separate area from which to define features with
- this variable helps you avoid conflicting situations that
- might arise from using the variable in the same manner as
- the IMAGE_FEATURES variable.
+ Using a separate area from which to enable features with
+ this variable helps you avoid overwriting the features in the
+ image recipe that are enabled with
+ IMAGE_FEATURES.
+ The value of EXTRA_IMAGE_FEATURES is added
+ to IMAGE_FEATURES within
+ meta/conf/bitbake.conf.