diff options
Diffstat (limited to 'documentation/kernel-manual/kernel-how-to.xml')
| -rw-r--r-- | documentation/kernel-manual/kernel-how-to.xml | 36 |
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 @@ <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" -"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> +"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" +[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > <chapter id='kernel-how-to'> @@ -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 - <ulink url='http://git.yoctoproject.org/cgit.cgi'>http://git.yoctoproject.org/cgit.cgi</ulink> + <ulink url='&YOCTO_GIT_URL;/cgit.cgi'>&YOCTO_GIT_URL;/cgit.cgi</ulink> 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 @@ </literallayout> For another example of how to set up a local Git repository of the Linux Yocto kernel files, see the - "<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. + "<ulink url='&YOCTO_DOCS_DEV_URL;#local-kernel-files'>Linux Yocto Kernel</ulink>" bulleted item in The Yocto Project Development Manual. </para> <para> Once you have cloned the kernel Git repository on your local machine, you can @@ -85,7 +86,7 @@ <para> The following steps describe what happens when the Yocto Project Team constructs the Yocto Linux kernel source Git repository (or tree) found at - <ulink url='http://git.yoctoproject.org/cgit.cgi'></ulink> given the + <ulink url='&YOCTO_GIT_URL;/cgit.cgi'></ulink> 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 - <ulink url='http://git.yoctoproject.org/cgit.cgi'>http://git.yoctoproject.org/cgit.cgi</ulink> + <ulink url='&YOCTO_GIT_URL;/cgit.cgi'>http://git.yoctoproject.org/cgit.cgi</ulink> is the combination of all supported boards and configurations.</para> <para>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 <ulink url='http://git-scm.com/documentation'></ulink>. You can find a simple overview of using Git with the Yocto Project in the - "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#git'>Git</ulink>" + "<ulink url='&YOCTO_DOCS_DEV_URL;#git'>Git</ulink>" section of The Yocto Project Development Manual. </para> @@ -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 - "<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 - "<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 - Manual. + "<ulink url='&YOCTO_DOCS_DEV_URL;#pushing-a-change-upstream'>Pushing a Change + Upstream and Requesting a Pull</ulink>" and + "<ulink url='&YOCTO_DOCS_DEV_URL;#submitting-a-patch'>Submitting a Patch Through + Email</ulink>" sections in The Yocto Project Development Manual. </para> <para> @@ -631,8 +633,6 @@ For example, kernel patches should follow standards such as: <itemizedlist> <listitem><para> - <ulink url='http://userweb.kernel.org/~akpm/stuff/tpp.txt'></ulink></para></listitem> - <listitem><para> <ulink url='http://linux.yyz.us/patch-format.html'></ulink></para></listitem> <listitem><para>Documentation/SubmittingPatches (in any linux kernel source tree)</para></listitem> @@ -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 - "<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. + "<ulink url='&YOCTO_DOCS_DEV_URL;#how-to-submit-a-change'>How to Submit a + Change</ulink>" section in The Yocto Project Development Manual. </para> <para> @@ -746,7 +747,8 @@ </para> <para> - 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: <literallayout class='monospaced'> > 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 "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#dev-manual-bsp-appendix'>BSP Development Example</ulink>" appendix in The - Yocto Project Development Manual, or see the - <ulink url='https://wiki.yoctoproject.org/wiki/Transcript:_creating_one_generic_Atom_BSP_from_another'>Transcript:_creating_one_generic_Atom_BSP_from_another</ulink> + the "<ulink url='&YOCTO_DOCS_DEV_URL;#dev-manual-bsp-appendix'>BSP Development + Example</ulink>" appendix in the Yocto Project Development Manual, or see the + <ulink url='&YOCTO_WIKI_URL;/wiki/Transcript:_creating_one_generic_Atom_BSP_from_another'>Transcript:_creating_one_generic_Atom_BSP_from_another</ulink> wiki page. </para> @@ -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 - <ulink url='http://www.yoctoproject.org/download'></ulink>.</para></listitem> + <ulink url='&YOCTO_HOME_URL;/download'></ulink>.</para></listitem> <listitem><para><emphasis>Be sure you have the Base BSP:</emphasis> You need to either have the Yocto Project Git repository set up or download the tarball of the base BSP. |