DBG$HELP.HLB  —  DEBUG  EDIT
    Starts the editor established with the SET EDITOR command. If you
    did not enter a SET EDITOR command, starts the Language-Sensitive
    Editor (LSE), if that editor is installed on your system.

    Format

      EDIT  [[module-name\] line-number]

1  –  Parameters

 module-name

    Specifies the name of the module whose source file is to be
    edited. If you specify a module name, you must also specify a
    line number. If you omit the module name parameter, the source
    file whose code appears in the current source display is chosen
    for editing.

 line-number

    A positive integer that specifies the source line on which the
    editor's cursor is initially placed. If you omit this parameter,
    the cursor is initially positioned at the beginning of the source
    line that is centered in the debugger's current source display,
    or at the beginning of line 1 if the editor was set to /NOSTART_
    POSITION (see the SET EDITOR command.)

2  –  Qualifiers

2.1    /EXIT

       /EXIT
       /NOEXIT (default)

    Controls whether you end the debugging session prior to starting
    the editor. If you specify /EXIT, the debugging session is
    terminated and the editor is then started. If you specify
    /NOEXIT, the editing session is started and you return to your
    debugging session after terminating the editing session.

3  –  Description

    If you have not specified an editor with the SET EDITOR command,
    the EDIT command starts the Language-Sensitive Editor (LSE) in
    a spawned subprocess (if LSE is installed on your system). The
    typical (default) way to use the EDIT command is not to specify
    any parameters. In this case, the editing cursor is initially
    positioned at the beginning of the line that is centered in the
    currently selected debugger source display (the current source
    display).

    The SET EDITOR command provides options for starting different
    editors, either in a subprocess or through a callable interface.

    Related commands:

       (SET,SHOW) EDITOR
       (SET,SHOW,CANCEL) SOURCE

4  –  Examples

    1.DBG> EDIT

      This command spawns the Language-Sensitive Editor (LSE) in a
      subprocess to edit the source file whose code appears in the
      current source display. The editing cursor is positioned at the
      beginning of the line that was centered in the source display.

    2.DBG> EDIT SWAP\12

      This command spawns the Language-Sensitive Editor (LSE) in a
      subprocess to edit the source file containing the module SWAP.
      The editing cursor is positioned at the beginning of source
      line 12.

    3.DBG> SET EDITOR/CALLABLE_EDT
      DBG> EDIT

      In this example, the SET EDITOR/CALLABLE_EDT command
      establishes that EDT is the default editor and is started
      through its callable interface (rather than spawned in a
      subprocess). The EDIT command starts EDT to edit the source
      file whose code appears in the current source display. The
      editing cursor is positioned at the beginning of source line 1,
      because the default qualifier /NOSTART_POSITION applies to EDT.
Close Help