Source menu: accessing source files

The Source menu navigates your program source code, accessing commands for browsing or scanning program sources.

Browse file

[dbxtra command: file [source-file-name]]
Switches to another source file in the source window. If no argument is specified, then the current source-file-name is displayed.

Source Path

[dbxtra command: use directory-list]
Specifies the list of directories to be used by dbXtra in locating source files. The specified list replaces the list currently being used to locate source files.

Search

/regular-expression[/]
?regular-expression[?]
Searches forward [/] or backward [?] for a given pattern within the currently displayed file. Regular expressions may be used in the search string, which defaults to the currently selected text within the source window.

Function

[dbxtra command: func [function-name]]
Prompts for a function within the current program, then displays the source text around the first executable statement within that function. The new function then becomes the current function. If no argument is specified, the name of the current function is displayed.

DbXref

[dbxtra command: dbxref arguments]
dbXref prompts for the dbxref command line arguments, then generates cross reference information for the current executable. The dbxref command generates detailed information about the nature of the programming elements used in the program sources. It is similar to the cxref command available on most UNIX systems and in fact, you may execute the dbxref command using the syntax described here from the UNIX shell or from within your makefiles.

The syntax for the command is:

dbxref [-i] [options] files

dbxref generates the cross-reference database for the specified files. If the -i flag is used, it generates the cross-reference information incrementally. In this case, files should only be the ones that contain new information to be put into the database. This assumes that the cross-reference database for the program already exists.

The options allowed are -I, -D, and -U, and these have the same meanings as those for the C compiler and preprocessor.

The database is saved in the file programname.xref, where programname is the name of the executable file being debugged. This can be overridden using the -ofile flag, where file is the name of the new file to contain the database.

Up

[dbxtra command: up [n]]
Moves up the call stack by a specified number of levels (default is 1). The source window changes to display the function that called the current function. This function now becomes the current function and is used in resolving identifiers. Variable scoping rules default to this function.

Down

[dbxtra command: down [n]]
Moves down the call stack by a specified number of levels (default is 1). The source window changes to display the function that was called by the current function. This function now becomes the current function and is used in resolving identifiers. Variable scoping rules default to this function.