diff --git a/documentation/kernel-dev/kernel-dev-advanced.xml b/documentation/kernel-dev/kernel-dev-advanced.xml
index 12d3d7c8ec..879d3f285a 100644
--- a/documentation/kernel-dev/kernel-dev-advanced.xml
+++ b/documentation/kernel-dev/kernel-dev-advanced.xml
@@ -849,17 +849,14 @@ The description file can include multiple patch statements, one per patch.
Features
- Features are a combination of configuration fragments and patches.
- Or, more accurately, configuration fragments and patches are
- simple forms of a feature, which is a more complex metadata type.
- In addition to the kconf and
- patch commands, features often aggregate
- description files with the include command.
+ Features are complex kernel Metadata types that consist
+ of configuration fragments (kconf), patches
+ (patch), and possibly other feature
+ description files (include).
- A hypothetical example of a feature description file might look
- like the following:
+ Here is an example that shows a feature description file:
features/myfeature.scc
define KFEATURE_DESCRIPTION "Enable myfeature"
@@ -870,12 +867,15 @@ The description file can include multiple patch statements, one per patch.
include cfg/myfeature_dependency.scc
kconf non-hardware myfeature.cfg
+ This example shows how the patch and
+ kconf commands are used as well as
+ how an additional feature description file is included.
- Features are typically less granular than configuration
- fragments and are more likely than configurations fragments
- and patches to be the types of things you will want to specify
+ Typically, features are less granular than configuration
+ fragments and are more likely than configuration fragments
+ and patches to be the types of things you want to specify
in the KERNEL_FEATURES variable of the
Linux kernel recipe.
See the "Using Kernel Metadata in a Recipe"