3.03;debug (debug), revision 3.03, 83/10/21
DEBUG -- Invoke the Language Level Debugger.
usage:  DEBUG [-WPn|-NWP] [-NC] [-SRC|-SRC_T|-SRC_R] [-SDIR pathname]
              [-R[EAD] pathname] target-pathname [parameters...]


FORMAT

  DEBUG [options] target-pathname [parameters...]

  The Language Level Debugger provides an easy way to debug high level
  language programs (Pascal, FORTRAN, C).  When you invoke DEBUG, it splits
  the current window into two sections, or "window panes".  The DEBUG session
  runs in the top pane, and your program runs in the bottom pane.  These
  window panes disappear when you terminate the DEBUG session.


ARGUMENTS

  target-pathname
  (required)       Specify the name of the file containing the program you
                   wish to debug.

  parameters
  (optional)       Specify any parameters that you wish to pass to the program
                   given by 'target-pathname'.  DEBUG options may not be given
                   here.  Default if omitted: no parameters passed.


OPTIONS

  Note that all DEBUG options MUST PRECEDE the pathname of the target program.

  -WPn             Specify size of DEBUG window pane from 10% to 90%.
                   'n' may equal 10, 20, 30, 40, 50, 60, 70, 80, or 90.
                   Default if omitted: DEBUG creates a window pane in the top
                                       50% of the window.

  -NWP             Do not create DEBUG window panes.  Instead, DEBUG will
                   perform input and output operations using the error input
                   and error output streams in your transcript pad.

  -NC              This option prevents DEBUG from copying the object file.
                   Instead, the actual file is mapped for writing and executed
                   directly.

  -SRC             These options cause DEBUG to display the source file(s) which
  -SRC_T           were used to make the target program being debugged.  The
  -SRC_R           -SRC option lets DEBUG choose where the source will be
                   displayed.  The -SRC_T options makes DEBUG put the source at
                   the top of the window; the -SRC_R options makes DEBUG put
                   the source on the right-hand side of the window.

  -SDIR pathname   This option provides alternative directory pathnames for
                   finding the source file(s), when one of the -SRC options
                   is used.  It may be given any number of times on the command
                   line.  (When the source was compiled, the full pathname was
                   remembered.  If DEBUG cannot find the source file using that
                   pathname, the source file name is extracted from the full
                   pathname and is appended to each SDIR pathname.  Then, DEBUG
                   tries each of these pathnames as well.)

  -R[EAD] pathname This option causes DEBUG to read the file specified by
                   "pathname" and process each line as a DEBUG command as DEBUG
                   is invoked.  It may be given only once on the command line.
                   (As a regular DEBUG command, it may be given more than once.)


DEBUG COMMANDS

  Once DEBUG is invoked, it recognizes the following commands:

  A[RGS]        - Display the arguments of an active routine.
  B[REAKPOINT]  - Set a breakpoint.
  DEF[INE]      - Create or change a substitution string.
  D[ELETE]      - Delete a breakpoint, macro, or substitution string.
  DES[CRIBE]    - Print information about a variable's definition.
  ENV[IRONMENT] - Display/change the assumed symbolic routine name.
  E[XAMINE]     - Examine a variable.
  EXI[T]        - Leave the debugger.
  G[O]          - Run the target program.
  H[ELP]        - Display brief information about the commands.
  IF            - Evaluate a conditional expression and do commands.
  J[UMP]        - Go to a labeled statement in an action list (command list).
  L[IST]        - List routines, breakpoints, macros, substitution strings
                  and debugger variables.
  M[ACRO]       - Create or change a macro.
  P[RINT]       - Print the value of one or more expressions.
  Q[UIT]        - Leave the debugger.
  R[EAD]        - Read a DEBUG command file.
  SDIR          - Provide alternate pathnames for source file display.
  S[ET]         - Set a variable to a new value.
  SH[ELL]       - Invoke a Shell under the debugger.
  STCODE        - Display information about a given status code.
  ST[EP]        - Step the target program one statement.
  TB            - Traceback the current user calls.

  Note: Certain options chosen in the compilation phase of program development
  (i.e.,-NDB/-DB/-DBS/-DBA) may influence your ability to access those programs
  via DEBUG.  See the "FORTRAN User's Guide", the "Pascal User's Guide", and the
  "Apollo C User's Guide" for details.


RELATED TOPICS

  More information is available.  Type:

    - HELP DEBUG command_name_abbreviation
      for description of a particular Debug command.  For example,
      $ HELP DEBUG DEF
      displays information about the DEBUG command, DEFINE.

    - To save your dialog with DEBUG, use the Display Manager's command "PN"
      to name the debugger's transcript pad anytime before you issue the
      debugger's quit command.  Type HELP PN for more information.