diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2013-05-29 14:09:04 +0300 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2013-05-31 08:19:25 +0100 |
commit | 2dcd1f0604e960ab173c7603209ccf2cbdcaaebf (patch) | |
tree | 6bdf11e7f1bc7d46adaab995d4c69cd6123ac087 /documentation/kernel-dev | |
parent | a0f4706d238d84380f2fffcea869096bcd643556 (diff) | |
download | poky-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.xml | 2 | ||||
-rw-r--r-- | documentation/kernel-dev/kernel-dev-common.xml | 33 |
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 | <your-layer>/recipes-kernel/linux/linux-yocto/ | 103 | <your-layer>/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:" |