Configuring Tools

Select Options->Tool Configurations from the toolbar menu to configure external tools such as source code editors for use within Understand for Java. 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 Java. 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