gdb/gdbtk/library/help/locals.html

   1 <HTML>
   2 <HEAD>
   3 <TITLE>Local Variables Help</TITLE>
   4 </HEAD>
   5 <BODY>
   6 <H1>The Local Variables Window</H1>
   7 <H2>Overview</H2>
   8 <p>The Local Variables Window displays all local variables in scope. It may be used to
   9 visualize and edit local variables. To open the Local Variables window, click on
  10 small house icon on the toolbar, or select "Local Variables" under the View
  11 pulldown menu.</p>
  12
  13 <H3>Locals Display</H3>
  14
  15 <p>Pointers, structures, and classes appear in the display with small expansion
  16 box before their names. To dereference pointers or
  17 view the members of classes or structures, click
  18 the closed expansion box (which appears as a small plus sign, "+") to "expand"
  19 the listing. The expansion box changes to a minus sign, "-", indicating that the
  20 display is now open. Pointers, structures and classes may be expanded recursively
  21 to allow multiple pointer dereferences and embedded structure viewing.</p>
  22
  23 <P>The Locals Display updates after every execution of the program and highlights
  24 in green those variables whose values have changed.</P>
  25
  26 <P>The Locals Window will, by default, display all pointers in hexadecimal and all
  27 other variables in decimal. To change the display format for a variable, select
  28 the Format option from the popup-menu.</P>
  29
  30 <H3>Editing a Variable</H3>
  31 <p>To edit a variable, either double-click the left mouse button on the value of the variable in
  32 the display or select the Edit option from the pop-up menu. To abort editing a variable's value,
  33 simply press the escape key on the keyboard. The variable's original value is restored.</p>
  34
  35 <H3>Local Variable Pop-up Menu</H3>
  36 <p>The pop-up menu provides quick access to the functions of the Local Variables Window.
  37 To use the pop-up menu, click the right mouse button while over a variable.</p>
  38 <DL>
  39     <dt>Format<dd>Change the display format of the variable.</dd></dt>
  40     <dt>Edit<dd>Edit the variable's value.</dd></dt>
  41     <dt>Delete<dd>Remove the variable from the display.</dd></dt>
  42     <dt>Dump Memory<dd>Open a Memory Window with the variable's value as an aaddress.</dd></dt>
  43     <dt>Help<dd>Open this help page.</dd></dt>
  44     <dt>Close<dd>Close the Local Variables Window.</dd></dt>
  45 </DL>
  46 </BODY>
  47 </HTML>