diff --git a/documentation/dev-manual/dev-manual-model.xml b/documentation/dev-manual/dev-manual-model.xml index c14c524aa5..8fc0d06830 100644 --- a/documentation/dev-manual/dev-manual-model.xml +++ b/documentation/dev-manual/dev-manual-model.xml @@ -1859,9 +1859,40 @@ directory. - This command opens a terminal with a shell prompt within the OpenEmbedded build environment. - The default shell is xterm. - The following occurs: + This command spawns a terminal with a shell prompt within the OpenEmbedded build environment. + The OE_TERMINAL + controls what type of shell is opened. + You can define the variable in the conf/local.conf + configuration file in the Build Directory. + + + + Current available terminals are: + + auto + gnome + xfce + rxvt + screen + konsole (KDE 3.x only) + none + + The default terminal type is "auto" and causes + the OpenEmbedded build system to attempt to spawn terminals in a + priority order until one is found that is available on the host + development system. + For the case of an X terminal, DISPLAY must also + be defined. + + + + If OE_TERMINAL is set to "none", the system + never spawns a terminal under any circumstances. + Use this setting when you are doing automated builds. + + + + For spawned terminals, the following occurs: The PATH variable includes the cross-toolchain. @@ -1870,6 +1901,9 @@ directory. The configure command finds the Yocto Project site files as well as any other necessary files. + + + Within this environment, you can run configure or compile commands as if they were being run by the OpenEmbedded build system itself. diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml index 869ff550d4..289057eaa3 100644 --- a/documentation/poky-ref-manual/ref-variables.xml +++ b/documentation/poky-ref-manual/ref-variables.xml @@ -30,7 +30,7 @@ L M - + O P R @@ -1943,8 +1943,41 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" - - + O + + OE_TERMINAL + + + Controls how the OpenEmbedded build system spawns terminals + on the host development system. + Because the build system needs to account for parallelism + during the build, concurrently running processes might require + attention (e.g. build cannot resove a patch). + For such a case, the host system needs to spawn and launch + an interactive shell. + + + + You can use the following values for the + OE_TERMINAL variable in the + conf/local.conf configuration file, which is found in + the Build Directory: + + auto + gnome + xfce + rxvt + screen + konsole + none + + Konsole support only works for KDE 3.x. + Also, "none" is the default behavior for + OE_TERMINAL + + + + P