kdbg/doc/en/globaloptions.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 - Global Options</title>
   7 </head>
   8 <body text="#000000" bgcolor="#ffffff">
   9 <p><a href="index.html">Contents</a></p>
  10 <h1>
  11 Global Options Dialog</h1>
  12 <p>To specify some global options, choose <i>Settings|Global Options</i>. You
  13 can set the following:</p>
  14 <ul>
  15 <li>
  16 the command by which gdb is invoked,</li>
  17
  18 <li>
  19 the command that opens a terminal for the program's output,</li>
  20
  21 <li>
  22 whether the KDbg shall pop into the foreground when the program stops and
  23 a timeout when it shall go back again,</li>
  24
  25 <li>
  26 the tab width,</li>
  27
  28 <li>
  29 filters for source file names.</li>
  30 </ul>
  31
  32 <h4>
  33 How to invoke gdb</h4>
  34
  35 <blockquote>If you want to use a different version of gdb, you can specify
  36 it under
  37 <i>How to invoke GDB</i>. The default command is <tt>gdb --fullname
  38 --nx</tt>. Be sure to also specify these options if you change the gdb
  39 executable. If you leave them away, KDbg will not work. If you messed up
  40 the entry, you can clear it to revert to the default setting.</blockquote>
  41
  42 <h4>
  43 How to invoke a terminal emulator</h4>
  44
  45 <blockquote>If you want to use a different terminal program to show the
  46 output of the program, specify it under <i>Terminal for program output</i>.
  47 The default setting is <tt>xterm -name kdbgio -title %T -e sh -c %C</tt>.
  48 In this entry,
  49 <tt>%T</tt> will be replaced by a title string, <tt>%C</tt>
  50 will be replaced by a Bourne shell script that loops infinitely so that
  51 the terminal window doesn't close. (No, it doesn't use CPU, it calls <tt>sleep
  52 3600</tt> in a loop :) An alternative for this setting could be <tt>konsole
  53 --name kdbgio --caption %T -e sh -c %C</tt>.</blockquote>
  54
  55 <h4>
  56 Pop into foreground</h4>
  57
  58 <blockquote>You can specify whether the KDbg window shall move itself into
  59 the foreground as soon as the program being debugged stops (at a breakpoint
  60 or due to a signal). The KDbg window is not activated, however (at least
  61 under KWM, the KDE window manager). Some users may feel that this behavior
  62 is intrusive, so this option is off by default.</blockquote>
  63
  64 <blockquote>If this option is on, KDbg will also retreat itself into the
  65 background when the program is continued by any command, but it does so
  66 only after a timeout that can be specified. This avoids that the debugger
  67 window flashes back and forth each time you click any of the <i>Step</i>
  68 commands.</blockquote>
  69
  70 <h4>
  71 File filters</h4>
  72
  73 <blockquote>You can specify wildcards for source files and header files,
  74 which are used in the file dialog of the <i>File|Open Source</i>
  75 command.</blockquote>
  76
  77 </body>
  78 </html>