Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ d_v — Apollo

Media Vault

Software Library

Restoration Projects

Artifacts Sought

;
DELETE -- Deletes one or more breakpoints, macros, definitions, or
          directories in the list of alternate source directories.


FORMAT
            ------------------------------------------------
            | -Macro       macro-name1 ... macro-nameN
            |              -All
            |-----------------------------------------------
            | -DEFine      debugger-name1 ... debugger-nameN
            |              -All
            |-----------------------------------------------
            |              statement-id
   Delete   |              routine-name -All
            | -Breakpoint  -Here
            |              -VA address
            |              -All
            |-----------------------------------------------
            | -SDIR        an-integer
            |              -All
            ------------------------------------------------


REQUIRED ARGUMENTS

  DELETE supports four major arguments -- -Macro, -DEFine, -Breakpoint, and
  -SDIR.  You must supply at least one of these major arguments, and may
  optionally supply more.

  -Macro        Deletes one or more DEBUG macros. Following -Macro you must
                specify one of the following two subarguments:

                macro-name      to delete only those macros that you specify.
                                Macros are created with the MACRO command.

                -All            to delete all current DEBUG macros.

  -DEFine       Deletes the definitions for one or more debugger-names
                created by the DEFINE command.  Following -Define you must
                specify one of the following subarguments:

                debugger-name(s) to delete only those definitions that you
                                 specify.

                -All            to delete all definitions. The -ALL option
                                does not affect the predefined symbol (`.).

  -Breakpoint   Deletes one or more breakpoints. Following -Breakpoint, you
                can optionally specify one of the following subarguments.
                If you do not specify a subargument, the -HERE subargument
                is assumed.

                statement-id    to delete the breakpoint at the given
                                statement.

                routine-name -ALL  to delete all the breakpoints in that
                                   routine.

                -HERE           to delete the current breakpoint. In order to
                                use this subargument, the program must
                                currently be stopped at a breakpoint.  -HERE
                                always refers to the run environment, not any
                                user environment defined through an
                                ENVIRONMENT command.

                -VA address     to delete the breakpoint on the given virtual
                                address. (By default, DEBUG expects the address
                                to be a decimal integer.  Should you wish to
                                supply a hexadecimal integer, precede the
                                integer with 16#; for example, 16#1003C.

                -All            to delete every breakpoint in the program.

  -SDIR         Deletes one or all of the alternate source listing directories
                generated through the SOURCE command or the -SDIR command line
                option. Following -SDIR, you must specify one of the following
                two subarguments:

                n               Deletes exactly one of the source listing
                                directories.  n must be a positive integer
                                between 1 and 32,767.  Assuming that there
                                are x source listing directories, you specify
                                the nth one to delete.  If you specify an n
                                greater than x, DEBUG will take no action.
                                Note that DEBUG orders the source listing
                                directories in the same order that you define
                                them.  You can use  the LIST command to check
                                the order.  And by the way, a DELETE -SDIR
                                command will delete the directory name from
                                DEBUG's internal list; it will not delete
                                the directory itself.

                -All            Deletes all of the source listing directories.

OPTIONAL ARGUMENTS

  None.


DESCRIPTION

  Use the DELETE command to removee just about any DEBUG construct except
  debugger variables. (You cannot delete debugger variables, but you can
  deactivate them by setting their values to a negative integer.)

  You cannot delete -EXIT breakpoints without giving the specific statement
  numbers.  You can use the LIST command (described in this chapter) to
  display the statement numbers.

  For full details, see Chapter 3 of the DOMAIN Language Level Debugger
  Reference manual.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026