def.v — Apollo

DEFINE -- Defines an abbreviation for a frequently-used command or string.


FORMAT

  DEFine  debugger-name  text


REQUIRED ARGUMENTS

  debugger-name      Any legal debugger-name.   All debugger-names must begin
                     with an accent grave (`).

  text               Any text. Do not enclose the text in quotes or brackets
                     unless you want them to become part of the definition.
                     The text can have blanks in it.

OPTIONAL ARGUMENTS

  None.


DESCRIPTION

  Use DEFINE to create a name (i.e., a nickname) for some text.  The text
  will either be a string (e.g., a routine-name) or one DEBUG command.

  For example, consider the long-hand method of setting up breakpoints
  in a routine:

    > BREAKPOINT test\main$\math_io\write_io\28
    > BREAKPOINT test\main$\math_io\write_io\56

  However, by using DEFINE as follows, we can abbreviate the lengthy
  routine-name to a simpler abbreviation:

    > DEFINE `r test\main$\math_io\write_io\

  Now we can use `r in place of the routine-name; for example:

    > BREAKPOINT `r28
    > BREAKPOINT `r56

  Use the LIST command to get a list of current definitions, and use the DELETE
  command to remove definitions.

  For full details, see the "DEFINE" listing in Chapter 3 of the DOMAIN Language
  Level Debugger Reference manual.
Museum
