From d048a99e2404601a3f343eeb65ce82fb963c6f51 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 9 Mar 2012 15:35:11 -0600 Subject: documentation/kernel-manual: Converted to use variables from poky.ent. Also removed a broken link. Signed-off-by: Richard Purdie --- documentation/kernel-manual/kernel-how-to.xml | 36 ++++++++++++++------------- 1 file changed, 19 insertions(+), 17 deletions(-) (limited to 'documentation/kernel-manual/kernel-how-to.xml') 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 @@ +"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" +[ %poky; ] > @@ -27,7 +28,7 @@ This section describes construction of the Yocto Project kernel repositories as accomplished by the Yocto Project team to create kernel repositories. These kernel repositories are found at - http://git.yoctoproject.org/cgit.cgi + &YOCTO_GIT_URL;/cgit.cgi and can be shipped as part of a Yocto Project release. The team creates these repositories by compiling and executing the set of feature descriptions for every BSP/feature @@ -51,7 +52,7 @@ For another example of how to set up a local Git repository of the Linux Yocto kernel files, see the - "Linux Yocto Kernel" bulleted item in The Yocto Project Development Manual. + "Linux Yocto Kernel" bulleted item in The Yocto Project Development Manual. Once you have cloned the kernel Git repository on your local machine, you can @@ -85,7 +86,7 @@ The following steps describe what happens when the Yocto Project Team constructs the Yocto Linux kernel source Git repository (or tree) found at - given the + given the introduction of a new top-level kernel feature or BSP. These are the actions that effectively create the tree that includes the new feature, patch or BSP: @@ -135,7 +136,7 @@ Any add-ons and configuration data are applied to the end of an existing branch. The full repository generation that is found in the official Yocto Project kernel repositories at - http://git.yoctoproject.org/cgit.cgi + http://git.yoctoproject.org/cgit.cgi is the combination of all supported boards and configurations. The technique the Yocto Project team uses is flexible and allows for seamless blending of an immutable history with additional patches specific to a @@ -236,7 +237,7 @@ You can find Git documentation at . You can find a simple overview of using Git with the Yocto Project in the - "Git" + "Git" section of The Yocto Project Development Manual. @@ -362,9 +363,10 @@ The Yocto Project provides scripts that help you work in a collaborative development environment. For information on these scripts, see the - "Pushing a Change Upstream and Requesting a Pull" and - "Submitting a Patch Through Email" sections in The Yocto Project Development - Manual. + "Pushing a Change + Upstream and Requesting a Pull" and + "Submitting a Patch Through + Email" sections in The Yocto Project Development Manual. @@ -630,8 +632,6 @@ community standards for submitting and documenting changes and follow their best practices. For example, kernel patches should follow standards such as: - - Documentation/SubmittingPatches (in any linux @@ -644,7 +644,8 @@ The messages used to commit changes are a large part of these standards. Consequently, be sure that the headers for each commit have the required information. For information on how to follow the Yocto Project commit message standards, see the - "How to Submit a Change" section in The Yocto Project Development Manual. + "How to Submit a + Change" section in The Yocto Project Development Manual. @@ -746,7 +747,8 @@ - The following commands illustrate how you can condense and merge two BSPs into a second SCM: + The following commands illustrate how you can condense and merge two BSPs into a + second SCM: > git checkout yocto/standard/common-pc/base > git merge yocto/standard/common-pc-64/base @@ -777,9 +779,9 @@ existing similar BSP. The information is introductory in nature and does not provide step-by-step examples. For detailed information on how to create a BSP given an existing similar BSP, see - the "BSP Development Example" appendix in The - Yocto Project Development Manual, or see the - Transcript:_creating_one_generic_Atom_BSP_from_another + the "BSP Development + Example" appendix in the Yocto Project Development Manual, or see the + Transcript:_creating_one_generic_Atom_BSP_from_another wiki page. @@ -796,7 +798,7 @@ your BSP easier. You can find all the BSPs that are supported and ship with the Yocto Project on the Yocto Project's Download page at - . + . Be sure you have the Base BSP: You need to either have the Yocto Project Git repository set up or download the tarball of the base BSP. -- cgit v1.2.3-54-g00ecf