1 files changed, 10 insertions, 2 deletions

diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 3dd9183bcf..34ce56a080 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -1029,8 +1029,16 @@
                     This command is used by BitBake to launch a terminal window with a 
                     shell. 
                     The shell is unspecified so the user's default shell is used. 
-                    By default, the variable is set to "gnome-terminal" but it can 
-                    be any X11 terminal application or terminal multiplexers-like screen.
+                    By default, the variable is set to "xterm" but it can 
+                    be any X11 terminal application or a terminal multiplexer such as screen.
+                </para>
+                <para>
+                    NOTE: whilst KONSOLE_TERMCMD and KONSOLE_TERMCMDRUN are provided
+                    and will work with KDE's Konsole terminal application Konsole from KDE 3,
+                    Konsole in KDE 4.0 and later will no longer work here due to the fact
+                    that it now launches in the background by default, and it is not practically
+                    possible to wait until it has terminated. It is hoped that this can be fixed
+                    in a future version.
                 </para>
             </glossdef>
         </glossentry>