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
                                                    definitions 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
                                                    program variables in the
                                                    current routine.

                   List -Variables routine-name     lists the names of all
                                                    program variables in the
                                                    specified 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