gdb/gdbtk/library/help/stack.html

   1 <HTML>
   2   <HEAD>
   3     <TITLE>Stack Window Help</TITLE>
   4   </HEAD>
   5   <BODY>
   6
   7     <CENTER>
   8       <H2>The Stack Window</H2>
   9     </CENTER>
  10
  11
  12     <BR>The Stack Window allows users to view the call stack and jump between
  13     levels of the stack.
  14
  15     <UL>
  16       <LI><A HREF="#display">Stack Display</A></LI>
  17       <LI><A HREF="#display_nav">Navigating the Stack Window</A></LI>
  18       <LI><A HREF="#display_lvl">Changing the Stack Level</A></LI>
  19     </UL>
  20
  21     <H2><A NAME="display">Stack Display</A></H2>
  22     The Stack Display consists of a listbox which displays levels of the call stack
  23     on per line. Each line contains the level number (useful when using the
  24     <A HREF="console.html">Console Window</A>) and a description of the function executing
  25     in that level. Typically, the function name and either the address of the function
  26     or the file and line number where the function is defined are displayed. The
  27     Stack Window may also be used to jump between levels of the stack.
  28     <BR>
  29
  30     <H2><A NAME="display_nav">Navigating the Stack Window</A></H2>
  31     Navigation of the Stack Window is accomplished by clicking on the desired level
  32     with the left mouse button. The <A HREF="source.html#display">Source Window
  33       Display</A> updates to show the selected frame. All other secondary windows,
  34     <A HREF="register.html">Registers</A>, <A HREF="watch.html">Watch</A>, and
  35     <A HREF="locals.html">Locals</A> update their displays for the selected frame.
  36     <BR>
  37
  38     <H2><A NAME="display_lvl">Changing Stack Levels</A></H2>
  39     To switch frames, simply click the left mouse button on the desired frame and the
  40     debugger will switch contexts, updating all windows. The selected frame is highlighted
  41     (in gold, by default).
  42
  43     <P>As an alternative, changing stack levels may be accomplished via the
  44       <A HREF="source.html#toolbar_frame">Frame Control Buttons</A> on the Source Window's
  45       Toolbar. These buttons may be used to change frames one level at a time (either
  46       immediately up or immediately down) or to jump to the bottom-most stack frame.
  47       See <A HREF="source.html#toolbar_frame">Source Frame Control Buttons</A> for more
  48       information.</P>
  49   </BODY>
  50 </HTML>