DBG$HELP.HLB  —  DEBUG  SHOW  SOURCE
    Identifies the source directory search lists and search methods
    currently in effect.

    Format

      SHOW SOURCE

1  –  Qualifiers

1.1    /DISPLAY

    Identifies the search list used when the debugger displays source
    code.

1.2    /EDIT

    Identifies the search list to be used during execution of the
    debugger's EDIT command.

2  –  Description

    The SET SOURCE/MODULE=module-name command establishes a source
    directory search list for a particular module. The SET SOURCE
    command establishes a source directory search list for all
    modules not explicitly mentioned in a SET SOURCE/MODULE=module-
    name command. When you have used those commands, SHOW SOURCE
    identifies the source directory search list associated with each
    search category.

    If a source directory search list has not been established by
    using the SET SOURCE or SET SOURCE/MODULE=module-name command,
    the SHOW SOURCE command indicates that no directory search list
    is currently in effect. In this case, the debugger expects each
    source file to be in the same directory that it was in at compile
    time (the debugger also checks that the version number and the
    creation date and time of a source file match the information in
    the debugger's symbol table).

    The /EDIT qualifier is needed when the files used for the display
    of source code are different from the files to be edited by using
    the EDIT command. This is the case with Ada programs. For Ada
    programs, the SHOW SOURCE command identifies the search list of
    files used for source display (the copied source files in Ada
    program libraries); the SHOW SOURCE/EDIT command identifies the
    search list for the source files you edit when using the EDIT
    command.

    For information specific to Ada programs, see the
    Language_Support Ada help topic.

    Related commands:

       (SET,CANCEL) SOURCE

3  –  Examples

    1.DBG> SHOW SOURCE
      no directory search list in effect,
          match the latest source file version
      DBG> SET SOURCE [PROJA],[PROJB],DISK:[PETER.PROJC]
      DBG> SHOW SOURCE
      source directory search list for all modules,
          match the latest source file version:
              [PROJA]
              [PROJB]
              DISK:[PETER.PROJC]
      DBG>

      In this example, the SET SOURCE command directs the debugger to
      search the directories [PROJA],[PROJB], and DISK:[PETER.PROJC].
      By default, the debugger searches for the latest version of
      source files.

    2.DBG> SET SOURCE/MODULE=CTEST/EXACT [], DISK$2:[PROJD]
      DBG> SHOW SOURCE
      source directory search list for CTEST,
          match the exact source file version:
              []
              DISK$2:[PROJD]
      source directory search list for all other modules,
      match the latest source file version:
              [PROJA]
              [PROJB]
              DISK:[PETER.PROJC]
      DBG>

      In this example, the SET SOURCE command directs the debugger
      to search the current default directory ([]) and directory
      DISK$2:[PROJD] for source files to use with the module CTEST.
      The /EXACT qualifier specifies that the search will locate
      the exact version of the CTEST source files found in the debug
      symbol table.
Close Help