119 lines
5.2 KiB
HTML
119 lines
5.2 KiB
HTML
|
<HTML>
|
||
|
|
<HEAD>
|
||
|
|
<TITLE>Watch Window Help</TITLE>
|
||
|
|
</HEAD>
|
||
|
|
<BODY>
|
||
|
|
<H1>The Watch Window</H1>
|
||
|
|
<H3>Overview</H3>
|
||
|
|
<P>The Watch Window may be used to inspect any collected expression, including
|
||
|
|
global variables, static variables, local variables, function arguments,
|
||
|
|
and registers.</P>
|
||
|
|
|
||
|
|
<P>Watch Window topics:
|
||
|
|
<UL>
|
||
|
|
<LI><UL><A HREF="#menus">Watch Menu</A>
|
||
|
|
<LI><A HREF="#menus_fmt">Format</A>
|
||
|
|
<LI><A HREF="#menus_remove">Remove</A>
|
||
|
|
</UL>
|
||
|
|
<LI><UL><A HREF="#new">Adding Watch Expressions</A>
|
||
|
|
<LI><A HREF="#new_ent">In the Watch Window</A>
|
||
|
|
<LI><A HREF="#new_src">In the Source Window</A>
|
||
|
|
<LI><A HREF="#new_cast">Casting Pointers</A>
|
||
|
|
</UL>
|
||
|
|
<LI><UL><A HREF="#display">Watch Display</A>
|
||
|
|
<LI><A HREF="#display_deref">Dereferencing Pointers</A>
|
||
|
|
<LI><A HREF="#display_struct">Viewing a Structure or Class</A>
|
||
|
|
<LI><A HREF="#display_popup">Watch Pop-up Menu</A>
|
||
|
|
</UL>
|
||
|
|
</UL></P>
|
||
|
|
|
||
|
|
<H3><A NAME="menus">Watch Menu</A></H3>
|
||
|
|
The Watch Menu gives on-screen access to the funtions of the Watch Window.
|
||
|
|
To use any of these functions, first use the left mouse button to select an
|
||
|
|
expression from the display. Then select:
|
||
|
|
|
||
|
|
<DL>
|
||
|
|
<DT><A NAME="menus_fmt">Format</A>
|
||
|
|
<DD>Change the display format of the expression
|
||
|
|
<DT><A NAME="menus_remove">Remove</A>
|
||
|
|
<DD>Remove the expression from the Watch Window
|
||
|
|
</DL>
|
||
|
|
|
||
|
|
<H3><A NAME="new">Adding Watch Expressions</A></H3>
|
||
|
|
<A NAME="new_ent">To add an expression to the Watch Window</A>, simply enter
|
||
|
|
the expression into the entry at the bottom of the window and press return
|
||
|
|
or click the "Add Watch" button. The expression is validated and added to the
|
||
|
|
Watch Window Display.
|
||
|
|
|
||
|
|
<P><A NAME="new_src">To add an expression to the Watch Window from the
|
||
|
|
<A HREF="source.html">Source Window</A></A>, use the
|
||
|
|
"<A HREF="source.html#add_to_watch">Add to Watch</A>" option of the
|
||
|
|
<A HREF="source.html#display_popup">Source Window Pop-up Menu</A>.</P>
|
||
|
|
|
||
|
|
<P>Any legal expression may be added to the Watch Window, which will
|
||
|
|
evaluate each of its expressions everytime the program runs. Be cautious
|
||
|
|
adding expressions which cause assignments, such as "<CODE>i++</CODE>".</P>
|
||
|
|
|
||
|
|
<P>Adding a register to the Watch Window can be advantages when debugging
|
||
|
|
via a slow serial line. In this case, keeping the entire Register Window open
|
||
|
|
may be inefficient. Consider adding the register to the Watch Window. Simply
|
||
|
|
enter the name of the register preceded with a dollar sign ($) into the
|
||
|
|
Entry. For example, to watch the PC register, enter "<CODE>$pc</CODE>" into
|
||
|
|
the Watch Window Entry. The program counter is added to the Display.</P>
|
||
|
|
|
||
|
|
<P><A NAME="new_cast">To cast pointers</A>, simply enter the cast into the
|
||
|
|
Watch Window Entry at the bottom of the window. Use the same syntax for the
|
||
|
|
cast that the source file uses. If the source file uses C, the a simple
|
||
|
|
cast of "<CODE>ptr</CODE>" of type "<CODE>void *</CODE>" can be cast to type
|
||
|
|
"<CODE>my_struct</CODE>" by entering "<CODE>(my_struct *) ptr</CODE>" into
|
||
|
|
the Entry.</P>
|
||
|
|
|
||
|
|
<H3><A NAME="display">Watch Display</A></H3>
|
||
|
|
The Watch Window Display consists of a scrolled listbox which contains all
|
||
|
|
watch expressions, one per line. To use any of the functions of the Watch
|
||
|
|
Window, use the left mouse button to select any element from the Display.
|
||
|
|
|
||
|
|
<P>Pointers, structures, and classes appear in the display with a small
|
||
|
|
exapansion box before their names. To <A NAME="display_deref">dereference
|
||
|
|
pointers</A> or <A NAME="display_struct">view the members of classes or
|
||
|
|
structures</A>, click the closed expansion box (which appears as a small
|
||
|
|
plus sign, "+") to "expand" the listing. The expansion box changes to a
|
||
|
|
minus sign, "-", indicating that the display is now open. Pointers,
|
||
|
|
structures and classes may be expanded recursively to allow multiple pointer
|
||
|
|
dereferences and embedded structure viewing.
|
||
|
|
|
||
|
|
<P>The Locals Display updates as the trace buffer is navigated, highlighting
|
||
|
|
in blue those variables whose values have changed.</P>
|
||
|
|
|
||
|
|
<P>The Watch Window will, by default, display all pointers in hexadecimal and all
|
||
|
|
other variables in decimal. To change the default display of variables, use the
|
||
|
|
"set output-radix" command in the console window. (Type "help set output-radix" in the
|
||
|
|
console window for help. To make this change permanent, it must be added to the user's
|
||
|
|
init file -- .gdbinit.) To change the display
|
||
|
|
format for a variable, select the Format option from either the Variable Menu or the
|
||
|
|
<A HREF="#display_popup">Watch Pop-up Menu</A>.
|
||
|
|
<BR>
|
||
|
|
|
||
|
|
<H4><A NAME="display_popup">Watch Pop-up Menu</A></H4>
|
||
|
|
The Watch Pop-up Menu provides quick access to the functions of the Watch Window.
|
||
|
|
To use the Locals Pop-up Menu, first select an expression from the Display (by
|
||
|
|
clicking the left mouse button on it) and click the right mouse button, choosing
|
||
|
|
from the pop-up:
|
||
|
|
<DL>
|
||
|
|
<DT>Format
|
||
|
|
<DD>Change the display format of the expression. The expression may be
|
||
|
|
displayed as:
|
||
|
|
<DL>
|
||
|
|
<DT>Hex
|
||
|
|
<DD>hexadecimal (base 16)
|
||
|
|
<DT>Decimal
|
||
|
|
<DD>decimal (base 10)
|
||
|
|
<DT>Binary
|
||
|
|
<DD>binary (base 2)
|
||
|
|
<DT>Octal
|
||
|
|
<DD>octal (base 8)
|
||
|
|
</DL>
|
||
|
|
</DL>
|
||
|
|
</BODY>
|
||
|
|
</HTML>
|