mingw/info/gdb/Prompting.html

   1 <html lang="en">
   2 <head>
   3 <title>Debugging with GDB</title>
   4 <meta http-equiv="Content-Type" content="text/html">
   5 <meta name="description" content="Debugging with GDB">
   6 <meta name="generator" content="makeinfo 4.3">
   7 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home">
   8 </head>
   9 <body>
  10 <div class="node">
  11 <p>
  12 Node:<a name="Prompting">Prompting</a>,
  13 Next:<a rel="next" accesskey="n" href="Errors.html#Errors">Errors</a>,
  14 Previous:<a rel="previous" accesskey="p" href="Displays.html#Displays">Displays</a>,
  15 Up:<a rel="up" accesskey="u" href="Annotations.html#Annotations">Annotations</a>
  16 <hr><br>
  17 </div>
  18
  19 <h3 class="section">Annotation for GDB Input</h3>
  20
  21    <p>When GDB prompts for input, it annotates this fact so it is possible
  22 to know when to send output, when the output from a given command is
  23 over, etc.
  24
  25    <p>Different kinds of input each have a different <dfn>input type</dfn>.  Each
  26 input type has three annotations: a <code>pre-</code> annotation, which
  27 denotes the beginning of any prompt which is being output, a plain
  28 annotation, which denotes the end of the prompt, and then a <code>post-</code>
  29 annotation which denotes the end of any echo which may (or may not) be
  30 associated with the input.  For example, the <code>prompt</code> input type
  31 features the following annotations:
  32
  33 <pre class="smallexample">     ^Z^Zpre-prompt
  34      ^Z^Zprompt
  35      ^Z^Zpost-prompt
  36      </pre>
  37
  38    <p>The input types are
  39
  40      <dl>
  41 <dt><code>prompt</code>
  42      <dd>When GDB is prompting for a command (the main GDB prompt).
  43
  44      <br><dt><code>commands</code>
  45      <dd>When GDB prompts for a set of commands, like in the <code>commands</code>
  46 command.  The annotations are repeated for each command which is input.
  47
  48      <br><dt><code>overload-choice</code>
  49      <dd>When GDB wants the user to select between various overloaded functions.
  50
  51      <br><dt><code>query</code>
  52      <dd>When GDB wants the user to confirm a potentially dangerous operation.
  53
  54      <br><dt><code>prompt-for-continue</code>
  55      <dd>When GDB is asking the user to press return to continue.  Note: Don't
  56 expect this to work well; instead use <code>set height 0</code> to disable
  57 prompting.  This is because the counting of lines is buggy in the
  58 presence of annotations.
  59 </dl>
  60
  61    </body></html>
  62