1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<html> 3<!-- Copyright (C) 1994-2021 Free Software Foundation, Inc. 4 5Permission is granted to copy, distribute and/or modify this document 6under the terms of the GNU Free Documentation License, Version 1.3 or 7any later version published by the Free Software Foundation; with no 8Invariant Sections, with no Front-Cover Texts, and with no Back-Cover 9Texts. A copy of the license is included in the section entitled "GNU 10Free Documentation License". --> 11<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ --> 12<head> 13<title>GDB’s Obsolete Annotations: Prompting</title> 14 15<meta name="description" content="GDB’s Obsolete Annotations: Prompting"> 16<meta name="keywords" content="GDB’s Obsolete Annotations: Prompting"> 17<meta name="resource-type" content="document"> 18<meta name="distribution" content="global"> 19<meta name="Generator" content="makeinfo"> 20<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 21<link href="index.html#Top" rel="start" title="Top"> 22<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> 23<link href="index.html#Top" rel="up" title="Top"> 24<link href="Errors.html#Errors" rel="next" title="Errors"> 25<link href="Displays.html#Displays" rel="previous" title="Displays"> 26<style type="text/css"> 27<!-- 28a.summary-letter {text-decoration: none} 29blockquote.smallquotation {font-size: smaller} 30div.display {margin-left: 3.2em} 31div.example {margin-left: 3.2em} 32div.indentedblock {margin-left: 3.2em} 33div.lisp {margin-left: 3.2em} 34div.smalldisplay {margin-left: 3.2em} 35div.smallexample {margin-left: 3.2em} 36div.smallindentedblock {margin-left: 3.2em; font-size: smaller} 37div.smalllisp {margin-left: 3.2em} 38kbd {font-style:oblique} 39pre.display {font-family: inherit} 40pre.format {font-family: inherit} 41pre.menu-comment {font-family: serif} 42pre.menu-preformatted {font-family: serif} 43pre.smalldisplay {font-family: inherit; font-size: smaller} 44pre.smallexample {font-size: smaller} 45pre.smallformat {font-family: inherit; font-size: smaller} 46pre.smalllisp {font-size: smaller} 47span.nocodebreak {white-space:nowrap} 48span.nolinebreak {white-space:nowrap} 49span.roman {font-family:serif; font-weight:normal} 50span.sansserif {font-family:sans-serif; font-weight:normal} 51ul.no-bullet {list-style: none} 52--> 53</style> 54 55 56</head> 57 58<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> 59<a name="Prompting"></a> 60<div class="header"> 61<p> 62Next: <a href="Errors.html#Errors" accesskey="n" rel="next">Errors</a>, Previous: <a href="Displays.html#Displays" accesskey="p" rel="previous">Displays</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> 63</div> 64<hr> 65<a name="Annotation-for-GDB-Input"></a> 66<h2 class="chapter">8 Annotation for <small>GDB</small> Input</h2> 67 68<a name="index-annotations-for-prompts"></a> 69<p>When <small>GDB</small> prompts for input, it annotates this fact so it is possible 70to know when to send output, when the output from a given command is 71over, etc. 72</p> 73<p>Different kinds of input each have a different <em>input type</em>. Each 74input type has three annotations: a <code>pre-</code> annotation, which 75denotes the beginning of any prompt which is being output, a plain 76annotation, which denotes the end of the prompt, and then a <code>post-</code> 77annotation which denotes the end of any echo which may (or may not) be 78associated with the input. For example, the <code>prompt</code> input type 79features the following annotations: 80</p> 81<div class="smallexample"> 82<pre class="smallexample">^Z^Zpre-prompt 83^Z^Zprompt 84^Z^Zpost-prompt 85</pre></div> 86 87<p>The input types are 88</p> 89<dl compact="compact"> 90<dd><a name="index-pre_002dprompt"></a> 91<a name="index-prompt"></a> 92<a name="index-post_002dprompt"></a> 93</dd> 94<dt><code>prompt</code></dt> 95<dd><p>When <small>GDB</small> is prompting for a command (the main <small>GDB</small> prompt). 96</p> 97<a name="index-pre_002dcommands"></a> 98<a name="index-commands"></a> 99<a name="index-post_002dcommands"></a> 100</dd> 101<dt><code>commands</code></dt> 102<dd><p>When <small>GDB</small> prompts for a set of commands, like in the <code>commands</code> 103command. The annotations are repeated for each command which is input. 104</p> 105<a name="index-pre_002doverload_002dchoice"></a> 106<a name="index-overload_002dchoice"></a> 107<a name="index-post_002doverload_002dchoice"></a> 108</dd> 109<dt><code>overload-choice</code></dt> 110<dd><p>When <small>GDB</small> wants the user to select between various overloaded functions. 111</p> 112<a name="index-pre_002dquery"></a> 113<a name="index-query"></a> 114<a name="index-post_002dquery"></a> 115</dd> 116<dt><code>query</code></dt> 117<dd><p>When <small>GDB</small> wants the user to confirm a potentially dangerous operation. 118</p> 119<a name="index-pre_002dprompt_002dfor_002dcontinue"></a> 120<a name="index-prompt_002dfor_002dcontinue"></a> 121<a name="index-post_002dprompt_002dfor_002dcontinue"></a> 122</dd> 123<dt><code>prompt-for-continue</code></dt> 124<dd><p>When <small>GDB</small> is asking the user to press return to continue. Note: Don’t 125expect this to work well; instead use <code>set height 0</code> to disable 126prompting. This is because the counting of lines is buggy in the 127presence of annotations. 128</p></dd> 129</dl> 130 131 132 133 134</body> 135</html> 136