diff options
| -rw-r--r-- | documentation/kernel-manual/kernel-concepts.xml | 24 | ||||
| -rw-r--r-- | documentation/kernel-manual/kernel-doc-intro.xml | 13 | ||||
| -rw-r--r-- | documentation/kernel-manual/kernel-how-to.xml | 36 | ||||
| -rw-r--r-- | documentation/kernel-manual/kernel-manual.xml | 9 |
4 files changed, 40 insertions, 42 deletions
diff --git a/documentation/kernel-manual/kernel-concepts.xml b/documentation/kernel-manual/kernel-concepts.xml index 27b32098ec..a82977dc49 100644 --- a/documentation/kernel-manual/kernel-concepts.xml +++ b/documentation/kernel-manual/kernel-concepts.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-concepts'> @@ -160,9 +161,8 @@ The features are tagged and organized by way of a branching strategy implemented by the source code manager (SCM) Git. For information on Git as applied to the Yocto Project, see the - "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#git'>Git</ulink>" - section in <ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html'>The - Yocto Project Development Manual</ulink>. + "<ulink url='&YOCTO_DOCS_DEV_URL;#git'>Git</ulink>" section in the + Yocto Project Development Manual. </para> <para> The result is that the user has the ability to see the added features and @@ -289,9 +289,8 @@ <para> You can find documentation on Git at <ulink url='http://git-scm.com/documentation'></ulink>. You can also get an introduction to Git as it applies to the Yocto Project in the - "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#git'>Git</ulink>" - section in <ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html'>The - Yocto Project Development Manual</ulink>. + "<ulink url='&YOCTO_DOCS_DEV_URL;#git'>Git</ulink>" + section in the Yocto Project Development Manual. These referenced sections overview Git and describe a minimal set of commands that allow you to be functional using Git. <note> @@ -344,7 +343,7 @@ After the tool is built, you can interact with it normally. You can see how <filename>menuconfig</filename> is used to change a simple kernel configuration in the - "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#changing-the-config-smp-configuration-using-menuconfig'>Changing the <filename>CONFIG_SMP</filename> Configuration Using <filename>menuconfig</filename></ulink>" + "<ulink url='&YOCTO_DOCS_DEV_URL;#changing-the-config-smp-configuration-using-menuconfig'>Changing the <filename>CONFIG_SMP</filename> Configuration Using <filename>menuconfig</filename></ulink>" section of The Yocto Project Development Manual. For general information on <filename>menuconfig</filename>, see <ulink url='http://en.wikipedia.org/wiki/Menuconfig'></ulink>. @@ -356,10 +355,10 @@ by the Yocto Project build system to produce input used by the LKC that ultimately generates the <filename>.config</filename> file.</para> <para>The - <filename><ulink url='http://www.yoctoproject.org/docs/latest/poky-ref-manual/poky-ref-manual.html#var-KERNEL_FEATURES'>KERNEL_FEATURES</ulink></filename> + <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-KERNEL_FEATURES'>KERNEL_FEATURES</ulink></filename> variable can be used to list configuration fragments. For further discussion on applying configuration fragments, see the - "<ulink url='http://www.yoctoproject.org/docs/latest/bsp-guide/bsp-guide.html#linux-kernel-configuration'>Linux Kernel Configuration</ulink>" + "<ulink url='&YOCTO_DOCS_BSP_URL;#bsp-filelayout-kernel'>Linux Kernel Configuration</ulink>" section in the Yocto Project Board Support Package (BSP) Guide. </para></listitem> </itemizedlist> @@ -400,11 +399,6 @@ kernel toolkit: </itemizedlist> </para> --> </section> - - - - - </chapter> <!-- vim: expandtab tw=80 ts=4 diff --git a/documentation/kernel-manual/kernel-doc-intro.xml b/documentation/kernel-manual/kernel-doc-intro.xml index 9f845823d3..c3fde6c731 100644 --- a/documentation/kernel-manual/kernel-doc-intro.xml +++ b/documentation/kernel-manual/kernel-doc-intro.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-doc-intro'> @@ -46,21 +47,21 @@ <para> For more discussion on the Yocto Project kernel, you can see these sections - in <ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html'>The Yocto Project Development Manual</ulink>: + in <ulink url='&YOCTO_DOCS_DEV_URL;'>The Yocto Project Development Manual</ulink>: <itemizedlist> <listitem><para> - "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#kernel-overview'>Kernel Overview</ulink>"</para></listitem> + "<ulink url='&YOCTO_DOCS_DEV_URL;#kernel-overview'>Kernel Overview</ulink>"</para></listitem> <listitem><para> - "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#kernel-modification-workflow'>Kernel Modification Workflow</ulink>" + "<ulink url='&YOCTO_DOCS_DEV_URL;#kernel-modification-workflow'>Kernel Modification Workflow</ulink>" </para></listitem> <listitem><para> - "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#dev-manual-kernel-appendix'>Kernel Modification Example</ulink>".</para></listitem> + "<ulink url='&YOCTO_DOCS_DEV_URL;#dev-manual-kernel-appendix'>Kernel Modification Example</ulink>"</para></listitem> </itemizedlist> </para> <para> For general information on the Yocto Project, visit the website at - <ulink url='http://www.yoctoproject.org'></ulink>. + <ulink url='&YOCTO_HOME_URL;'></ulink>. </para> </section> 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. diff --git a/documentation/kernel-manual/kernel-manual.xml b/documentation/kernel-manual/kernel-manual.xml index 398e800273..0f239d3e47 100644 --- a/documentation/kernel-manual/kernel-manual.xml +++ b/documentation/kernel-manual/kernel-manual.xml @@ -1,5 +1,6 @@ <!DOCTYPE book 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; ] > <book id='kernel-manual' lang='en' xmlns:xi="http://www.w3.org/2003/XInclude" @@ -51,7 +52,7 @@ </revhistory> <copyright> - <year>2010-2012</year> + <year>©RIGHT_YEAR;</year> <holder>Linux Foundation</holder> </copyright> @@ -63,9 +64,9 @@ <note> Due to production processes, there could be differences between the Yocto Project documentation bundled in the release tarball and - <ulink url='http://www.yoctoproject.org/docs/latest/kernel-manual/kernel-manual.html'> + <ulink url='&YOCTO_DOCS_KERNEL_URL;'> The Yocto Project Kernel Architecture and Use Manual</ulink> on - the <ulink url='http://www.yoctoproject.org'>Yocto Project</ulink> website. + the <ulink url='&YOCTO_HOME_URL;'>Yocto Project</ulink> website. For the latest version of this manual, see the manual on the website. </note> </legalnotice> |