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: Top</title> 14 15<meta name="description" content="GDB’s Obsolete Annotations: Top"> 16<meta name="keywords" content="GDB’s Obsolete Annotations: Top"> 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="#Top" rel="start" title="Top"> 22<link href="#SEC_Contents" rel="contents" title="Table of Contents"> 23<link href="../dir/index.html" rel="up" title="(dir)"> 24<link href="Annotations-Overview.html#Annotations-Overview" rel="next" title="Annotations Overview"> 25<style type="text/css"> 26<!-- 27a.summary-letter {text-decoration: none} 28blockquote.smallquotation {font-size: smaller} 29div.display {margin-left: 3.2em} 30div.example {margin-left: 3.2em} 31div.indentedblock {margin-left: 3.2em} 32div.lisp {margin-left: 3.2em} 33div.smalldisplay {margin-left: 3.2em} 34div.smallexample {margin-left: 3.2em} 35div.smallindentedblock {margin-left: 3.2em; font-size: smaller} 36div.smalllisp {margin-left: 3.2em} 37kbd {font-style:oblique} 38pre.display {font-family: inherit} 39pre.format {font-family: inherit} 40pre.menu-comment {font-family: serif} 41pre.menu-preformatted {font-family: serif} 42pre.smalldisplay {font-family: inherit; font-size: smaller} 43pre.smallexample {font-size: smaller} 44pre.smallformat {font-family: inherit; font-size: smaller} 45pre.smalllisp {font-size: smaller} 46span.nocodebreak {white-space:nowrap} 47span.nolinebreak {white-space:nowrap} 48span.roman {font-family:serif; font-weight:normal} 49span.sansserif {font-family:sans-serif; font-weight:normal} 50ul.no-bullet {list-style: none} 51--> 52</style> 53 54 55</head> 56 57<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> 58<h1 class="settitle" align="center"><small>GDB</small>’s Obsolete Annotations</h1> 59 60 61 62 63 64 65<p>This file documents <small>GDB</small>’s obsolete annotations. 66</p> 67<p>Copyright © 1994–2021 Free Software Foundation, Inc. 68</p> 69<p>Permission is granted to copy, distribute and/or modify this document 70under the terms of the GNU Free Documentation License, Version 1.3 or 71any later version published by the Free Software Foundation; with no 72Invariant Sections, with no Front-Cover Texts, and with no Back-Cover 73Texts. A copy of the license is included in the section entitled “GNU 74Free Documentation License”. 75</p> 76 77 78<a name="Top"></a> 79<div class="header"> 80<p> 81Next: <a href="Annotations-Overview.html#Annotations-Overview" accesskey="n" rel="next">Annotations Overview</a>, Up: <a href="../dir/index.html" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> 82</div> 83<hr> 84<a name="GDB-Annotations"></a> 85<h1 class="top">GDB Annotations</h1> 86 87<p>This document describes the obsolete level two annotation interface 88implemented in older <small>GDB</small> versions. 89</p> 90 91<table class="menu" border="0" cellspacing="0"> 92<tr><td align="left" valign="top">• <a href="Annotations-Overview.html#Annotations-Overview" accesskey="1">Annotations Overview</a>:</td><td> </td><td align="left" valign="top">What annotations are; the general syntax. 93</td></tr> 94<tr><td align="left" valign="top">• <a href="Limitations.html#Limitations" accesskey="2">Limitations</a>:</td><td> </td><td align="left" valign="top">Limitations of the annotation interface. 95</td></tr> 96<tr><td align="left" valign="top">• <a href="Migrating-to-GDB_002fMI.html#Migrating-to-GDB_002fMI" accesskey="3">Migrating to GDB/MI</a>:</td><td> </td><td align="left" valign="top">Migrating to GDB/MI 97</td></tr> 98<tr><td align="left" valign="top">• <a href="Server-Prefix.html#Server-Prefix" accesskey="4">Server Prefix</a>:</td><td> </td><td align="left" valign="top">Issuing a command without affecting user state. 99</td></tr> 100<tr><td align="left" valign="top">• <a href="Value-Annotations.html#Value-Annotations" accesskey="5">Value Annotations</a>:</td><td> </td><td align="left" valign="top">Values are marked as such. 101</td></tr> 102<tr><td align="left" valign="top">• <a href="Frame-Annotations.html#Frame-Annotations" accesskey="6">Frame Annotations</a>:</td><td> </td><td align="left" valign="top">Stack frames are annotated. 103</td></tr> 104<tr><td align="left" valign="top">• <a href="Displays.html#Displays" accesskey="7">Displays</a>:</td><td> </td><td align="left" valign="top"><small>GDB</small> can be told to display something periodically. 105</td></tr> 106<tr><td align="left" valign="top">• <a href="Prompting.html#Prompting" accesskey="8">Prompting</a>:</td><td> </td><td align="left" valign="top">Annotations marking <small>GDB</small>’s need for input. 107</td></tr> 108<tr><td align="left" valign="top">• <a href="Errors.html#Errors" accesskey="9">Errors</a>:</td><td> </td><td align="left" valign="top">Annotations for error messages. 109</td></tr> 110<tr><td align="left" valign="top">• <a href="Breakpoint-Info.html#Breakpoint-Info">Breakpoint Info</a>:</td><td> </td><td align="left" valign="top">Information on breakpoints. 111</td></tr> 112<tr><td align="left" valign="top">• <a href="Invalidation.html#Invalidation">Invalidation</a>:</td><td> </td><td align="left" valign="top">Some annotations describe things now invalid. 113</td></tr> 114<tr><td align="left" valign="top">• <a href="Annotations-for-Running.html#Annotations-for-Running">Annotations for Running</a>:</td><td> </td><td align="left" valign="top"> 115 Whether the program is running, how it stopped, etc. 116</td></tr> 117<tr><td align="left" valign="top">• <a href="Source-Annotations.html#Source-Annotations">Source Annotations</a>:</td><td> </td><td align="left" valign="top">Annotations describing source code. 118</td></tr> 119<tr><td align="left" valign="top">• <a href="Multi_002dthreaded-Apps.html#Multi_002dthreaded-Apps">Multi-threaded Apps</a>:</td><td> </td><td align="left" valign="top">An annotation that reports multi-threadedness. 120</td></tr> 121<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> 122</pre></th></tr><tr><td align="left" valign="top">• <a href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License">GNU Free Documentation License</a>:</td><td> </td><td align="left" valign="top"> 123</td></tr> 124</table> 125 126<a name="SEC_Contents"></a> 127<h2 class="contents-heading">Table of Contents</h2> 128 129<div class="contents"> 130 131<ul class="no-bullet"> 132 <li><a name="toc-What-is-an-Annotation_003f" href="Annotations-Overview.html#Annotations-Overview">1 What is an Annotation?</a></li> 133 <li><a name="toc-Limitations-of-the-Annotation-Interface" href="Limitations.html#Limitations">2 Limitations of the Annotation Interface</a> 134 <ul class="no-bullet"> 135 <li><a name="toc-Dependant-on-CLI-output" href="Limitations.html#Dependant-on-CLI-output">2.1 Dependant on <small>CLI</small> output</a></li> 136 <li><a name="toc-Scalability" href="Limitations.html#Scalability">2.2 Scalability</a></li> 137 <li><a name="toc-Correctness" href="Limitations.html#Correctness">2.3 Correctness</a></li> 138 <li><a name="toc-Reliability" href="Limitations.html#Reliability">2.4 Reliability</a></li> 139 <li><a name="toc-Maintainability" href="Limitations.html#Maintainability">2.5 Maintainability</a></li> 140 </ul></li> 141 <li><a name="toc-Migrating-to-GDB_002fMI-1" href="Migrating-to-GDB_002fMI.html#Migrating-to-GDB_002fMI">3 Migrating to <small>GDB/MI</small></a></li> 142 <li><a name="toc-The-Server-Prefix" href="Server-Prefix.html#Server-Prefix">4 The Server Prefix</a></li> 143 <li><a name="toc-Values" href="Value-Annotations.html#Value-Annotations">5 Values</a></li> 144 <li><a name="toc-Frames" href="Frame-Annotations.html#Frame-Annotations">6 Frames</a></li> 145 <li><a name="toc-Displays-1" href="Displays.html#Displays">7 Displays</a></li> 146 <li><a name="toc-Annotation-for-GDB-Input" href="Prompting.html#Prompting">8 Annotation for <small>GDB</small> Input</a></li> 147 <li><a name="toc-Errors-1" href="Errors.html#Errors">9 Errors</a></li> 148 <li><a name="toc-Information-on-Breakpoints" href="Breakpoint-Info.html#Breakpoint-Info">10 Information on Breakpoints</a></li> 149 <li><a name="toc-Invalidation-Notices" href="Invalidation.html#Invalidation">11 Invalidation Notices</a></li> 150 <li><a name="toc-Running-the-Program" href="Annotations-for-Running.html#Annotations-for-Running">12 Running the Program</a></li> 151 <li><a name="toc-Displaying-Source" href="Source-Annotations.html#Source-Annotations">13 Displaying Source</a></li> 152 <li><a name="toc-Multi_002dthreaded-Applications" href="Multi_002dthreaded-Apps.html#Multi_002dthreaded-Apps">14 Multi-threaded Applications</a></li> 153 <li><a name="toc-GNU-Free-Documentation-License-1" href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License">Appendix A GNU Free Documentation License</a></li> 154</ul> 155</div> 156 157 158<hr> 159<div class="header"> 160<p> 161Next: <a href="Annotations-Overview.html#Annotations-Overview" accesskey="n" rel="next">Annotations Overview</a>, Up: <a href="../dir/index.html" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> 162</div> 163 164 165 166</body> 167</html> 168