Parse Source Links

The Parse Source Links command searches the current file for a specified pattern. Whenever it finds a match, it creates a source link at that location. The source link links the source line in the current file to the file and line number that was parsed using the pattern.

File, then Line

and Line, then File. 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.


Contains the regular expression used to search the command output for file names and line numbers. This text box must contain a valid regular expression that contains "groups" for the file name and the line number. The contents of this text box are saved in the current workspace.

The Parse Source Links command is useful if you have some kind of log file that contains compiler output and error messages. You just open the log file, and run the Parse Source Links command. A link will be setup for each line in the log file containing an error message. Searching and Source Links.

Maintaining Multiple Parse Patterns

If you often have more than one type of parse pattern that you want to use, you can use Custom Commands to define a custom command for each type that simply echoes the file and parses source links from the out­put. Each custom command can have its own parse pattern, so you can save many parse patterns this way.

For example,

1.From the Options menu, select Custom Commands.

2.Click the Add button, and type "Parse Type 1" in the Name text box.

3.In the Run text box, type "command /c type %f". This command line will type out the contents of the current source file.

4.Check the Parse Link in Output box.

5.Type the parse pattern you want in the Pattern text box.

When you run this command, the current file will be typed out, captured by Source Insight, and parsed for source links using the parse pattern stored with the custom command.