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"