Locating source
When you create a launch configuration for debugging an XSL transformation, you can set the source lookup path for the launch configuration. After you begin the debug session, you can alter this source search path. If the debugger cannot find source in the source lookup path, it will search for it via the URL. If it cannot locate source via the URL, it will open the Debugger Source Not Found Editor, in which you can specify another path to use for source lookup.
Note: If you want to debug using source for XSLT include or import files on your workstation, and that source is not currently in a project then, before you can begin a debug session, create a workbench project and import the source for the include or import files into that project. This project must be specified in the Main tab of the launch configuration or as a source location (in the launch configuration Source tab or in the Edit Source Lookup Path dialog).
Altering the source search path
After you have launched a debug session, you can modify or add to the source search path by doing the following:
Right-click the debug target (or one of its threads or stack frames) and choose Edit Source Lookup from the pop-up menu. In the Edit Source Lookup Path dialog box, do the following:
- To add a source location, click Add. This will invoke the Add Source dialog, which allows you to select the type of source location to add. From the selection list in the Add Source dialog
- Choosing Workspace will cause all projects in your workspace to be added to the source search path.
- Choosing Debug engine will have no affect on the source lookup path.
All other selections in this dialog will result in a dialog which allows you to enter or browse for the desired source search path location.
- To remove an existing entry, select a source location and click Remove.
- To set the order of existing entries, select a source location and click Up or Down to alter that location's placement.
If you wish to search for all instances of the source filename in the source search path, select the Search for duplicate source files on the path check box. If you select this check box and the debugger finds multiple instances of the filename, you will be prompted via a dialog to choose the correct source file. After you have changed the path as desired, click OK to close the dialog box and have the new path used to find source.
Source file not found
When source cannot be found, the editor opens without source. In the editor, you can edit the source lookup path so that it points to the location of the source file. To edit the source lookup path, select the Edit Source Lookup Path push button. This will invoke the Edit Source Lookup Path dialog box. Instructions for using this dialog are provided above.
Multiple source files found
If the source lookup path is set to search for all instances of source filenames in the source search path, and the debugger locates multiple instances of the source filename, you are prompted by the Select Source File dialog to choose the correct source file. In this dialog, select the correct source file from the list and click OK to have it open in the editor.