diff options
Diffstat (limited to 'gdb/gdbtk/library/help/watch.html')
| -rw-r--r-- | gdb/gdbtk/library/help/watch.html | 86 |
1 files changed, 0 insertions, 86 deletions
diff --git a/gdb/gdbtk/library/help/watch.html b/gdb/gdbtk/library/help/watch.html deleted file mode 100644 index 01e253b1883..00000000000 --- a/gdb/gdbtk/library/help/watch.html +++ /dev/null @@ -1,86 +0,0 @@ -<HTML> -<HEAD> -<TITLE>Watch Window Help</TITLE> -</HEAD> -<BODY> -<H1>The Watch Window</H1> -<img src="images/watch.png" alt="Watch Window Image" width=545 height=308 border=0> -<H2>Overview</H2> - -<P>The Watch Window may be used to inspect and edit any expression, including -global variables, static variables, local variables, function arguments, -and registers. All expressions in scope are displayed with the expression in -blue, the expression type in red, and the expression value in black. When an -expression value changes, it is displayed in green. Expressions that are not -in scope are all gray.</P> - - -<H3>Adding Watch Expressions</H3> -<p>To add an expression to the Watch Window, 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> - -<P>To add an expression to the Watch Window from the -<A HREF="source.html">Source Window</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>To cast pointers, 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>Watch Display</H3> -<p>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> - -<P>Pointers, structures, and classes appear in the display with a small -exapansion box before their names. To dereference -pointers or view the members of classes or -structures, 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 -derefernces and embedded structure viewing.</P> - -<P>The Watch Display updates after every execution of the program and -highlights in green those expressions whose values have changed.</P> - -<P>The Watch Window will, by default, display all pointers and registers in -hexadecimal and all other expressions in decimal. To change the display -format for an expression, select the Format option from the pop-up menu.</P> - -<H3>Editing an Expression</H3> -<p>To edit an expression, either double-click the left mouse button on the expression -in the Display or select the Edit option from the popup-menu. To abort editing -an expression's value, simply press -the escape key on the keyboard. The expression's original value is restored.</p> - -<H3>Watch Pop-up Menu</H3> -<p>The pop-up menu provides quick access to the functions of the Watch Window. -To use the pop-up menu, click the right mouse button while over a variable.</p> -<DL> - <dt>Format<dd>Change the display format of the variable.</dd></dt> - <dt>Edit<dd>Edit the variable's value.</dd></dt> - <dt>Delete<dd>Remove the variable from the display.</dd></dt> - <dt>Dump Memory<dd>Open a Memory Window with the variable's value as an aaddress.</dd></dt> - <dt>Help<dd>Open this help page.</dd></dt> - <dt>Close<dd>Close the Local Variables Window.</dd></dt> -</DL> -</BODY> -</HTML> |