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.