Command
Displays the name of the currently selected command. This pull-down list contains a list of all the custom commands defined.
Run
This is the command line to be executed when the custom command is invoked. The Run text box can contain special meta-characters. See also “The 'Run' Field Format”.
Dir
The working directory used when executing the script specified in the Run text box. Source Insight sets the current working directory to this location before running the command. If left blank, then Source Insight sets the current working directory to the project source directory.
Output Group
This group of options control what happens to the output of the command.
Iconic Window
If checked, the spawned program will be put into a minimized window. If not checked, then the program will launch normally.
Capture Output
If checked, the standard output of the command will be captured and will appear in a new command output window when the command completes. The command output window’s title will be the name of the custom command. If not checked, the standard output will not be captured.
Paste Output
If checked, the standard output of the command is pasted to the current selection.
Control Group
This group of options specifies what Source Insight does before and after the command runs.
Save Files First
If checked, Source Insight will perform a Save All command prior to executing the command. The Save All command will prompt you for each file that has been edited to see if you want to save the file.
If not checked, the command will be executed without saving any changed files. The unsaved changes will be retained when the command completes and control returns to Source Insight. If the command should cause a crash, Source Insight will be able to perform a recovery and all changes will be intact. See also “Recovering From Crashes”.
Pause When Done
If checked, Source Insight will display this message in a DOS box when the command completes:
Press any key to return to Source Insight...
If not checked, the DOS box will terminate after the command completes.
Beep When Done
If checked, Source Insight will beep when the command terminates.
Wait Until Done
If checked, then Source Insight will suspend itself until the command finishes.
If not checked, then Source Insight will run the command and continue. You will be able to switch back to the Source Insight window and continue working while the command runs in the background.
Exit Source Insight
Source Insight will exit after launching the program.
Source Links in Output
These options specify how the output is to be treated after the command finishes. You may tell Source Insight to parse through the captured output to find specific warning or error messages.
Parse Source Links
The command output will be searched for source link patterns. The patterns typically will match warning and error messages. If a pattern match is found, Source Insight inserts a source link at that line. The source link is used to link the warning or error message to its target source line. If Parse Source Links is enabled, you must have a valid search expression in the Pattern text box.
Pattern contains
File, then Line and Line, then File. This indicates the order of the groups in the pattern expression.
Select File, then Line if the first group in the pattern expression is the file name and the second group is the line number. With this setting, the second group, (i.e. the line number), is optional.
Select Line, then File if the first group in the pattern expression is the line number and the second group is the file name.
Pattern
Contains the regular expression used to search the command output for file names and line numbers. This is ignored if the Parse Source Links option is disabled. If the option is enabled, then this text box must contain a valid regular expression that contains “groups” for the file name and the line number. See also “Regular Expressions”.
Define
Click this button to define the command named in the Name text box. If the command already exists, it is redefined.
Remove
Click this button to delete the command.
Run
Click this button to define and execute the command.
Cancel
Click this button to cancel the dialog box. Any definitions made in the dialog box will be retained.
Menu…
Click this button to define the current command and jump to the Menu Assignments dialog.
Keys…
Click this button to define the current command and jump to the Key Assignments dialog.