[yocto] [yocto-docs][PATCH] kernel-dev: Updates "Generating Configuration Files" section

[Darren Hart]

On 3/5/14, 18:20, "João Henrique Ferreira de Freitas" <joaohf at gmail.com>
wrote:

>Add a new step about how to use diffconfig task to create
>kernel config fragments.
>
>[YOCTO #3862]
>
>Signed-off-by: João Henrique Ferreira de Freitas <joaohf at gmail.com>

Thank you for updating the documentation. Please Cc: the relevant parties
with patches to the list (the author for one, and a git log would reveal
Scott R. as the next obvious owner).

Scott, This is good stuff to add. My only thought is this is new
functionality, the old method is still valid - and necessary before 1.6.
What are your thoughts on dealing with this? Does the manual with 1.6 ONLY
apply to 1.6?

--
Darren

>---
> documentation/kernel-dev/kernel-dev-common.xml | 25
>+++++++++----------------
> 1 file changed, 9 insertions(+), 16 deletions(-)
>
>diff --git a/documentation/kernel-dev/kernel-dev-common.xml
>b/documentation/kernel-dev/kernel-dev-common.xml
>index a152f9f..de04a39 100644
>--- a/documentation/kernel-dev/kernel-dev-common.xml
>+++ b/documentation/kernel-dev/kernel-dev-common.xml
>@@ -342,32 +342,25 @@
>                         <literallayout class='monospaced'>
>      $ bitbake linux-yocto -c kernel_configme -f
>                         </literallayout></para></listitem>
>-                    <listitem><para>Copy and rename the resulting
>-                        <filename>.config</filename> file (e.g.
>-                        <filename>config.orig</filename>).
>-                        </para></listitem>
>                     <listitem><para>Run the
><filename>menuconfig</filename>
>                         command:
>                         <literallayout class='monospaced'>
>      $ bitbake linux-yocto -c menuconfig
>                         </literallayout></para></listitem>
>-                    <listitem><para>Prepare a configuration fragment
>based on
>-                        the differences between the two files.
>-                        </para></listitem>
>+                    <listitem><para>Run the
><filename>diffconfig</filename>
>+                        command to prepare a configuration fragment.
>+                        The result file
><filename>fragment.cfg</filename> will be placed in
>+                        <filename>${</filename><ulink
>url='&YOCTO_DOCS_REF_URL;#var-WORKDIR'><filename>WORKDIR</filename></ulink
>><filename>}</filename> directory:
>+                        <literallayout class='monospaced'>
>+     $ bitbake linux-yocto -c diffconfig
>+                        </literallayout></para></listitem>
>                 </orderedlist>
>             </para>
> 
>             <para>
>-                Ultimately, the configuration fragment file needs to be a
>+                The <filename>diffconfig</filename> command creates a
>file that is a
>                 list of Linux kernel <filename>CONFIG_</filename>
>assignments.
>-                It cannot be in <filename>diff</filename> format.
>-                Here is an example of a command that creates your
>-                configuration fragment file.
>-                Regardless of the exact command you use, plan on
>reviewing
>-                the output as you can usually remove some of the
>defaults:
>-                <literallayout class='monospaced'>
>-     $ diff -Nurp config.orig .config | sed -n "s/^\+//p" > frag.cfg
>-                </literallayout>
>+
>                 See the "<link
>linkend='changing-the-configuration'>Changing the Configuration</link>"
>                 section for information on how to use the output as a
>                 configuration fragment.
>-- 
>1.8.3.2
>
>_______________________________________________
>yocto mailing list
>yocto at yoctoproject.org
>https://lists.yoctoproject.org/listinfo/yocto
>


-- 
Darren Hart
Yocto Project - Linux Kernel
Intel Open Source Technology Center