## Configuring Tools

Select Options->Tool Configurations from the toolbar menu to configure external tools such as source code editors for use within Understand for Ada. External tools configured for use will be available for context-sensitive launching from the right-click popup menus.

Use the Tools tab of the Configurations dialog to define the application command and parameters to invoke the tool. Also specify the desired name to appear on the right-click menus in Understand for Ada. If the tool you use is on your executable search path, simply enter its name. If not, then use the Browse button to specify the full path to its executable.

Parameters beginning with $Cur are current position variables that are only available on menus inside a file display. Parameters beginning with $Decl are declaration variables that are only available for entities with an entity declaration.

Variable | Description
--- | ---
$CurProject | Current fullname location of opened project
$CurProjectDir | Directory the opened project is located
$CurProjectName | Current short filename of opened project (not including extension)
$CurReportHtml | Current fullname location of opened project's HTML Report
$CurReportText | Current fullname location of opened project's single file Text Report
$CurCol | Current file's column position
$CurFile | Current file's full path name
$CurFileDir | Current file's directory
$CurFileShortName | Current file's name without full path
$CurFileName | Current file's name not including extension or full path
$CurFileExt | Current file's extension
$CurLine | Current file's line position
$CurSelection | Selected text in the Current window (currently file windows only)
$CurWord | The word/text at the current cursor position in the Current file window
$DeclCol | Column in which the selected entity was declared, defaults to 1
$DeclFile | Full path name of the file in which the selected entity was declared
$DeclLine | Line in which the selected entity was declared, defaults to 1
$PromptForText | "text descriptor" before executing command, prompts user for this needed string parameter

Clicking the Help button displays the most up-to-date list of symbols that may be used for parameters.

To automatically add the tool to the right-click pop-up menu, check the “Add to Pop Up Menu” box. To automatically add the tool to the Options->User Tools menu, check the “Add to Tools Menu” box. To automatically add an icon for the tool to the toolbar, check the “Add to Toolbar” box.

Select Apply when completed to add the new command to the list. Selected commands may also be deleted from the list.

Scientific Toolworks, Inc. http://www.scitools.com