DBG$HELP.HLB  —  DEBUG  SET  EDITOR
    Establishes the editor that is started by the EDIT command.

    Format

      SET EDITOR  [command-line]

1  –  Parameters 

 command-line

    Specifies a command line to start a particular editor on your
    system when you use the EDIT command.

    You need not specify a command line if you use /CALLABLE_EDT,
    /CALLABLE_LSEDIT, or /CALLABLE_TPU. If you do not use one of
    these qualifiers, the editor specified in the SET EDITOR command
    line is spawned to a subprocess when you enter the EDIT command.

    You can specify a command line with /CALLABLE_LSEDIT or
    /CALLABLE_TPU but not with /CALLABLE_EDT.

2  –  Qualifiers

2.1    /CALLABLE_EDT 

    Specifies that the callable version of the EDT editor is started
    when you use the EDIT command. Do not specify a command line with
    this qualifier (a command line of "EDT" is used).

2.2    /CALLABLE_TPU 

    Specifies that the callable version of the VSI Text Processing
    Utility (TPU) is started when you use the EDIT command. If you
    also specify a command line, it is passed to callable TPU. If
    you do not specify a command line, the default command line is
    TPU.

2.3    /START_POSITION 

       /START_POSITION
       /NOSTART_POSITION (default)

    Controls whether the /START_POSITION qualifier is appended
    to the specified or default command line when you enter the
    EDIT command. Currently, only TPU and the VSI Language-
    Sensitive Editor (specified as TPU or /CALLABLE_TPU, and LSEDIT
    or /CALLABLE_LSEDIT, respectively) support this qualifier.

    The /START_POSITION qualifier affects the initial position of
    the editor's cursor. By default (/NOSTART_POSITION), the editor's
    cursor is placed at the beginning of source line 1, regardless
    of which line is centered in the debugger's source display or
    whether you specify a line number in the EDIT command. If you
    specify /START_POSITION, the cursor is placed either on the
    line whose number you specify in the EDIT command, or (if you
    do not specify a line number) on the line that is centered in the
    current source display.

3  –  Description 

    The SET EDITOR command enables you to specify any editor that is
    installed on your system. In general, the command line specified
    as parameter to the SET EDITOR command is spawned and executed in
    a subprocess.

    On Alpha and Integrity servers, if you use EDT, LSEDIT, or
    TPU, you can start these editors in a more efficient way.
    You can specify /CALLABLE_EDT or /CALLABLE_TPU which causes the
    callable versions of EDT and TPU respectively, to be invoked
    by the EDIT command. In the case of TPU, you can also specify
    a command line that is executed by the callable editor.

    On Alpha processors, you can use /CALLABLE_EDT or /CALLABLE_TPU,
    but not /CALLABLE_LSEDIT.

    Related commands:

       EDIT
       (SET,SHOW,CANCEL) SOURCE
       SHOW DEFINE

4  –  Examples 

    1.DBG> SET EDITOR '@MAIL$EDIT ""'

      This command causes the EDIT command to spawn the command line
      '@MAIL$EDIT ""', which starts the same editor as you use in
      MAIL.

    2.DBG> SET EDITOR/CALLABLE_TPU

      This command causes the EDIT command to start callable TPU
      with the default command line of TPU.

    3.DBG> SET EDITOR/CALLABLE_TPU TPU/SECTION=MYSECINI.TPU$SECTION

      This command causes the EDIT command to start callable TPU
      with the command line TPU/SECTION=MYSECINI.TPU$SECTION.

    4.DBG> SET EDITOR/CALLABLE_EDT/START_POSITION

      This command causes the EDIT command to start callable EDT
      with the default command line of EDT. Also the /START_POSITION
      qualifier is appended to the command line, so that the editing
      session starts on the source line that is centered in the
      debugger's current source display.
Close Help