summaryrefslogtreecommitdiffstats
path: root/documentation/kernel-manual/kernel-how-to.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/kernel-manual/kernel-how-to.xml')
-rw-r--r--documentation/kernel-manual/kernel-how-to.xml36
1 files changed, 19 insertions, 17 deletions
diff --git a/documentation/kernel-manual/kernel-how-to.xml b/documentation/kernel-manual/kernel-how-to.xml
index c43af60d36..37efbf0ae2 100644
--- a/documentation/kernel-manual/kernel-how-to.xml
+++ b/documentation/kernel-manual/kernel-how-to.xml
@@ -1,5 +1,6 @@
1<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 1<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
2"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> 2"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
3[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >
3 4
4<chapter id='kernel-how-to'> 5<chapter id='kernel-how-to'>
5 6
@@ -27,7 +28,7 @@
27 This section describes construction of the Yocto Project kernel repositories 28 This section describes construction of the Yocto Project kernel repositories
28 as accomplished by the Yocto Project team to create kernel repositories. 29 as accomplished by the Yocto Project team to create kernel repositories.
29 These kernel repositories are found at 30 These kernel repositories are found at
30 <ulink url='http://git.yoctoproject.org/cgit.cgi'>http://git.yoctoproject.org/cgit.cgi</ulink> 31 <ulink url='&YOCTO_GIT_URL;/cgit.cgi'>&YOCTO_GIT_URL;/cgit.cgi</ulink>
31 and can be shipped as part of a Yocto Project release. 32 and can be shipped as part of a Yocto Project release.
32 The team creates these repositories by 33 The team creates these repositories by
33 compiling and executing the set of feature descriptions for every BSP/feature 34 compiling and executing the set of feature descriptions for every BSP/feature
@@ -51,7 +52,7 @@
51 </literallayout> 52 </literallayout>
52 For another example of how to set up a local Git repository of the Linux Yocto 53 For another example of how to set up a local Git repository of the Linux Yocto
53 kernel files, see the 54 kernel files, see the
54 "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#local-kernel-files'>Linux Yocto Kernel</ulink>" bulleted item in The Yocto Project Development Manual. 55 "<ulink url='&YOCTO_DOCS_DEV_URL;#local-kernel-files'>Linux Yocto Kernel</ulink>" bulleted item in The Yocto Project Development Manual.
55 </para> 56 </para>
56 <para> 57 <para>
57 Once you have cloned the kernel Git repository on your local machine, you can 58 Once you have cloned the kernel Git repository on your local machine, you can
@@ -85,7 +86,7 @@
85 <para> 86 <para>
86 The following steps describe what happens when the Yocto Project Team constructs 87 The following steps describe what happens when the Yocto Project Team constructs
87 the Yocto Linux kernel source Git repository (or tree) found at 88 the Yocto Linux kernel source Git repository (or tree) found at
88 <ulink url='http://git.yoctoproject.org/cgit.cgi'></ulink> given the 89 <ulink url='&YOCTO_GIT_URL;/cgit.cgi'></ulink> given the
89 introduction of a new top-level kernel feature or BSP. 90 introduction of a new top-level kernel feature or BSP.
90 These are the actions that effectively create the tree 91 These are the actions that effectively create the tree
91 that includes the new feature, patch or BSP: 92 that includes the new feature, patch or BSP:
@@ -135,7 +136,7 @@
135 Any add-ons and configuration data are applied to the end of an existing branch. 136 Any add-ons and configuration data are applied to the end of an existing branch.
136 The full repository generation that is found in the 137 The full repository generation that is found in the
137 official Yocto Project kernel repositories at 138 official Yocto Project kernel repositories at
138 <ulink url='http://git.yoctoproject.org/cgit.cgi'>http://git.yoctoproject.org/cgit.cgi</ulink> 139 <ulink url='&YOCTO_GIT_URL;/cgit.cgi'>http://git.yoctoproject.org/cgit.cgi</ulink>
139 is the combination of all supported boards and configurations.</para> 140 is the combination of all supported boards and configurations.</para>
140 <para>The technique the Yocto Project team uses is flexible and allows for seamless 141 <para>The technique the Yocto Project team uses is flexible and allows for seamless
141 blending of an immutable history with additional patches specific to a 142 blending of an immutable history with additional patches specific to a
@@ -236,7 +237,7 @@
236 You can find Git documentation at 237 You can find Git documentation at
237 <ulink url='http://git-scm.com/documentation'></ulink>. 238 <ulink url='http://git-scm.com/documentation'></ulink>.
238 You can find a simple overview of using Git with the Yocto Project in the 239 You can find a simple overview of using Git with the Yocto Project in the
239 "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#git'>Git</ulink>" 240 "<ulink url='&YOCTO_DOCS_DEV_URL;#git'>Git</ulink>"
240 section of The Yocto Project Development Manual. 241 section of The Yocto Project Development Manual.
241 </para> 242 </para>
242 243
@@ -362,9 +363,10 @@
362 The Yocto Project provides scripts that help you work in a collaborative development 363 The Yocto Project provides scripts that help you work in a collaborative development
363 environment. 364 environment.
364 For information on these scripts, see the 365 For information on these scripts, see the
365 "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#pushing-a-change-upstream'>Pushing a Change Upstream and Requesting a Pull</ulink>" and 366 "<ulink url='&YOCTO_DOCS_DEV_URL;#pushing-a-change-upstream'>Pushing a Change
366 "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#submitting-a-patch'>Submitting a Patch Through Email</ulink>" sections in The Yocto Project Development 367 Upstream and Requesting a Pull</ulink>" and
367 Manual. 368 "<ulink url='&YOCTO_DOCS_DEV_URL;#submitting-a-patch'>Submitting a Patch Through
369 Email</ulink>" sections in The Yocto Project Development Manual.
368 </para> 370 </para>
369 371
370 <para> 372 <para>
@@ -631,8 +633,6 @@
631 For example, kernel patches should follow standards such as: 633 For example, kernel patches should follow standards such as:
632 <itemizedlist> 634 <itemizedlist>
633 <listitem><para> 635 <listitem><para>
634 <ulink url='http://userweb.kernel.org/~akpm/stuff/tpp.txt'></ulink></para></listitem>
635 <listitem><para>
636 <ulink url='http://linux.yyz.us/patch-format.html'></ulink></para></listitem> 636 <ulink url='http://linux.yyz.us/patch-format.html'></ulink></para></listitem>
637 <listitem><para>Documentation/SubmittingPatches (in any linux 637 <listitem><para>Documentation/SubmittingPatches (in any linux
638 kernel source tree)</para></listitem> 638 kernel source tree)</para></listitem>
@@ -644,7 +644,8 @@
644 The messages used to commit changes are a large part of these standards. 644 The messages used to commit changes are a large part of these standards.
645 Consequently, be sure that the headers for each commit have the required information. 645 Consequently, be sure that the headers for each commit have the required information.
646 For information on how to follow the Yocto Project commit message standards, see the 646 For information on how to follow the Yocto Project commit message standards, see the
647 "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#how-to-submit-a-change'>How to Submit a Change</ulink>" section in The Yocto Project Development Manual. 647 "<ulink url='&YOCTO_DOCS_DEV_URL;#how-to-submit-a-change'>How to Submit a
648 Change</ulink>" section in The Yocto Project Development Manual.
648 </para> 649 </para>
649 650
650 <para> 651 <para>
@@ -746,7 +747,8 @@
746 </para> 747 </para>
747 748
748 <para> 749 <para>
749 The following commands illustrate how you can condense and merge two BSPs into a second SCM: 750 The following commands illustrate how you can condense and merge two BSPs into a
751 second SCM:
750 <literallayout class='monospaced'> 752 <literallayout class='monospaced'>
751 &gt; git checkout yocto/standard/common-pc/base 753 &gt; git checkout yocto/standard/common-pc/base
752 &gt; git merge yocto/standard/common-pc-64/base 754 &gt; git merge yocto/standard/common-pc-64/base
@@ -777,9 +779,9 @@
777 existing similar BSP. 779 existing similar BSP.
778 The information is introductory in nature and does not provide step-by-step examples. 780 The information is introductory in nature and does not provide step-by-step examples.
779 For detailed information on how to create a BSP given an existing similar BSP, see 781 For detailed information on how to create a BSP given an existing similar BSP, see
780 the "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#dev-manual-bsp-appendix'>BSP Development Example</ulink>" appendix in The 782 the "<ulink url='&YOCTO_DOCS_DEV_URL;#dev-manual-bsp-appendix'>BSP Development
781 Yocto Project Development Manual, or see the 783 Example</ulink>" appendix in the Yocto Project Development Manual, or see the
782 <ulink url='https://wiki.yoctoproject.org/wiki/Transcript:_creating_one_generic_Atom_BSP_from_another'>Transcript:_creating_one_generic_Atom_BSP_from_another</ulink> 784 <ulink url='&YOCTO_WIKI_URL;/wiki/Transcript:_creating_one_generic_Atom_BSP_from_another'>Transcript:_creating_one_generic_Atom_BSP_from_another</ulink>
783 wiki page. 785 wiki page.
784 </para> 786 </para>
785 787
@@ -796,7 +798,7 @@
796 your BSP easier. 798 your BSP easier.
797 You can find all the BSPs that are supported and ship with the Yocto Project 799 You can find all the BSPs that are supported and ship with the Yocto Project
798 on the Yocto Project's Download page at 800 on the Yocto Project's Download page at
799 <ulink url='http://www.yoctoproject.org/download'></ulink>.</para></listitem> 801 <ulink url='&YOCTO_HOME_URL;/download'></ulink>.</para></listitem>
800 <listitem><para><emphasis>Be sure you have the Base BSP:</emphasis> 802 <listitem><para><emphasis>Be sure you have the Base BSP:</emphasis>
801 You need to either have the Yocto Project Git repository set up or download 803 You need to either have the Yocto Project Git repository set up or download
802 the tarball of the base BSP. 804 the tarball of the base BSP.