mingw/info/gdb/Source-Annotations.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="Source%20Annotations">Source Annotations</a>,
  13 Next:<a rel="next" accesskey="n" href="TODO.html#TODO">TODO</a>,
  14 Previous:<a rel="previous" accesskey="p" href="Annotations-for-Running.html#Annotations%20for%20Running">Annotations for Running</a>,
  15 Up:<a rel="up" accesskey="u" href="Annotations.html#Annotations">Annotations</a>
  16 <hr><br>
  17 </div>
  18
  19 <h3 class="section">Displaying Source</h3>
  20
  21    <p>The following annotation is used instead of displaying source code:
  22
  23 <pre class="smallexample">     ^Z^Zsource <var>filename</var>:<var>line</var>:<var>character</var>:<var>middle</var>:<var>addr</var>
  24      </pre>
  25
  26    <p>where <var>filename</var> is an absolute file name indicating which source
  27 file, <var>line</var> is the line number within that file (where 1 is the
  28 first line in the file), <var>character</var> is the character position
  29 within the file (where 0 is the first character in the file) (for most
  30 debug formats this will necessarily point to the beginning of a line),
  31 <var>middle</var> is <code>middle</code> if <var>addr</var> is in the middle of the
  32 line, or <code>beg</code> if <var>addr</var> is at the beginning of the line, and
  33 <var>addr</var> is the address in the target program associated with the
  34 source which is being displayed.  <var>addr</var> is in the form <code>0x</code>
  35 followed by one or more lowercase hex digits (note that this does not
  36 depend on the language).
  37
  38    </body></html>
  39