diff --git a/documentation/kernel-dev/kernel-dev-advanced.xml b/documentation/kernel-dev/kernel-dev-advanced.xml index a951aaec5d..18238c75c2 100644 --- a/documentation/kernel-dev/kernel-dev-advanced.xml +++ b/documentation/kernel-dev/kernel-dev-advanced.xml @@ -285,38 +285,34 @@ metadata directory. For details, see 3.3. Kernel Metadata Location - This metadata can be defined along with the Linux kernel - recipe (recipe-space) as partially described in the - "Modifying an Existing Recipe" - section as well as within the Linux kernel sources themselves - (in-tree). - - - - Where you choose to store the metadata depends on what you want + Kernel Metadata can be defined in either the kernel recipe + (recipe-space) or in the kernel tree (in-tree). + Where you choose to define the Metadata depends on what you want to do and how you intend to work. + Regardless of where you define the kernel Metadata, the syntax used + applies equally. + + + If you are unfamiliar with the Linux kernel and only wish - to apply a config and possibly a couple of patches provided to - you by others, you may find the recipe-space mechanism to be easier - to work with. - This is also a good approach if you are working with Linux kernel - sources you do not control or if you just don't want to maintain a - Linux kernel git repository on your own. + to apply a configuration and possibly a couple of patches provided to + you by others, the recipe-space method is recommended. + This method is also a good approach if you are working with Linux kernel + sources you do not control or if you just do not want to maintain a + Linux kernel Git repository on your own. + For partial information on how you can define kernel Metadata in + the recipe-space, see the + "Modifying an Existing Recipe" + section. - If you are doing active kernel development and are already - maintaining a Linux kernel git repository of your own, you may find - it more convenient to work with the metadata in the same + Conversely, if you are actively developing a kernel and are already + maintaining a Linux kernel Git repository of your own, you might find + it more convenient to work with the kernel Metadata in the same repository as the Linux kernel sources. - This can make iterative development of the Linux kernel more efficient - outside of the BitBake environment. - - - - - Regardless of where the meta-data is stored, the syntax as - described in the following sections applies equally. + This method can make iterative development of the Linux kernel + more efficient outside of the BitBake environment.