EDGE(1)                                                   EDGE(1)



     NAME
          edge - window based debugger

     SYNOPSIS
          edge [  -r  ] [  -i  ] [  -I dir  ] [  -c file  ]
          [ objfile ]

     DESCRIPTION
          Edge is a window-based interface to dbx(1).  Objfile is an
          object file that you create by using the -g flag when you
          compile your fortran or C source code.  When you start edge,
          it creates three windows: the dbx(1) command window, the
          source window, and the user input/output window.  The dbx
          window contains the dbx(1) prompt. You can use the typical
          dbx(1) commands here. This window also contains buttons for
          sending commands to dbx(1).  The user window,
          stdin/stdout/stderr, acts as the user program's input and
          output window.  The source window contains the user
          program's source code.  You can resize, reshape and move
          these windows by pressing and holding the right mouse button
          in the title bar. This produces the mex(1) menu.  See below
          for more information on windows.

          Arguments to edge are the same as those to dbx(1).

     The Dbx Window
          See dbx(1) for the line interface in this window. You use
          the buttons in this window by moving the cursor over the
          item you want to select, then pressing the left mouse
          button. The buttons invoke these commands:

          rerun
               Sends the rerun command to dbx(1).  Edge uses arguments
               you specified for the last run command to rerun your
               program.

          stop Sets a breakpoint at the currently selected line in the
               source window. Selecting text in the source window is
               discussed below.

          step Single steps one source line.

          next Single steps one source line, but skips over function
               and subroutine calls.

          cont Continues execution.

          print
               Prints the value of the variable selected in the source
               window.

          where



     Page 1                                        (last mod. 8/20/87)

     EDGE(1)                                                   EDGE(1)



               Prints a stack trace from the current point of
               execution.

          trace
               Traces execution of all source lines.  The currently
               executing line is highlighted in green in the source
               window.

          interrupt
               Sends an interrupt to dbx(1).

          sh   Forks a shell in a wsh(1) window.

          quit Exits from edge.

          When you press the the right mouse button over any edge
          window, you see a menu with the following choices:

          attach
               Attaches input focus to the window.

          select
               Pops and attaches to the window.

          edit Lets you edit a source file. This choice contains a
               sub-menu that lists the source files that make up your
               program. Slide the cursor to the right to see the sub-
               menu, then select the file you want to edit. This
               invokes the editor specified by the $EDIT environment
               variable on the selected file.

          file Lets you read another source file into the source
               window. This choice contains a sub-menu that lists the
               source files that make up your program. Select the file
               you want displayed in the source window.

     The Source Window
          The source window displays your source. The currently
          executing line is highlighted in green. Breakpoints are
          highlighted in red.  Selected text is highlighted in yellow.
          Select text by pressing and holding the left mouse button,
          dragging the cursor over the text to be selected, then
          releasing the mouse button. When you use the file or /
          commands in the dbx(1) window, the results  will be
          reflected in the source window.  The title bar of this
          window contains the name of the file being displayed.

     The User window.
          This window acts as the user program's stdin/stdout/stderr.

     Edgerc syntax.
          If the file .edgerc exists in the current directory, edge



     Page 2                                        (last mod. 8/20/87)

     EDGE(1)                                                   EDGE(1)



          reads it. The syntax for commands in the .edgerc file
          follow:

          size window [rows] [columns]
               window specifies either the dbx, source, or user
               window.  Rows specifies the number of rows the window
               should occupy, and columns specifies the number of
               columns the window should occupy.  If you do not
               specify rows and columns, you will be prompted to size
               and place your windows.

          origin window [xcoord] [ycoord]
               This command causes the specified window's origin to be
               at xcoord, ycoord.  If you do not specify xcoord and
               ycoord, you will be prompted to place your own windows.

          color text background
               Text and background are integers that specify the color
               indices to be used for text and background.

     FILES
          a.out               object file
          .edgerc             initialization commands

     SEE ALSO
          cc(1), f77(1), dbx(1)
          ``Getting Started with edge for C''
          ``Getting Started with edge for FORTRAN''

     AUTHOR
          Jim Terhorst

     BUGS
          Edge uses the color indices 0-7. If you modify these, you
          modify edge's colors.

     ORIGIN
          Silicon Graphics, Inc.

















     Page 3                                        (last mod. 8/20/87)