diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2014-06-11 10:46:05 +0300 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-06-18 10:30:48 +0100 |
commit | a19f575cde39917e4632dab1e813d84402f95937 (patch) | |
tree | 856fc2d185f4eef07af46a14f1e659285793e42b /documentation/dev-manual/dev-manual-common-tasks.xml | |
parent | 50af2dc53778c712c21538f82025427d558cba63 (diff) | |
download | poky-a19f575cde39917e4632dab1e813d84402f95937.tar.gz |
dev-manual, kernel-dev, ref-manual: Updated task name usage.
There was inconsistency on how we refer to a task name throughout
the YP manual set. The proper way is "do_<taskname>". Some
occurrences did not include the "do_" prefix. These have been
fixed.
(From yocto-docs rev: b32821bb0d3e6de7bca68b25c662a023526a10c4)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/dev-manual/dev-manual-common-tasks.xml')
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 79 |
1 files changed, 50 insertions, 29 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 0c66a7c232..3922c8f0f4 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml | |||
@@ -3548,7 +3548,7 @@ | |||
3548 | 3548 | ||
3549 | <para> | 3549 | <para> |
3550 | As part of the kernel build process, the | 3550 | As part of the kernel build process, the |
3551 | <filename>kernel_configcheck</filename> task runs. | 3551 | <filename>do_kernel_configcheck</filename> task runs. |
3552 | This task validates the kernel configuration by checking the final | 3552 | This task validates the kernel configuration by checking the final |
3553 | <filename>.config</filename> file against the input files. | 3553 | <filename>.config</filename> file against the input files. |
3554 | During the check, the task produces warning messages for the following | 3554 | During the check, the task produces warning messages for the following |
@@ -3565,8 +3565,9 @@ | |||
3565 | In other words, the option does not appear anywhere.</para></listitem> | 3565 | In other words, the option does not appear anywhere.</para></listitem> |
3566 | </itemizedlist> | 3566 | </itemizedlist> |
3567 | <note> | 3567 | <note> |
3568 | The <filename>kernel_configcheck</filename> task can also optionally report | 3568 | The <filename>do_kernel_configcheck</filename> task can |
3569 | if an option is overridden during processing. | 3569 | also optionally report if an option is overridden during |
3570 | processing. | ||
3570 | </note> | 3571 | </note> |
3571 | </para> | 3572 | </para> |
3572 | 3573 | ||
@@ -3580,29 +3581,45 @@ | |||
3580 | <para> | 3581 | <para> |
3581 | To streamline the configuration, do the following: | 3582 | To streamline the configuration, do the following: |
3582 | <orderedlist> | 3583 | <orderedlist> |
3583 | <listitem><para>Start with a full configuration that you know | 3584 | <listitem><para>Start with a full configuration that you |
3584 | works - it builds and boots successfully. | 3585 | know works - it builds and boots successfully. |
3585 | This configuration file will be your baseline.</para></listitem> | 3586 | This configuration file will be your baseline. |
3586 | <listitem><para>Separately run the <filename>configme</filename> and | 3587 | </para></listitem> |
3587 | <filename>kernel_configcheck</filename> tasks.</para></listitem> | 3588 | <listitem><para>Separately run the |
3589 | <filename>do_configme</filename> and | ||
3590 | <filename>do_kernel_configcheck</filename> tasks. | ||
3591 | </para></listitem> | ||
3588 | <listitem><para>Take the resulting list of files from the | 3592 | <listitem><para>Take the resulting list of files from the |
3589 | <filename>kernel_configcheck</filename> task warnings and do the following: | 3593 | <filename>do_kernel_configcheck</filename> task |
3594 | warnings and do the following: | ||
3590 | <itemizedlist> | 3595 | <itemizedlist> |
3591 | <listitem><para>Drop values that are redefined in the fragment but do not | 3596 | <listitem><para> |
3592 | change the final <filename>.config</filename> file.</para></listitem> | 3597 | Drop values that are redefined in the fragment |
3593 | <listitem><para>Analyze and potentially drop values from the | 3598 | but do not change the final |
3594 | <filename>.config</filename> file that override required | 3599 | <filename>.config</filename> file. |
3595 | configurations.</para></listitem> | 3600 | </para></listitem> |
3596 | <listitem><para>Analyze and potentially remove non-board specific options. | 3601 | <listitem><para> |
3602 | Analyze and potentially drop values from the | ||
3603 | <filename>.config</filename> file that override | ||
3604 | required configurations. | ||
3605 | </para></listitem> | ||
3606 | <listitem><para> | ||
3607 | Analyze and potentially remove non-board | ||
3608 | specific options. | ||
3609 | </para></listitem> | ||
3610 | <listitem><para> | ||
3611 | Remove repeated and invalid options. | ||
3597 | </para></listitem> | 3612 | </para></listitem> |
3598 | <listitem><para>Remove repeated and invalid options.</para></listitem> | ||
3599 | </itemizedlist></para></listitem> | 3613 | </itemizedlist></para></listitem> |
3600 | <listitem><para>After you have worked through the output of the kernel configuration | 3614 | <listitem><para> |
3601 | audit, you can re-run the <filename>configme</filename> | 3615 | After you have worked through the output of the kernel |
3602 | and <filename>kernel_configcheck</filename> tasks to see the results of your | 3616 | configuration audit, you can re-run the |
3603 | changes. | 3617 | <filename>do_configme</filename> and |
3604 | If you have more issues, you can deal with them as described in the | 3618 | <filename>do_kernel_configcheck</filename> tasks to |
3605 | previous step.</para></listitem> | 3619 | see the results of your changes. |
3620 | If you have more issues, you can deal with them as | ||
3621 | described in the previous step. | ||
3622 | </para></listitem> | ||
3606 | </orderedlist> | 3623 | </orderedlist> |
3607 | </para> | 3624 | </para> |
3608 | 3625 | ||
@@ -5149,14 +5166,18 @@ Gateways via their Web Interfaces</ulink>"</emphasis> | |||
5149 | <section id="usingpoky-configuring-DISTRO_PN_ALIAS"> | 5166 | <section id="usingpoky-configuring-DISTRO_PN_ALIAS"> |
5150 | <title>Handling a Package Name Alias</title> | 5167 | <title>Handling a Package Name Alias</title> |
5151 | <para> | 5168 | <para> |
5152 | Sometimes a package name you are using might exist under an alias or as a similarly named | 5169 | Sometimes a package name you are using might exist under |
5153 | package in a different distribution. | 5170 | an alias or as a similarly named package in a different |
5154 | The OpenEmbedded build system implements a <filename>distro_check</filename> | 5171 | distribution. |
5172 | The OpenEmbedded build system implements a | ||
5173 | <filename>do_distro_check</filename> | ||
5155 | task that automatically connects to major distributions | 5174 | task that automatically connects to major distributions |
5156 | and checks for these situations. | 5175 | and checks for these situations. |
5157 | If the package exists under a different name in a different distribution, you get a | 5176 | If the package exists under a different name in a different |
5158 | <filename>distro_check</filename> mismatch. | 5177 | distribution, you get a <filename>distro_check</filename> |
5159 | You can resolve this problem by defining a per-distro recipe name alias using the | 5178 | mismatch. |
5179 | You can resolve this problem by defining a per-distro recipe | ||
5180 | name alias using the | ||
5160 | <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_PN_ALIAS'>DISTRO_PN_ALIAS</ulink></filename> | 5181 | <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_PN_ALIAS'>DISTRO_PN_ALIAS</ulink></filename> |
5161 | variable. | 5182 | variable. |
5162 | </para> | 5183 | </para> |
@@ -6922,7 +6943,7 @@ Gateways via their Web Interfaces</ulink>"</emphasis> | |||
6922 | Returns "True" if <filename>pkg</filename> is in the | 6943 | Returns "True" if <filename>pkg</filename> is in the |
6923 | installed package list of the image, which is based | 6944 | installed package list of the image, which is based |
6924 | on the manifest file that is generated during the | 6945 | on the manifest file that is generated during the |
6925 | <filename>do.rootfs</filename> task. | 6946 | <filename>do_rootfs</filename> task. |
6926 | </para></listitem> | 6947 | </para></listitem> |
6927 | <listitem><para><emphasis><filename>hasFeature(feature)</filename>:</emphasis> | 6948 | <listitem><para><emphasis><filename>hasFeature(feature)</filename>:</emphasis> |
6928 | Returns "True" if the feature is in | 6949 | Returns "True" if the feature is in |