Introduction

## Various Windows Explained...

### Project Window

Understand's GUI is broken into two main areas, the Project Window and the Document Window. The Project Window, which can be hidden or shown, provides a quick way to find entities and information about them.

The Document Window is where source files, graphical views and a variety of other browsers and windows are displayed.

### Filter Area

The Project Window is further divided into two area, the Filter Area and the "Information Browser".

The Filter Area provides a quick list of entities of each kind shown in the selected Filter Area Tab. Options are Types, Subprograms, Files, Packages, and Files. In each of these any entity that has been declared (or used) in the source code can quickly be found.

### Root Filters

Note the tabs above beginning with "Root", as in "Root Decls" or " Root WIths". "Root" tabs filter entities to only what is on the top of a given tree. The tops (or bottoms) of relationship trees are often helpful points to being exploration of code new or unknown to you.

· Root Decls - the highest level declaring routines.
· Root Withs - Program units (packages, tasks, subprograms) that With other program units, but are not withed by anybody else.
· Root CallBys - Program units that are called by others but do not call anybody else. These are low-level routines.
· Root Calls - Program units that call others, but are not called themselves. These are either high level code (mains), or code that is called by hardware (interrupt handlers), or dead (unused) code.

### Information Browser

Any time you left click on an item in the Filter Alrea the Information Browser updates to show everything that Understand for Ada knows

about that entity. The Information Browser shows this data as a tree which whose branches can be expanded individuall or in bulk. There is always an Information Browser in the Project Window. In addition, by holding down the CTRL key while right clicking and choosing View Information, new Information Browser Windows can be displayed in the Document Area.

All information in an Information Window can be saved to a text file, or copied and pasted via standard Windows or X11 copying functions.

### Locator Window

I n past versions of Understand for Ada the Locator Window was the initial startup window that appeared when you start Understand for Ada. In the newer versions it is opened via the Search menu on the menubar. It has a filterable list of entities in the database. You may filter by name, by entity type, or by a kind of relationship (e.g. invocation, with, callby, etc...). You may also filter by looking at entities at the top of a given relationship tree (e.g. top of With Tree).

The purpose of the Locator Window is to help you find entities and/or views that you want to learn more about.

### Hierarchy Browser

This browser shows multiple level relationships between entities. All relationships are multi-level and are shown to the top or bottom of their respective tree unless a level option is set in the browser. Understand for Ada offers information about these relationships :

- Callby - view of who calls a given entity
- Child Lib Unit - shows the Child Library Units of a given compilation unit. Only available for Ada 95 code.
- Declaration Tree - shows the declaration nesting of program units in a compilation unit.
- File Contents - shows declaration nesting of compilation units in a given file.
- Instantiated From - shows the instantiation tree of a given generic type or compilation unit. Shows how an instantiated generic was built.
- Instantiations - shows who instantiates a given generic unit.
- Invocation - shows what compilation units a given unit invokes.
- Parent Lib Unit - Shows the parent lib units of a given entity.
- Type Derived From - Shows the tree of types a given type is derived from.
- Type Tree - Shows the types who derive new types from a given entity.
- With - Shows what compilation unit a given entity "Withs" into scope.
- WithBy - Shows what compilation units "With" a given entity.

### Declaration Browser

Declaration views offer a one glance way to see important structure and relational information about a given entity. Understand for Ada offers these declaration views:

- File Declaration - shows what compilation units are defined within a given declaration .
- Package - shows what entities are declared in a given package (body or spec). Also shows who "Withs" this package, and also who it "Withs". Parameters are shown if the package is a generic.If the package Begin/End block invokes any program units then these are shown in an invocations section.
- Program Units (Procedure/Function) - shows the parameters, invocations, and callbys of a given program unit. Also shows what a program unit "Withs" if it is a separate.
- Task - shows the parameters, invocations, and what entities/entry points are declared in a task. Also shows what the task Withs.

Scientific Toolworks, Inc. http://www.scitools.com Voice: (802) 763-2995 Fax: (802) 763-3066 support@scitools.com sales@scitools.com