Locating source

Source for the application that you are debugging displays in an editor during a debug session. From the editor, you can perform debug actions, such as breakpoint setting.

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 by way of the URL. If it cannot locate source by way of 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 an XSL transformation for which there is no project in the workspace, and the transformation uses include or import files, be sure to add the location of the source in the Source tab of the launch configuration. Alternatively, you can add the location of the source to the source lookup path in the Edit Source Lookup Path dialog box. The debugger will find the source for the main XSLT stylesheet from the path you specified when launching, however for include or import files, it does not have the full path and thus you must provide the source location to the debugger.

Altering the source search path

After you have launched a debug session, you can modify or add to the source search path by completing these steps:

  1. Right-click the debug target (or one of its threads or stack frames) and choose Edit Source Lookup from the pop-up menu.
  2. In the Edit Source Lookup Path dialog box, perform these tasks:
    • To add a source location, click Add. This will invoke the Add Source dialog box, in which you can select the type of source location to add. From the selection list in the Add Source dialog box.
      • 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 box will result in another dialog box, in which you can enter or browse for the source search path location that you want to use.
    • 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.
  3. If you want to search for all instances of the source file name 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 file name, you will be prompted by a dialog box to choose the correct source file.
  4. After you have changed the path, click OK to close the dialog box and have the new path used to find source.
    Note: Changes to the source lookup path will be saved in the launch configuration that was used to launch the selected debug session.

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 box are provided in the preceding section.

Multiple source files found

If the source lookup path is set to search for all instances of source file names in the source search path, and the debugger locates multiple instances of the source file name, you are prompted by the Select Source File dialog box to choose the correct source file. In this dialog box, select the correct source file from the list and click OK to have it open in the editor.


Feedback