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. |
