PowerAda The PowerAda Global Uses Dialog

From OC Systems Wiki!
Jump to: navigation, search

The Global Uses Dialog allows you to search for references to Ada declarative items in more than just a single unit. The scope of the search, that is the units in which to search, is controllable, and may include all sublibraries in the project. The result of the search is a list of units which have been found to contain references to the selected declarative element. Each of those units may be viewed in the Source Browser to see the individual uses, or a text file may be saved containing the uses for later inspection.

Contents of the Global Uses Dialog

A global uses dialog consists of four areas:

  • the global uses frame, which describes for which Ada declarative element global uses are being determined;
  • the Sublibraries to Search, and Select All button, which allows user to select which sublibraries are to be searched for uses (to reduce search time);
  • the list of units found to contain uses, along with the Browse Uses and Save All buttons; and
  • the action buttons.

Sublibraries To Search List

The list of sublibraries to search shows only those sublibraries that actually import the sublibrary of the unit being searched (including the sublibrary including the unit). Those that remain to be searched are highlighted. Click on the Select All button to select all sublibraries for searching, or select individual sublibraries by holding down the Ctrl key while clicking on each. Once any sublibraries are selected, the Search button becomes active and the search for uses can proceed.

Search Button

The Search button starts a new global uses search or resumes an interrupted search. A working dialog will appear (to be used to interrupt the operation), and the query status will be updated to indicate which unit is currently being checked. The Search button will start a new global uses search if the previous search has completed.

Browse Uses Button

The Browse Uses button will open a source browser with the unit selected from the list Units Containing Uses and display the uses found in that unit. Alternatively, double-clicking on an entry in the list will achieve the same result. The Browse Uses button is only active when there are units in the Units Containing Uses list.

Save All Button

The Save All button will pop up a dialog to specify a text file to save the results of the search to. The text is in PowerAda "analysis" format, which means it should have a suffix of .ana so it can be viewed by the PowerAda Powerada Build Windows.

Dismiss Button

The Dismiss button will abandon a completed or interrupted search, and close the global uses dialog. All information about the search will be lost.

Working Dialog

The working dialog is presented while the global uses search is in progress. To interrupt the search, click the Interrupt button. This will suspend the search operation, retaining the current results. The results may be examined at this time, the search may be resumed, or the search may be abandoned.