debug — Apollo

4.06;debug, revision 4.06, 85/06/03
DEBUG -- Invoke the Language Level Debugger.
usage:
DEBUG [-WPn|-NWP] [-NC] [-SRC|-SRC_T|-SRC_R] [-SDIR pathname]
      [-R[EAD] pathname] [-SMAP] [-SET arg_string]
      {-PROC process_name | target [args...]}


FORMAT

  DEBUG [options] {-PROC process_name | target [args...]}


  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 "windowpanes".  The DEBUG session runs in the top
  pane, and your program runs in the bottom pane.  These  windowpanes  disappear
  when you terminate the DEBUG session.

  NOTE: DEBUG  gives you two different ways to invoke the target.  If you choose
        to invoke DEBUG and specify a target name, all DEBUG options MUST appear
        before  the target name.  DEBUG looks for its own options until it finds
        the target pathname, and then stops looking.   (This  permits  a  target
        program  to  have  an  option  with  the same name as a DEBUG option, if
        necessary.)

        If, on  the  other  hand,  you  invoke  DEBUG  using  the  -PROC  switch
        (described  below),  NO  target name OR target options are allowed.  You
        invoke the target directly in the other process, just as  you  would  to
        run it without the debugger.


ARGUMENTS

  One of the following two arguments is required on the command line.

  target [args...]
  (optional)         Specify the pathname of the file containing the program you
                     wish to debug, plus any  arguments  that  the  program  may
                     require.

  -PROC process_name
  (optional)          Perform  explicit  cross-process  debugging.   This primes
                     DEBUG to watch for target invocation in an already-existing
                     process  (specified  by  'process_name').  After you invoke
                     DEBUG with this option, it will watch the given process for
                     the  invocation  of  a program.  When the invocation of the
Museum
