summaryrefslogtreecommitdiffstats
path: root/documentation/kernel-dev
diff options
context:
space:
mode:
authorscott-lenovo <scott-lenovo@ubuntu.(none)>2013-01-02 15:30:53 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-01-16 15:59:13 +0000
commit00557ab7d5792cfc72db8d7886234885d077d205 (patch)
tree2e12a9b0da2938c14d77abd127f0af03e5b9cfe2 /documentation/kernel-dev
parent9a6c5e1fdd3b63cb6772391784c3991e9878a361 (diff)
downloadpoky-00557ab7d5792cfc72db8d7886234885d077d205.tar.gz
kernel-dev: General edits up to section 2.4.
(From yocto-docs rev: 2df095c98a6fa034cb39f952db27d1ab55849000) Signed-off-by: scott-lenovo <scott-lenovo@ubuntu.(none)> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/kernel-dev')
-rw-r--r--documentation/kernel-dev/kernel-dev-common.xml21
1 files changed, 11 insertions, 10 deletions
diff --git a/documentation/kernel-dev/kernel-dev-common.xml b/documentation/kernel-dev/kernel-dev-common.xml
index ed513ea36d..31a7743c17 100644
--- a/documentation/kernel-dev/kernel-dev-common.xml
+++ b/documentation/kernel-dev/kernel-dev-common.xml
@@ -29,7 +29,7 @@
29 from within your custom layer that is independent from layers 29 from within your custom layer that is independent from layers
30 released with the Yocto Project. 30 released with the Yocto Project.
31 For details on how to create and work with layers, see the following 31 For details on how to create and work with layers, see the following
32 sections: 32 sections in the Yocto Project Development Manual:
33 <itemizedlist> 33 <itemizedlist>
34 <listitem><para>"<ulink url='&YOCTO_DOCS_DEV_URL;#understanding-and-creating-layers'>Understanding and Creating Layers</ulink>" for 34 <listitem><para>"<ulink url='&YOCTO_DOCS_DEV_URL;#understanding-and-creating-layers'>Understanding and Creating Layers</ulink>" for
35 general information on layers and how to create them.</para></listitem> 35 general information on layers and how to create them.</para></listitem>
@@ -40,13 +40,14 @@
40 </para> 40 </para>
41 41
42 <para> 42 <para>
43 Original text:
43 <literallayout class='monospaced'> 44 <literallayout class='monospaced'>
44Customizing recipes is best done in a layer with bbappend files. Layers also 45Customizing recipes is best done in a layer with bbappend files. Layers also
45provide a convenient mechanism to create your own recipes. This guide assumes 46provide a convenient mechanism to create your own recipes. This guide assumes
46you will be working from within a layer independent from those released with the 47you will be working from within a layer independent from those released with the
47Yocto Project. For details on how to create and work with layers, refer to 48Yocto Project. For details on how to create and work with layers, refer to
48section 5.1 Understanding and Creating Layers in the Yocto Project Development 49section 5.1 Understanding and Creating Layers in the Yocto Project Development
49Manual. 50Manual.
50 51
51(Kernel specific directions in 5.7.4) 52(Kernel specific directions in 5.7.4)
52 </literallayout> 53 </literallayout>
@@ -88,7 +89,7 @@ Manual.
88 </literallayout> 89 </literallayout>
89 The append file should initially contain the following text: 90 The append file should initially contain the following text:
90 <literallayout class='monospaced'> 91 <literallayout class='monospaced'>
91 FILESEXTRAPATHS := "${THISDIR}/${PN}" 92 <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'>FILESEXTRAPATHS</ulink> := "${THISDIR}/${PN}"
92 </literallayout> 93 </literallayout>
93 The path <filename>${THISDIR}/${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PN'><filename>PN</filename></ulink><filename>}</filename> expands 94 The path <filename>${THISDIR}/${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PN'><filename>PN</filename></ulink><filename>}</filename> expands
94 to "linux-yocto" in the current directory for this example. 95 to "linux-yocto" in the current directory for this example.
@@ -207,7 +208,7 @@ apply the patches before rebuilding the Linux kernel.
207 <para> 208 <para>
208 Generally speaking, the preferred approach is to determine the 209 Generally speaking, the preferred approach is to determine the
209 incremental change you want to make and add that as a fragment. 210 incremental change you want to make and add that as a fragment.
210 For example, if you wanted to add support for a basic serial 211 For example, if you want to add support for a basic serial
211 console, create a file named <filename>8250.cfg</filename> in the 212 console, create a file named <filename>8250.cfg</filename> in the
212 <filename>${FILES}</filename> directory with the following 213 <filename>${FILES}</filename> directory with the following
213 content (without indentation): 214 content (without indentation):
@@ -277,8 +278,8 @@ apply the new configuration before rebuilding the Linux kernel.
277 During an iterative workflow, running a previously completed BitBake 278 During an iterative workflow, running a previously completed BitBake
278 task causes BitBake to invalidate the tasks that follow that 279 task causes BitBake to invalidate the tasks that follow that
279 task in the build sequence. 280 task in the build sequence.
280 This invalidation causes the tasks to rebuild the next 281 Invalidated tasks rebuild the next time you run the build using
281 time you invoke the build. 282 BitBake.
282 </para> 283 </para>
283 284
284 <para> 285 <para>
@@ -351,8 +352,8 @@ working with.
351 <literallayout class='monospaced'> 352 <literallayout class='monospaced'>
352 $ bitbake linux-yocto -c menuconfig 353 $ bitbake linux-yocto -c menuconfig
353 </literallayout></para></listitem> 354 </literallayout></para></listitem>
354 <listitem><para>Prepare a configuration fragment from 355 <listitem><para>Prepare a configuration fragment based on
355 using the differences between the two files. 356 the differences between the two files.
356 </para></listitem> 357 </para></listitem>
357 </orderedlist> 358 </orderedlist>
358 </para> 359 </para>
@@ -375,7 +376,7 @@ working with.
375 You can also use this method to create configuration 376 You can also use this method to create configuration
376 fragments for a BSP. 377 fragments for a BSP.
377 See the "<link linkend='bsp-descriptions'>BSP Descriptions</link>" 378 See the "<link linkend='bsp-descriptions'>BSP Descriptions</link>"
378 for more information. 379 section for more information.
379 </note> 380 </note>
380 </para> 381 </para>
381 382
@@ -874,7 +875,7 @@ details.
874 include the module in your images. 875 include the module in your images.
875 To do this, see the documentation for the following variables in 876 To do this, see the documentation for the following variables in
876 the Yocto Project Reference Manual and set one of them as 877 the Yocto Project Reference Manual and set one of them as
877 appropriate in your machine <filename>config</filename> file: 878 appropriate in your machine configuration file:
878 <itemizedlist> 879 <itemizedlist>
879 <listitem><para><ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE_ESSENTIAL_EXTRA_RDEPENDS'><filename>MACHINE_ESSENTIAL_EXTRA_RDEPENDS</filename></ulink> 880 <listitem><para><ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE_ESSENTIAL_EXTRA_RDEPENDS'><filename>MACHINE_ESSENTIAL_EXTRA_RDEPENDS</filename></ulink>
880 </para></listitem> 881 </para></listitem>