1  Overview
=TITLE Overview of the Debugger
   This is the help library for the dxdb graphic 
 debugger.  By choosing items from the dxdb's 
 main menu, you can create other windows to view 
 and manipulate the program you are debugging, 
 change what happens when command buttons are 
 activated, change the way data is presented, 
 and examine debugging symbols.

   For more information, consult the dxdb users
 book in the documentation package.

2  Popup Menus
=TITLE Popup Menus
   There are four popup menus on the main dxdb
 window that are activated by MB2 and <Shift>MB2.
 On the source window, MB2 activates the control
 menu which contains the buttons for Run, Step
 Skip, Continue, Stop and Return.  <Shift>MB2
 activates a menus that allows the user to examine
 the values of variables and set breakpoints in
 functions whose names appear on the screen.

   In the margin window, along side the source
 window, MB2 brings up a menus that allows the
 user to set and delete breakpoints.  <Shift>MB2
 activates a menu for setting and deleting
 tracepoints.

3  Control Popup Menu
=TITLE Control Popup Menu
   These are the most common dxdb command and
 are used to control flow of execution.  The
 commands available on the Control popup menu 
 are also available on the Control pulldown
 menu on the menubar.

   To use this menu, press the MB2 while 
 keeping the cursor over the source window.

4  Run
=TITLE Run
   The run button starts up the program that is 
 being debugged, and creates a terminal emulator
 for all the program's input and output.

4  Step
=TITLE Step
   The step button executes one program statement,
 and updates all relevant information currently
 being displayed.

4  Skip
=TITLE Skip
   The skip button executes one program statement,
 and if that statement is a procedure call, the
 entire procedure is executed.  All information
 currently being displayed is updated.

4  Continue
=TITLE Continue
   The continue button allows execution to proceed
 after stopping at a breakpoint or after stepping
 or skipping.  Execution will go until stopped by
 reaching a breakpoint or finishing execution.

4  Stop
=TITLE Stop
   The stop button halts execution of the program 
 being debugged.  Execution can be continued by
 using the continue, step, or skip button.

4  Return
=TITLE Return
   The return button will finish executing all the 
 statements in the current procedure and pause
 upon reaching the calling procedure.

3  Variable Popup Menu
=TITLE Variable Popup Menu
   This menu is mainly for examining the values of
 variables, either by printing their values to the
 text window, or placing them in the examine window
 where they will be updated.  The user can also set
 breakpoints or tracepoints in routines when their
 name is on the screen.
 
   To use this menu, press the MB2 while holding
 the Shift key down and keeping the cursor over
 the source window.
 
4  Print
=TITLE Print
   By clicking on a variable name and selecting
 the print option, the value of that variable will
 be printed in the text window.  The pull right
 menu allows the value to be printed in hex form.  
 The Print * button prints out the value of the 
 variable treated as a pointer.

4  Examine
=TITLE Examine
   By clicking on a variable name and selecting
 the Examine option, the variable will be added to
 the examine window.  The pull right menu allows 
 the value to be printed in hexadecimal form.  The 
 Examine * button prints out the value of the 
 variable treated as a pointer.

4  Delete Examine
=TITLE Delete Examine
   By clicking on a variable name and selecting
 the Delete option, the variable will be removed
 from the examine window.

4  Stop in Function (source window)
=TITLE Stop in Function (source window)
   By clicking on a function name and selecting
 the Stop in Function option, a breakpoint will
 be set in that function.

4  Trace in Function (source window)
=TITLE Trace in Function (source window)
   By clicking on a function name and selecting
 the Trace in Function option, a tracepoint will
 be set in that function.

   This option is not available on the DECstation
 3100.

3  Breakpoint Popup Menu
=TITLE Breakpoint Popup Menu
   This menu allows the user to set and delete
 breakpoints relative to what is currently on
 the screen or anywhere in the program.  When
 using the Set at Line or Set in Function options,
 the cursor position is used to determine where
 to place the breakpoint.

   Breakpoints are represented by filled circles
 in the margin window and as an entry in the
 Breakpoint window list box.

   To use this menu, press the MB2 while 
 keeping the cursor over the margin window.

