summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r--documentation/dev-manual/dev-manual-model.xml27
1 files changed, 25 insertions, 2 deletions
diff --git a/documentation/dev-manual/dev-manual-model.xml b/documentation/dev-manual/dev-manual-model.xml
index f82a489fac..cad204d3b7 100644
--- a/documentation/dev-manual/dev-manual-model.xml
+++ b/documentation/dev-manual/dev-manual-model.xml
@@ -2832,10 +2832,33 @@
2832 </para> 2832 </para>
2833 2833
2834 <para> 2834 <para>
2835 When you are finished, you just exit the shell or close the terminal window. 2835 To manually run a specific task using <filename>devshell</filename>,
2836 run the corresponding <filename>run.*</filename> script in
2837 the
2838 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-WORKDIR'><filename>WORKDIR</filename></ulink><filename>}/temp</filename>
2839 (e.g., <filename>run.do_configure.</filename><replaceable>pid</replaceable>).
2840 If a task's script does not exist, which would be the case if the task was
2841 skipped by way of the sstate cache, you can create the task by first running
2842 it outside of the <filename>devshell</filename>:
2843 <literallayout class='monospaced'>
2844 $ bitbake -c <replaceable>task</replaceable>
2845 </literallayout>
2846 </para>
2847
2848 <para>
2849 Remember, that the <filename>devshell</filename> is a mechanism that allows
2850 you to get into the BitBake task execution environment.
2851 And as such, all commands must be called just as BitBake would call them.
2852 That means you need to provide the appropriate options for
2853 cross-compilation and so forth as applicable.
2854 </para>
2855
2856 <para>
2857 When you are finished using <filename>devshell</filename>, exit the shell
2858 or close the terminal window.
2836 </para> 2859 </para>
2837 2860
2838 <note> 2861 <note><title>Notes</title>
2839 <para> 2862 <para>
2840 It is worth remembering that when using <filename>devshell</filename> 2863 It is worth remembering that when using <filename>devshell</filename>
2841 you need to use the full compiler name such as <filename>arm-poky-linux-gnueabi-gcc</filename> 2864 you need to use the full compiler name such as <filename>arm-poky-linux-gnueabi-gcc</filename>