kernel-dev: Intermediary edits to the "branches" section.
(From yocto-docs rev: d12e98f4b80feb1538b51cd9e3a8c204c86f13fc) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
parent
b663741f7f
commit
5b1098dc0b
|
@ -1377,31 +1377,35 @@ the KTYPE has changed, now set to "tiny".
|
||||||
<title>Working with Branches</title>
|
<title>Working with Branches</title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
Many linux-yocto-custom derived recipes will be using Linux kernel
|
Many recipes based on the <filename>linux-yocto-custom.bb<filename>
|
||||||
sources with only a single branch: "master".
|
use Linux kernel sources that have only the single branch - "master".
|
||||||
However, when you are working with multiple boards and architectures,
|
However, if you work with multiple boards and architectures,
|
||||||
you are likely to run into the situation where a series of patches
|
you are likely to run into the situation where a series of patches
|
||||||
are needed for one board to boot.
|
are needed for one board to boot.
|
||||||
Sometimes, these patches are works-in-progress or fundamentally wrong,
|
Sometimes, these patches are works-in-progress or fundamentally wrong,
|
||||||
yet still necessary for specific boards.
|
yet still necessary for specific boards.
|
||||||
In these situations, you most likely do not want to include these
|
In these situations, you most likely do not want to include these
|
||||||
patches in every kernel you build.
|
patches in every kernel you build (i.e. have the patches as part of
|
||||||
You have a couple of options.
|
the lone "master" branch).
|
||||||
|
It is situations like these that give rise to multiple branches used
|
||||||
|
within a Linux kernel sources Git repository.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
First, you could encapsulate these patches in a feature description
|
If you are supporting multiple boards and architectures, you have
|
||||||
and only include them in the BSP description for the board(s) that
|
some options as to how you want to isolate your changes:
|
||||||
require them.
|
<itemizedlist>
|
||||||
For more information, see the
|
<listitem><para><emphasis>Include feature patches in the BSP:</emphasis>
|
||||||
"<link linkend='patches'>Patches</link>" and
|
Encapsulate patches in a feature description and only include
|
||||||
"<link linkend='bsp-descriptions'>BSP Descriptions</link>" sections.
|
the patches in the BSP descriptions of the applicable boards.
|
||||||
</para>
|
For more information, see the
|
||||||
|
"<link linkend='patches'>Patches</link>" and
|
||||||
<para>
|
"<link linkend='bsp-descriptions'>BSP Descriptions</link>"
|
||||||
Alternatively, you can create a branch in your Linux kernel sources
|
sections.</para></listitem>
|
||||||
and apply the patches there.
|
<listitem><para><emphasis>Create a machine branch:</emphasis>
|
||||||
You can then specify this new branch as the
|
You can create a machine branch in your Linux kernel sources
|
||||||
|
and apply the patches there.
|
||||||
|
You can then specify this new branch as the
|
||||||
<filename>KBRANCH</filename> to use for this board.
|
<filename>KBRANCH</filename> to use for this board.
|
||||||
You can do this in the recipe with the
|
You can do this in the recipe with the
|
||||||
<filename>KBRANCH</filename> variable:
|
<filename>KBRANCH</filename> variable:
|
||||||
|
|
Loading…
Reference in New Issue