4  Set at Line
=TITLE Set at Line
   A breakpoint is set where the user first
 pressed the mouse button.  The pull right menu
 allows the user to add a conditional statement
 to the breakpoint.

4  Set in Function
=TITLE Set in Function
   A breakpoint is set in the function where 
 the user first pressed the mouse button.  The 
 pull right menu allows the user to add a 
 conditional statement to the breakpoint.

4  Global Breakpoint
=TITLE Global Breakpoint
   This option sets a breakpoint which is not
 associated with any line of code.  They can
 be deleted only by selecting them in the
 Breakpoints window and hitting the Delete 
 button.

4  Random_Function
=TITLE Random Function
   The user selects this option to set a breakpoint
 in a function that is not currently displayed in 
 the source window.

4  Random_Line
=TITLE Random Line
   The user selects this option to set a breakpoint
 at a line that is not currently displayed in the
 source window.

4  Delete Breakpoint
=TITLE Delete Breakpoint
   To delete a breakpoint, move the cursor over a
 breakpoint symbol in the margin window, bring up
 this menu, and select the delete option.

3  Tracepoint Popup Menu
=TITLE Tracepoint Popup Menu
   This menu allows the user to set and delete
 tracepoints relative to what is currently on
 the screen.  When using the Trace at Line or 
 Trace in Function options, the cursor position 
 is used to determine where to place the tracepoint.

   Tracepoints are represented by empty circles
 in the margin window and as an entry in the
 Breakpoint window list box.

   To use this menu, press the MB2 while holding
 the Shift key down and keeping the cursor over
 the margin window.

4 Trace_Global 
=TITLE Trace Global
   This option sets a tracepoint which is not
 associated with any line of code.  They can
 be deleted only by selecting them in the
 Breakpoints window and hitting the Delete 
 button.

4  Trace_at_Line
=TITLE Trace at Line
   A tracepoint is set where the user first
 pressed the mouse button.  The pull right menu
 allows the user to add a conditional statement
 to the tracepoint.

4  Trace_in_Function
=TITLE Trace in Function
   A tracepoint is set in the function where 
 the user first pressed the mouse button.  The 
 pull right menu allows the user to add a 
 conditional statement to the tracepoint.

4  Delete_Tracepoint
=TITLE Delete Tracepoint
   To delete a tracepoint, move the cursor over a
 tracepoint symbol in the margin window, bring up
 this menu, and select the delete option.

2  File Pulldown Menu
=TITLE File Pulldown Menu
   This menu allows the user to modify the 
 execution of dxdb and change the program
 being debugged.

3  Open Files
=TITLE Open Files
   This action creates a file selection widget
 and places the file selected in the source
 window.

3  Make/Restart
=TITLE Make/Restart
   This action runs the command in the Make
 window restart command field and then restarts
 the debugger with the new executable.

3  Edit Files
=TITLE Edit Files
   Selecting this option brings up an editing
 session, running vi in a separate terminal
 emulator, of the current file with the cursor
 placed on the current line of execution.  

3  Quit
=TITLE Quit
   Leave the debugger and clean up all of the
 associated processes.

2  Control Pulldown Menu
=TITLE Control Pulldown Menu
   These are the most common dxdb command and
 are used to control flow of execution.  The
 commands available on the Control pulldown
 menu are also available on the Control popup
 menu in the source window.

3  Run
=TITLE Run
   The run button starts up the program that is 
 being debugged, and creates a terminal emulator
 for all the program's input and output.

3  Step
=TITLE Step
   The step button executes one program statement,
 and updates all relevant information currently
 being displayed.

3  Skip
=TITLE Skip
   The skip button executes one program statement,
 and if that statement is a procedure call, the
 entire procedure is executed.  All information
 currently being displayed is updated.

3  Continue
=TITLE Continue

   The continue button allows execution to proceed
 after stopping at a breakpoint or after stepping
 or skipping.  Execution will go until stopped by
 reaching a breakpoint or finishing execution.

