6.7 The symbol browser

The symbol browser allows searching all occurrences of a symbol. A symbol can be a variable, type, procedure or constant that occurs in the program or unit sources.

To enable the symbol browser, the program or unit must be compiled with browser information. This can be done by setting the browser information options in the compiler options dialog.

The IDE allows to browse several types of symbols:

Procedures

Allows quick jumping to a procedure definition or implementation.

Objects

Quickly browse for an object.

Modules

Browse a module.

Globals

Browse any global symbol.

Arbitrary symbol

Browse an arbitrary symbol.

In all cases, first a symbol to be browsed must be selected. After that, a browse window appears. In the browse window, all locations where the symbol was encountered are shown. Selecting a location and pressing the space bar will cause the editor to jump to that location; the line containing the symbol will be highlighted.

If the location is in a source file that is not yet displayed, a new window will be opened with the source file loaded.

After the desired location has been reached, the browser window can be closed with the usual commands.

The behavior of the browser can be customized with the browser options dialog, using the ”Options—Browser” menu. The browser options dialog looks like figure (6.9).



Figure 6.9: The browser options dialog.

PIC


The following options can be set in the browser options dialog:

Symbols

Here the types of symbols displayed in the browser can be selected:

Labels

Labels are shown.

Constants

Constants are shown.

Types

Types are shown.

Variables

Variables are shown.

Procedures

Procedures are shown.

Inherited

Sub-browsing

Specifies what the browser should do when displaying the members of a complex symbol such as a record or class:

New browser

The members are shown in a new browser window.

Replace current

The contents of the current window are replaced with the members of the selected complex symbol.

Preferred pane

Specifies what pane is shown in the browser when it is initially opened:

Scope

Reference

Display

Determines how the browser should display the symbols:

Qualified symbols

Sort always

Sorts the symbols in the browser window.