diff options
Diffstat (limited to 'bitbake/doc')
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml | 32 |
1 files changed, 30 insertions, 2 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml index d7d6c92ee8..fbffade348 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml | |||
@@ -1065,13 +1065,41 @@ | |||
1065 | <title>Deleting a Task</title> | 1065 | <title>Deleting a Task</title> |
1066 | 1066 | ||
1067 | <para> | 1067 | <para> |
1068 | As well as being able to add tasks, tasks can also be deleted. | 1068 | As well as being able to add tasks, you can delete them. |
1069 | This is done simply with <filename>deltask</filename> command. | 1069 | Simply use the <filename>deltask</filename> command to |
1070 | delete a task. | ||
1070 | For example, to delete the example task used in the previous | 1071 | For example, to delete the example task used in the previous |
1071 | sections, you would use: | 1072 | sections, you would use: |
1072 | <literallayout class='monospaced'> | 1073 | <literallayout class='monospaced'> |
1073 | deltask printdate | 1074 | deltask printdate |
1074 | </literallayout> | 1075 | </literallayout> |
1076 | If you delete a task using the <filename>deltask</filename> | ||
1077 | command and the task has dependencies, the dependencies are | ||
1078 | not reconnected. | ||
1079 | For example, suppose you have three tasks named | ||
1080 | <filename>do_a</filename>, <filename>do_b</filename>, and | ||
1081 | <filename>do_c</filename>. | ||
1082 | Furthermore, <filename>do_c</filename> is dependent on | ||
1083 | <filename>do_b</filename>, which in turn is dependent on | ||
1084 | <filename>do_a</filename>. | ||
1085 | Given this scenario, if you use <filename>deltask</filename> | ||
1086 | to delete <filename>do_b</filename>, the implicit dependency | ||
1087 | relationship between <filename>do_c</filename> and | ||
1088 | <filename>do_a</filename> through <filename>do_b</filename> | ||
1089 | no longer exists, and <filename>do_c</filename> dependencies | ||
1090 | are not updated to include <filename>do_a</filename>. | ||
1091 | Thus, <filename>do_c</filename> is free to run before | ||
1092 | <filename>do_a</filename>. | ||
1093 | </para> | ||
1094 | |||
1095 | <para> | ||
1096 | If you want dependencies such as these to remain intact, use | ||
1097 | the <filename>noexec</filename> varflag to disable the task | ||
1098 | instead of using the <filename>deltask</filename> command to | ||
1099 | delete it: | ||
1100 | <literallayout class='monospaced'> | ||
1101 | do_b[noexec] = "1" | ||
1102 | </literallayout> | ||
1075 | </para> | 1103 | </para> |
1076 | </section> | 1104 | </section> |
1077 | 1105 | ||