summaryrefslogtreecommitdiffstats
path: root/documentation/kernel-dev
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-05-29 14:09:04 +0300
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-05-31 08:19:25 +0100
commit2dcd1f0604e960ab173c7603209ccf2cbdcaaebf (patch)
tree6bdf11e7f1bc7d46adaab995d4c69cd6123ac087 /documentation/kernel-dev
parenta0f4706d238d84380f2fffcea869096bcd643556 (diff)
downloadpoky-2dcd1f0604e960ab173c7603209ccf2cbdcaaebf.tar.gz
dev-manual, kernel-manual: Added links to THISDIR variable
There is now a glossary description for the THISDIR variable in ref-manual. I added some cross-reference links to the variable in key places of these two manuals. (From yocto-docs rev: d5e01204b864b81782be33d8119c05ef328f3fd7) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Conflicts: documentation/dev-manual/dev-manual-common-tasks.xml documentation/kernel-dev/kernel-dev-common.xml Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/kernel-dev')
-rw-r--r--documentation/kernel-dev/kernel-dev-advanced.xml2
-rw-r--r--documentation/kernel-dev/kernel-dev-common.xml33
2 files changed, 19 insertions, 16 deletions
diff --git a/documentation/kernel-dev/kernel-dev-advanced.xml b/documentation/kernel-dev/kernel-dev-advanced.xml
index 2626f691dc..d15e26ffbf 100644
--- a/documentation/kernel-dev/kernel-dev-advanced.xml
+++ b/documentation/kernel-dev/kernel-dev-advanced.xml
@@ -203,7 +203,7 @@
203 <filename>oe-core/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb</filename> 203 <filename>oe-core/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb</filename>
204 to a recipe in your layer, <filename>FILESEXTRAPATHS</filename> 204 to a recipe in your layer, <filename>FILESEXTRAPATHS</filename>
205 is typically set to 205 is typically set to
206 <filename>${THISDIR}/${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PN'><filename>PN</filename></ulink><filename>}</filename>. 206 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-THISDIR'><filename>THISDIR</filename></ulink><filename>}/${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PN'><filename>PN</filename></ulink><filename>}</filename>.
207 See the "<link linkend='modifying-an-existing-recipe'>Modifying an Existing Recipe</link>" 207 See the "<link linkend='modifying-an-existing-recipe'>Modifying an Existing Recipe</link>"
208 section for more information. 208 section for more information.
209 </para> 209 </para>
diff --git a/documentation/kernel-dev/kernel-dev-common.xml b/documentation/kernel-dev/kernel-dev-common.xml
index f0e95aca07..fb258f286c 100644
--- a/documentation/kernel-dev/kernel-dev-common.xml
+++ b/documentation/kernel-dev/kernel-dev-common.xml
@@ -92,10 +92,13 @@
92 <literallayout class='monospaced'> 92 <literallayout class='monospaced'>
93 <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'>FILESEXTRAPATHS</ulink> := "${THISDIR}/${PN}" 93 <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'>FILESEXTRAPATHS</ulink> := "${THISDIR}/${PN}"
94 </literallayout> 94 </literallayout>
95 The path <filename>${THISDIR}/${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PN'><filename>PN</filename></ulink><filename>}</filename> expands 95 The path <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-THISDIR'><filename>THISDIR</filename></ulink><filename>}/${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PN'><filename>PN</filename></ulink><filename>}</filename>
96 to "linux-yocto" in the current directory for this example. 96 expands to "linux-yocto" in the current directory for this
97 If you add any new files that modify the kernel recipe, 97 example.
98 you need to place them in your layer in the following area: 98 If you add any new files that modify the kernel recipe and you
99 have extended <filename>FILESPATH</filename> as
100 described above, you must place the files in your layer in the
101 following area:
99 <literallayout class='monospaced'> 102 <literallayout class='monospaced'>
100 &lt;your-layer&gt;/recipes-kernel/linux/linux-yocto/ 103 &lt;your-layer&gt;/recipes-kernel/linux/linux-yocto/
101 </literallayout> 104 </literallayout>
@@ -149,15 +152,15 @@
149 You can make wholesale or incremental changes to the Linux 152 You can make wholesale or incremental changes to the Linux
150 kernel <filename>.config</filename> file by including a 153 kernel <filename>.config</filename> file by including a
151 <filename>defconfig</filename> or by specifying 154 <filename>defconfig</filename> or by specifying
152 configuration fragments in the 155 configuration fragments in the
153 <ulink url='&YOCTO_DOCS_REF_URL;#var-SRC_URI'><filename>SRC_URI</filename></ulink>. 156 <ulink url='&YOCTO_DOCS_REF_URL;#var-SRC_URI'><filename>SRC_URI</filename></ulink>.
154 </para> 157 </para>
155 158
156 <para> 159 <para>
157 If you have a complete Linux kernel <filename>.config</filename> 160 If you have a complete Linux kernel <filename>.config</filename>
158 file you want to use, copy it to a directory named 161 file you want to use, copy it to a directory named
159 <filename>files</filename>, which must be in 162 <filename>files</filename>, which must be in
160 your layer's <filename>recipes-kernel/linux</filename> 163 your layer's <filename>recipes-kernel/linux</filename>
161 directory, and name the file "defconfig". 164 directory, and name the file "defconfig".
162 Then, add the following lines to your linux-yocto 165 Then, add the following lines to your linux-yocto
163 <filename>.bbappend</filename> file in your layer: 166 <filename>.bbappend</filename> file in your layer:
@@ -165,13 +168,13 @@
165 FILESEXTRAPATHS_prepend := "${THISDIR}/files:" 168 FILESEXTRAPATHS_prepend := "${THISDIR}/files:"
166 SRC_URI += "file://defconfig" 169 SRC_URI += "file://defconfig"
167 </literallayout> 170 </literallayout>
168 The 171 The
169 <filename>SRC_URI</filename> tells the build system how to 172 <filename>SRC_URI</filename> tells the build system how to
170 search for the file, while the 173 search for the file, while the
171 <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'><filename>FILESEXTRAPATHS</filename></ulink> 174 <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'><filename>FILESEXTRAPATHS</filename></ulink>
172 extends the 175 extends the
173 <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESPATH'><filename>FILESPATH</filename></ulink> 176 <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESPATH'><filename>FILESPATH</filename></ulink>
174 variable (search directories) to include the 177 variable (search directories) to include the
175 <filename>files</filename> directory you created for the 178 <filename>files</filename> directory you created for the
176 configuration changes. 179 configuration changes.
177 </para> 180 </para>
@@ -193,8 +196,8 @@
193 CONFIG_SERIAL_CORE=y 196 CONFIG_SERIAL_CORE=y
194 CONFIG_SERIAL_CORE_CONSOLE=y 197 CONFIG_SERIAL_CORE_CONSOLE=y
195 </literallayout> 198 </literallayout>
196 Next, include this configuration fragment and extend the 199 Next, include this configuration fragment and extend the
197 <filename>FILESPATH</filename> variable in your 200 <filename>FILESPATH</filename> variable in your
198 <filename>.bbappend</filename> file: 201 <filename>.bbappend</filename> file:
199 <literallayout class='monospaced'> 202 <literallayout class='monospaced'>
200 FILESEXTRAPATHS_prepend := "${THISDIR}/files:" 203 FILESEXTRAPATHS_prepend := "${THISDIR}/files:"