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