Skip to contentSkip to conversation

Documentation: Clarify a couple minor things in kernel manual, ch 2.

PATCH Applied Robert P. J. Day 2 participants 2 messages Mar 2, 2015

lore
Share & tools
lore

Robert P. J. Day

author
#0 lore raw

PATCH 1/1 Documentation: Clarify a couple minor things in kernel manual, ch 2.

Replace "files" with "${PN}" and reword discussion of defconfig file.

Signed-off-by Robert P. J. Day <[email protected]>

---

documentation/kernel-dev/kernel-dev-common.xml +14 -12
index 56fa17d..7840c0e 100644
@@ -156,23 +156,25 @@
             <title>Changing the Configuration</title>
 
             <para>
-                You can make wholesale or incremental changes to the Linux
-                kernel <filename>.config</filename> file by including a
-                <filename>defconfig</filename> and by specifying
+                You can make wholesale or incremental changes to the final
+                <filename>.config</filename> file used for the eventual
+                Linux kernel configuration by including a
+                <filename>defconfig</filename> file and by specifying
                 configuration fragments in the
-                <ulink url='&YOCTO_DOCS_REF_URL;#var-SRC_URI'><filename>SRC_URI</filename></ulink>.
+                <ulink url='&YOCTO_DOCS_REF_URL;#var-SRC_URI'><filename>SRC_URI</filename></ulink>
+                to be applied to that file.
             </para>
 
             <para>
-                If you have a final Linux kernel <filename>.config</filename>
-                file you want to use, copy it to a directory named
-                <filename>files</filename>, which must be in
-                your layer's <filename>recipes-kernel/linux</filename>
-                directory, and name the file "defconfig".
-                Then, add the following lines to your linux-yocto
+                If you have a complete, working Linux kernel <filename>.config</filename>
+                file you want to use for the configuration, as before, copy that file
+                to the appropriate <filename>${PN}</filename> directory in your
+                layer's <filename>recipes-kernel/linux</filename> directory,
+                and rename the copied file to "defconfig".
+                Then, add the following lines to the linux-yocto
                 <filename>.bbappend</filename> file in your layer:
                 <literallayout class='monospaced'>
-     FILESEXTRAPATHS_prepend := "${THISDIR}/files:"
+     FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:"
      SRC_URI += "file://defconfig"
                 </literallayout>
                 The <filename>SRC_URI</filename> tells the build system how to

@@ -181,7 +183,7 @@
                 extends the
                 <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESPATH'><filename>FILESPATH</filename></ulink>
                 variable (search directories) to include the
-                <filename>files</filename> directory you created for the
+                <filename>${PN}</filename> directory you created to hold the
                 configuration changes.
             </para>
Signature · 7 lines
========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================
Applied
#1 lore raw

Applied... thanks Robert.

Quoted 87 lines

-----Original Message-----
From: [email protected] [mailto:yocto- [email protected]] On Behalf Of Robert P. J. Day
Sent: Monday, March 02, 2015 3:13 AM
To: Yocto discussion list
Subject: [yocto] [PATCH] Documentation: Clarify a couple minor things in kernel manual, ch 2.

Replace "files" with "${PN}" and reword discussion of defconfig file.

Signed-off-by Robert P. J. Day <[email protected]>

---

documentation/kernel-dev/kernel-dev-common.xml +4 -4
index 56fa17d..7840c0e 100644
@@ -156,23 +156,25 @@
            <title>Changing the Configuration</title>
 
            <para>
-                You can make wholesale or incremental changes to the Linux
-                kernel <filename>.config</filename> file by including a
-                <filename>defconfig</filename> and by specifying
+                You can make wholesale or incremental changes to the final
+                <filename>.config</filename> file used for the eventual
+                Linux kernel configuration by including a
+                <filename>defconfig</filename> file and by specifying
                configuration fragments in the
-                <ulink url='&YOCTO_DOCS_REF_URL;#var-

SRC_URI'><filename>SRC_URI</filename></ulink>.
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-
SRC_URI'><filename>SRC_URI</filename></ulink>

documentation/kernel-dev/kernel-dev-common.xml +2 -6
+                to be applied to that file.
            </para>
 
            <para>
-                If you have a final Linux kernel <filename>.config</filename>
-                file you want to use, copy it to a directory named
-                <filename>files</filename>, which must be in
-                your layer's <filename>recipes-kernel/linux</filename>
-                directory, and name the file "defconfig".
-                Then, add the following lines to your linux-yocto
+                If you have a complete, working Linux kernel

<filename>.config</filename>

documentation/kernel-dev/kernel-dev-common.xml +6 -1
+                file you want to use for the configuration, as before, copy that file
+                to the appropriate <filename>${PN}</filename> directory in your
+                layer's <filename>recipes-kernel/linux</filename> directory,
+                and rename the copied file to "defconfig".
+                Then, add the following lines to the linux-yocto
                <filename>.bbappend</filename> file in your layer:
                <literallayout class='monospaced'>
-     FILESEXTRAPATHS_prepend := "${THISDIR}/files:"
+     FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:"
     SRC_URI += "file://defconfig"
                </literallayout>
                The <filename>SRC_URI</filename> tells the build system how to

@@ -181,7 +183,7 @@
                extends the
                <ulink url='&YOCTO_DOCS_REF_URL;#var-

FILESPATH'><filename>FILESPATH</filename></ulink>
variable (search directories) to include the

documentation/kernel-dev/kernel-dev-common.xml +2 -2
-                <filename>files</filename> directory you created for the
+                <filename>${PN}</filename> directory you created to
+ hold the
                configuration changes.
            </para>
 
 
--

===========================================================
=============
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday

===========================================================
=============
--
_______________________________________________
yocto mailing list
[email protected]
https://lists.yoctoproject.org/listinfo/yocto