3  Stop
=TITLE Stop
   The stop button halts execution of the program 
 being debugged.  Execution can be continued by
 using the continue, step, or skip button.

3  Return
=TITLE Return
   The return button will finish executing all the 
 statements in the current procedure and pause
 upon reaching the calling procedure.

2  Options Pulldown Menu
=TITLE Options Pulldown Menu
 This menu is used to bring up any of the windows used
 to change what happens when the command buttons are
 pressed.  The windows currently available are:
    * Run
    * Step
    * Skip

3  Run Option Window
=TITLE Run Option Window
 This window is used to pass arguments on the the
 program being debugged when the "Run" button is
 clicked.  Type any arguments into the "Run 
 Arguments:" field and click on the "Run with
 Arguments" radio button.  To run without any
 arguments, click on the "Run" radio button or 
 clear the "Run Arguments:" field.
 
3  Step Option Window
=TITLE Step Option Window
 Initially, clicking on the "Step" button cause the
 debugger to execute one step command.  This can be
 modified to any number of steps by changing the
 value in the number field with the "+" and "-"
 buttons and then setting the "Step Count" radio
 button.  To return to stepping only once set the
 "Step Once" radio button, or set the number field
 back to zero.

3  Skip Option Window
=TITLE Skip Option Window
 Initially, clicking on the "Skip" button cause the
 debugger to execute one skip command.  This can be
 modified to any number of skips by changing the
 value in the number field with the "+" and "-"
 buttons and then setting the "Skip Count" radio
 button.  To return to skipping only once set the
 "Skip Once" radio button, or set the number field
 back to zero.

2  Windows Pulldown Menu
=TITLE Windows Pulldown Menu
   This menu is used to bring up any of the windows 
 used to examine and manipulate data from the 
 debugging session.  The windows currently 
 available are:
    * Assign
    * Breakpoints
    * Examine
    * Dump
    * Stack
    * Make

3  Assign Values to Variables
=TITLE Assign Values to Variables
   To change the value of a variable in the program 
 being debugged, type the name of the variable in 
 the "Variable:" field and the value in the field 
 labeled "Value:".  When you are finished, click on 
 the Assign button and the operation will take place. 
 If the Assign button is shaded grey, it means that 
 the program being debugged is not active and that 
 assignments cannot take place at the present time.

3  Displaying and Deleting Breakpoints
=TITLE Displaying and Deleting Breakpoints
 To delete breakpoints, click on the corresponding 
 line in the breakpoint window list box and then 
 click on the button labeled "Delete".  The 
 breakpoint command buttons will be shaded grey if
 the program being debugged is not active.

3  Examining Variables
=TITLE Examining Variables
 To see the value of a variable, select the name of the
 variable from any window or type it in to the field
 labeled "Examine :" and hit the button labeled "Add".
 To delete a variable from the window, select the 
 variable name or type it in to the "Examine :" field 
 and click on the button labeled "Delete".

3  Dump Variables
=TITLE Dump Variables
 This window is maintained to keeps track of all 
 variables declared locally and of the parameters 
 passed in with the procedure call.
 
3  Stack Trace
=TITLE Stack Trace
 This window is maintained to keeps track of all stack
 traces generated when there is a pause in execution.

3  Make
=TITLE Make
 This window displays the output from the command
 executed during the restart procedure.  The
 Restart Command field is executed after the Restart
 button in the File pull down menu is pressed.  The
 default command is "make".
 
2  Functions Pulldown Menu
=TITLE Functions Pulldown Menu
 The entries in this menu are for finding out
 information about debugging symbols.  Select the 
 symbol name and click on one of the menu entries.
 The information will be printed out in the main
 window text field.

3  Whatis
=TITLE Whatis
 Prints the declaration of the given name.

3  Which
=TITLE Which
 Prints the full qualification of the given
 identifier, i.e. the outer blocks that the 
 identifier is associated with.

3  Whereis
=TITLE Whereis
 Prints the full qualifiaction of all the symbols
 whose name matches the given identifier.  The order
 in which the symbols are printed is not meaningful.

