kdbg/doc/en/pgmoutput.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <html>
   3 <head>
   4    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5    <meta name="Author" content="Johannes Sixt">
   6    <title>KDbg - User's Manual - Program Output</title>
   7 </head>
   8 <body text="#000000" bgcolor="#FFFFFF">
   9 <p><a href="index.html">Contents</a></p>
  10 <h1>
  11 The Program Output Window</h1>
  12 <p>The program output window is displayed using <i>View|Output</i>. The output
  13 window captures text that is written to stdout and stderr by the program
  14 being debugged.</p>
  15 <p>The output window does not allow to type input for the program and it
  16 features only minimal terminal emulation: <tt>\n</tt> (line-feed),
  17 <tt>\t</tt> (horizontal tab), and <tt>\r</tt> (carriage-return)
  18 are treated. These capabilities are usually sufficient to debug GUI programs
  19 which only write debugging output to stdout and stderr.</p>
  20 <p>When a program is debugged with KDbg for the first time, the program
  21 output window is <em>not</em> used. The reason for this is that KDbg cannot
  22 know whether the program requires sophisticated terminal emulation or if
  23 it expects input through a terminal. So, a terminal emulator program is
  24 used by default. In order to redirect the output to the output window,
  25 you must do the following:</p>
  26 <ol>
  27 <li>
  28 Open the <a href="pgmsettings.html">Settings dialog</a> by selecting <i>Settings|This Program</i>.</li>
  29
  30 <li>
  31 Switch to the <i>Output</i> tab.</li>
  32
  33 <li>
  34 Choose <i>Only output, simple terminal emulation</i> and click <i>OK</i>.</li>
  35
  36 <li>
  37 Reload the program by selecting it from the list in <i>File|Recent Executables</i>.</li>
  38 </ol>
  39 <p>You can clear the contents of the output window by selecting <i>Clear</i>
  40 from the popup menu that appears when you click the right mouse button.</p>
  41 <p>If the last line of the output is visible, the window always scrolls
  42 automatically so that the last line remains visible when new output arrives.
  43 If, however, you manually scroll up so that the last line is not visible,
  44 the visible portion of text will not change.</p>
  45 </body>
  46 </html>