summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
Diffstat (limited to 'documentation')
-rw-r--r--documentation/dev-manual/dev-manual-model.xml56
1 files changed, 36 insertions, 20 deletions
diff --git a/documentation/dev-manual/dev-manual-model.xml b/documentation/dev-manual/dev-manual-model.xml
index fd0d156494..03eb5f1176 100644
--- a/documentation/dev-manual/dev-manual-model.xml
+++ b/documentation/dev-manual/dev-manual-model.xml
@@ -491,28 +491,44 @@
491 changing source files. 491 changing source files.
492 However, if you have to do this, you make the changes to the files in the 492 However, if you have to do this, you make the changes to the files in the
493 Build Directory.</para></listitem> 493 Build Directory.</para></listitem>
494 <listitem><para><emphasis>Make kernel configuration changes 494 <listitem><para><emphasis>Make kernel configuration changes if applicable</emphasis>:
495 if applicable</emphasis>: 495 If your situation calls for changing the kernel's
496 If your situation calls for changing the kernel's configuration, you can 496 configuration, you can use
497 use the <filename>yocto-kernel</filename> script or <filename>menuconfig</filename> 497 <ulink url='&YOCTO_DOCS_KERNEL_DEV_URL;#generating-configuration-files'><filename>menuconfig</filename></ulink>,
498 to enable and disable kernel configurations. 498 which allows you to interactively develop and test the
499 Using the script lets you interactively set up kernel configurations.
500 Using <filename>menuconfig</filename> allows you to interactively develop and test the
501 configuration changes you are making to the kernel. 499 configuration changes you are making to the kernel.
502 When saved, changes using <filename>menuconfig</filename> update the kernel's 500 Saving changes you make with
503 <filename>.config</filename> file. 501 <filename>menuconfig</filename> updates
504 Try to resist the temptation of directly editing the <filename>.config</filename> 502 the kernel's <filename>.config</filename> file.
505 file found in the Build Directory at 503 <note><title>Warning</title>
506 <filename>tmp/sysroots/&lt;machine-name&gt;/kernel</filename>. 504 Try to resist the temptation to directly edit an
507 Doing so, can produce unexpected results when the OpenEmbedded build system 505 existing <filename>.config</filename> file, which is
508 regenerates the configuration file.</para> 506 found in the Build Directory at
509 <para>Once you are satisfied with the configuration changes made using 507 <filename>tmp/sysroots/<replaceable>machine-name</replaceable>/kernel</filename>.
510 <filename>menuconfig</filename>, you can directly compare the 508 Doing so, can produce unexpected results when the
511 <filename>.config</filename> file against a saved original and gather those 509 OpenEmbedded build system regenerates the configuration
512 changes into a config fragment to be referenced from within the kernel's 510 file.
513 <filename>.bbappend</filename> file.</para></listitem> 511 </note>
512 Once you are satisfied with the configuration
513 changes made using <filename>menuconfig</filename>
514 and you have saved them, you can directly compare the
515 resulting <filename>.config</filename> file against an
516 existing original and gather those changes into a
517 <link linkend='creating-config-fragments'>configuration fragment file</link>
518 to be referenced from within the kernel's
519 <filename>.bbappend</filename> file.</para>
520
521 <para>Additionally, if you are working in a BSP layer
522 and need to modify the BSP's kernel's configuration,
523 you can use the
524 <ulink url='&YOCTO_DOCS_BSP_URL;#managing-kernel-patches-and-config-items-with-yocto-kernel'><filename>yocto-kernel</filename></ulink>
525 script as well as <filename>menuconfig</filename>.
526 The <filename>yocto-kernel</filename> script lets
527 you interactively set up kernel configurations.
528 </para></listitem>
514 <listitem><para><emphasis>Rebuild the kernel image with your changes</emphasis>: 529 <listitem><para><emphasis>Rebuild the kernel image with your changes</emphasis>:
515 Rebuilding the kernel image applies your changes.</para></listitem> 530 Rebuilding the kernel image applies your changes.
531 </para></listitem>
516 </orderedlist> 532 </orderedlist>
517 </para> 533 </para>
518 </section> 534 </section>