diff options
Diffstat (limited to 'documentation/dev-manual/dev-manual-common-tasks.xml')
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 32 |
1 files changed, 16 insertions, 16 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 108ac78fe0..8f39d19044 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml | |||
@@ -59,7 +59,7 @@ | |||
59 | <title>Layers</title> | 59 | <title>Layers</title> |
60 | 60 | ||
61 | <para> | 61 | <para> |
62 | The <link linkend='source-directory'>Source Directory</link> | 62 | The <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink> |
63 | contains both general layers and BSP | 63 | contains both general layers and BSP |
64 | layers right out of the box. | 64 | layers right out of the box. |
65 | You can easily identify layers that ship with a | 65 | You can easily identify layers that ship with a |
@@ -438,7 +438,7 @@ | |||
438 | </para></listitem> | 438 | </para></listitem> |
439 | <listitem><para>Clone the repository alongside other | 439 | <listitem><para>Clone the repository alongside other |
440 | <filename>meta</filename> directories in the | 440 | <filename>meta</filename> directories in the |
441 | <link linkend='source-directory'>Source Directory</link>. | 441 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>. |
442 | </para></listitem> | 442 | </para></listitem> |
443 | </itemizedlist> | 443 | </itemizedlist> |
444 | Following these recommendations keeps your Source Directory and | 444 | Following these recommendations keeps your Source Directory and |
@@ -736,7 +736,7 @@ | |||
736 | <para> | 736 | <para> |
737 | As an example, consider the main formfactor recipe and a | 737 | As an example, consider the main formfactor recipe and a |
738 | corresponding formfactor append file both from the | 738 | corresponding formfactor append file both from the |
739 | <link linkend='source-directory'>Source Directory</link>. | 739 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>. |
740 | Here is the main formfactor recipe, which is named | 740 | Here is the main formfactor recipe, which is named |
741 | <filename>formfactor_0.0.bb</filename> and located in the | 741 | <filename>formfactor_0.0.bb</filename> and located in the |
742 | "meta" layer at | 742 | "meta" layer at |
@@ -3074,7 +3074,7 @@ | |||
3074 | class. | 3074 | class. |
3075 | See the <filename>systemd.bbclass</filename> file | 3075 | See the <filename>systemd.bbclass</filename> file |
3076 | located in your | 3076 | located in your |
3077 | <link linkend='source-directory'>Source Directory</link>. | 3077 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>. |
3078 | section for more information. | 3078 | section for more information. |
3079 | </para></listitem> | 3079 | </para></listitem> |
3080 | </itemizedlist> | 3080 | </itemizedlist> |
@@ -4177,7 +4177,7 @@ | |||
4177 | <para> | 4177 | <para> |
4178 | Several examples exist in the | 4178 | Several examples exist in the |
4179 | <filename>meta-skeleton</filename> layer found in the | 4179 | <filename>meta-skeleton</filename> layer found in the |
4180 | <link linkend='source-directory'>Source Directory</link>: | 4180 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>: |
4181 | <itemizedlist> | 4181 | <itemizedlist> |
4182 | <listitem><para><filename>conf/multilib-example.conf</filename> | 4182 | <listitem><para><filename>conf/multilib-example.conf</filename> |
4183 | configuration file</para></listitem> | 4183 | configuration file</para></listitem> |
@@ -4203,7 +4203,7 @@ | |||
4203 | Many standard recipes are already extended and support multiple libraries. | 4203 | Many standard recipes are already extended and support multiple libraries. |
4204 | You can check in the <filename>meta/conf/multilib.conf</filename> | 4204 | You can check in the <filename>meta/conf/multilib.conf</filename> |
4205 | configuration file in the | 4205 | configuration file in the |
4206 | <link linkend='source-directory'>Source Directory</link> to see how this is | 4206 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink> to see how this is |
4207 | done using the | 4207 | done using the |
4208 | <ulink url='&YOCTO_DOCS_REF_URL;#var-BBCLASSEXTEND'><filename>BBCLASSEXTEND</filename></ulink> | 4208 | <ulink url='&YOCTO_DOCS_REF_URL;#var-BBCLASSEXTEND'><filename>BBCLASSEXTEND</filename></ulink> |
4209 | variable. | 4209 | variable. |
@@ -5188,7 +5188,7 @@ | |||
5188 | The directory in which these files reside is | 5188 | The directory in which these files reside is |
5189 | <filename>scripts/lib/image/canned-wks/</filename> | 5189 | <filename>scripts/lib/image/canned-wks/</filename> |
5190 | located in the | 5190 | located in the |
5191 | <link linkend='source-directory'>Source Directory</link>. | 5191 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>. |
5192 | Because the available files reside in this directory, | 5192 | Because the available files reside in this directory, |
5193 | you can create and add your own custom files to the | 5193 | you can create and add your own custom files to the |
5194 | directory. | 5194 | directory. |
@@ -5937,7 +5937,7 @@ | |||
5937 | script found in the | 5937 | script found in the |
5938 | <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>. | 5938 | <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>. |
5939 | You must also be sure of the state of your build in the | 5939 | You must also be sure of the state of your build in the |
5940 | <link linkend='source-directory'>Source Directory</link>. | 5940 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>. |
5941 | The following commands run <filename>menuconfig</filename> | 5941 | The following commands run <filename>menuconfig</filename> |
5942 | assuming the Source Directory's top-level folder is | 5942 | assuming the Source Directory's top-level folder is |
5943 | <filename>~/poky</filename>: | 5943 | <filename>~/poky</filename>: |
@@ -6371,7 +6371,7 @@ | |||
6371 | or even altering the source code itself. | 6371 | or even altering the source code itself. |
6372 | <note> | 6372 | <note> |
6373 | You can use the <filename>yocto-kernel</filename> script | 6373 | You can use the <filename>yocto-kernel</filename> script |
6374 | found in the <link linkend='source-directory'>Source Directory</link> | 6374 | found in the <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink> |
6375 | under <filename>scripts</filename> to manage kernel patches and configuration. | 6375 | under <filename>scripts</filename> to manage kernel patches and configuration. |
6376 | See the "<ulink url='&YOCTO_DOCS_BSP_URL;#managing-kernel-patches-and-config-items-with-yocto-kernel'>Managing kernel Patches and Config Items with yocto-kernel</ulink>" | 6376 | See the "<ulink url='&YOCTO_DOCS_BSP_URL;#managing-kernel-patches-and-config-items-with-yocto-kernel'>Managing kernel Patches and Config Items with yocto-kernel</ulink>" |
6377 | section in the Yocto Project Board Support Packages (BSP) Developer's Guide for | 6377 | section in the Yocto Project Board Support Packages (BSP) Developer's Guide for |
@@ -6389,7 +6389,7 @@ | |||
6389 | <para> | 6389 | <para> |
6390 | The example assumes a clean build exists for the <filename>qemux86</filename> | 6390 | The example assumes a clean build exists for the <filename>qemux86</filename> |
6391 | machine in a | 6391 | machine in a |
6392 | <link linkend='source-directory'>Source Directory</link> | 6392 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink> |
6393 | named <filename>poky</filename>. | 6393 | named <filename>poky</filename>. |
6394 | Furthermore, the | 6394 | Furthermore, the |
6395 | <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink> | 6395 | <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink> |
@@ -6814,7 +6814,7 @@ | |||
6814 | The security flags are in the | 6814 | The security flags are in the |
6815 | <filename>meta/conf/distro/include/security_flags.inc</filename> | 6815 | <filename>meta/conf/distro/include/security_flags.inc</filename> |
6816 | file in your | 6816 | file in your |
6817 | <link linkend='source-directory'>Source Directory</link> | 6817 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink> |
6818 | (e.g. <filename>poky</filename>). | 6818 | (e.g. <filename>poky</filename>). |
6819 | <note> | 6819 | <note> |
6820 | Depending on the recipe, certain security flags are enabled | 6820 | Depending on the recipe, certain security flags are enabled |
@@ -7108,7 +7108,7 @@ | |||
7108 | The <filename>TEMPLATECONF</filename> variable is set in the | 7108 | The <filename>TEMPLATECONF</filename> variable is set in the |
7109 | <filename>.templateconf</filename> file, which is in the | 7109 | <filename>.templateconf</filename> file, which is in the |
7110 | top-level | 7110 | top-level |
7111 | <link linkend='source-directory'>Source Directory</link> | 7111 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink> |
7112 | folder (e.g. <filename>poky</filename>). | 7112 | folder (e.g. <filename>poky</filename>). |
7113 | Edit the <filename>.templateconf</filename> so that it can locate | 7113 | Edit the <filename>.templateconf</filename> so that it can locate |
7114 | your directory. | 7114 | your directory. |
@@ -7298,7 +7298,7 @@ | |||
7298 | <para> | 7298 | <para> |
7299 | To help you see where you currently are with kernel and root | 7299 | To help you see where you currently are with kernel and root |
7300 | filesystem sizes, you can use two tools found in the | 7300 | filesystem sizes, you can use two tools found in the |
7301 | <link linkend='source-directory'>Source Directory</link> in | 7301 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink> in |
7302 | the <filename>scripts/tiny/</filename> directory: | 7302 | the <filename>scripts/tiny/</filename> directory: |
7303 | <itemizedlist> | 7303 | <itemizedlist> |
7304 | <listitem><para><filename>ksize.py</filename>: Reports | 7304 | <listitem><para><filename>ksize.py</filename>: Reports |
@@ -10251,7 +10251,7 @@ | |||
10251 | <para> | 10251 | <para> |
10252 | All test files reside in | 10252 | All test files reside in |
10253 | <filename>meta/lib/oeqa/runtime</filename> in the | 10253 | <filename>meta/lib/oeqa/runtime</filename> in the |
10254 | <link linkend='source-directory'>Source Directory</link>. | 10254 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>. |
10255 | A test name maps directly to a Python module. | 10255 | A test name maps directly to a Python module. |
10256 | Each test module may contain a number of individual tests. | 10256 | Each test module may contain a number of individual tests. |
10257 | Tests are usually grouped together by the area | 10257 | Tests are usually grouped together by the area |
@@ -11350,7 +11350,7 @@ | |||
11350 | Once the patch file exists, you need to add it back to the | 11350 | Once the patch file exists, you need to add it back to the |
11351 | originating recipe folder. | 11351 | originating recipe folder. |
11352 | Here is an example assuming a top-level | 11352 | Here is an example assuming a top-level |
11353 | <link linkend='source-directory'>Source Directory</link> | 11353 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink> |
11354 | named <filename>poky</filename>: | 11354 | named <filename>poky</filename>: |
11355 | <literallayout class='monospaced'> | 11355 | <literallayout class='monospaced'> |
11356 | $ cp patches/parallelmake.patch poky/meta/recipes-connectivity/neard/neard | 11356 | $ cp patches/parallelmake.patch poky/meta/recipes-connectivity/neard/neard |
@@ -11700,7 +11700,7 @@ | |||
11700 | browse errors, view statistics, and query for errors. | 11700 | browse errors, view statistics, and query for errors. |
11701 | The tool works using a client-server system where the client | 11701 | The tool works using a client-server system where the client |
11702 | portion is integrated with the installed Yocto Project | 11702 | portion is integrated with the installed Yocto Project |
11703 | <link linkend='source-directory'>Source Directory</link> | 11703 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink> |
11704 | (e.g. <filename>poky</filename>). | 11704 | (e.g. <filename>poky</filename>). |
11705 | The server receives the information collected and saves it in a | 11705 | The server receives the information collected and saves it in a |
11706 | database. | 11706 | database. |