Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ l.v — Apollo

Media Vault

Software Library

Restoration Projects

Artifacts Sought

LIST -- Produces a list of program routines, program variables, DEBUG definitions, DEBUG
macros, breakpoints, or alternate search directories.


FORMAT

        -Macro   macro-name
        -DEFine  definition-name
        -Breakpoint   statement-ID
  list  -Routines
        -VARiables  routine-name
        -DV
        -SDIR


REQUIRED ARGUMENTS

  None.          If you specify LIST with no arguments, DEBUG returns a list
                 of all macros, definitions, breakpoints, routines, program
                 variables, DEBUG variables, and alternate search directories.


OPTIONAL ARGUMENTS

  -Macro         Lists the names and definitions of DEBUG macros.  A macro is
                 something you create with the MACRO command.  Use this option
                 in one of the following two ways:

                   List  -Macro                     lists the names and definitions
                                                    of all macros.

                   List  -Macro macro-name          lists the definition for this
                                                    particular macro.

  -DEFine        Lists the names and definitions of DEBUG definitions.  A DEBUG
                 definition is something you create with the DEFINE command. Use
                 this option in one of the following two ways:

                   List  -Define                    lists the names and defini-
                                                    tions of all DEBUG definitions.

                   List  -Define definition-name    lists the definition for this
                                                    particular DEBUG definition.

  -Breakpoint    Lists information about breakpoints.  Use this option in one of
                 the following three ways:

                   List -Breakpoint                 describes every breakpoint in
                                                    the program.

                   List -Breakpoint routine-name    describes every breakpoint in
                                                    that routine.

                   List -Breakpoint statement-id    describes the breakpoint at
                                                    that line number.

  -Routines      Lists all routines in the program including the startup routines
                 provided by the compiler.  If you compiled the routine with either
                 the -DBS or -DBA compiler options, DEBUG prints the message
                 "(symbol table available)" next to the routine-name.  If this
                 message does not appear, then you cannot access the variables
                 in this routine.  DEBUG lists nested routines by indenting them
                 under their parent routine or module.

  -VARiables     Lists the names of program variables.  Use this option in one
                 of the following two ways:

                   List -Variables                  lists the names of all pro-
                                                    gram variables in the cur-
                                                    rent routine.

                   List -Variables routine-name     lists the names of all pro-
                                                    gram variables in the speci-
                                                    fied routine.

  -DV            Lists all active DEBUG variables.  You activate DEBUG variables
                 with the SET command.

  -SDIR          Lists the current alternate source file pathname(s) specified
                 by the SOURCE command or the -SDIR option.


DESCRIPTION

  Use the LIST command to identify the components of a DEBUG session.  You can
  issue the LIST command without any arguments or with one or more arguments.
  If you issue the LIST command without arguments, DEBUG displays information
  on all components.  Specifying LIST with one or more arguments limits the
  information to particular components.

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

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