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:" |
