All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH] Documentation: Clarify a couple minor things in kernel manual, ch 2.
@ 2015-03-02 11:13 Robert P. J. Day
  2015-03-02 16:31 ` Rifenbark, Scott M
  0 siblings, 1 reply; 2+ messages in thread
From: Robert P. J. Day @ 2015-03-02 11:13 UTC (permalink / raw)
  To: Yocto discussion list

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

Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>

---

diff --git a/documentation/kernel-dev/kernel-dev-common.xml b/documentation/kernel-dev/kernel-dev-common.xml
index 56fa17d..7840c0e 100644
--- a/documentation/kernel-dev/kernel-dev-common.xml
+++ b/documentation/kernel-dev/kernel-dev-common.xml
@@ -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>


-- 

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

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


^ permalink raw reply related	[flat|nested] 2+ messages in thread

* Re: [PATCH] Documentation: Clarify a couple minor things in kernel manual, ch 2.
  2015-03-02 11:13 [PATCH] Documentation: Clarify a couple minor things in kernel manual, ch 2 Robert P. J. Day
@ 2015-03-02 16:31 ` Rifenbark, Scott M
  0 siblings, 0 replies; 2+ messages in thread
From: Rifenbark, Scott M @ 2015-03-02 16:31 UTC (permalink / raw)
  To: Robert P. J. Day, Yocto discussion list

Applied... thanks Robert.

>-----Original Message-----
>From: yocto-bounces@yoctoproject.org [mailto:yocto-
>bounces@yoctoproject.org] 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 <rpjday@crashcourse.ca>
>
>---
>
>diff --git a/documentation/kernel-dev/kernel-dev-common.xml
>b/documentation/kernel-dev/kernel-dev-common.xml
>index 56fa17d..7840c0e 100644
>--- a/documentation/kernel-dev/kernel-dev-common.xml
>+++ b/documentation/kernel-dev/kernel-dev-common.xml
>@@ -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>
>
>
>--
>
>===========================================================
>=============
>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
>yocto@yoctoproject.org
>https://lists.yoctoproject.org/listinfo/yocto


^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2015-03-02 16:31 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2015-03-02 11:13 [PATCH] Documentation: Clarify a couple minor things in kernel manual, ch 2 Robert P. J. Day
2015-03-02 16:31 ` Rifenbark, Scott M

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.