kernel-dev: General edits to "Kernel Metadata Location" section.

First real pass at cleaning up the text.

(From yocto-docs rev: a550e96780b5be191a576bbb20ef28a36b20e0bc)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2013-01-07 14:29:13 -06:00 committed by Richard Purdie
parent ced75cec41
commit b63272cc16
1 changed files with 22 additions and 26 deletions

View File

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