Finding 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.

If you launch a debug session for a Web object and the debugger cannot find source, you can edit the source lookup path. If the debugger finds more than one matching source file names, you can set the debugger to prompt you to choose source from a list of the matching source file names.

Editing the source lookup path

To edit the source lookup path while you are debugging, right-click the debug target, a thread, or stack frame in the Debug view and select Edit Source Lookup from the pop-up menu to open the Edit Source Lookup Path dialog box. By default, the source lookup path in this dialog box is derived from the associated project's build path. To change the Source Lookup Path, do the following:

  • 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. All other selections that are valid for debugging Web objects will result in a 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.

No source files 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

By default, the debugger will search for source until it reaches the first file name match that is found. If you want the debugger to search for all possible source file name matches, you must select the Search for duplicate source files on the path check box in the Edit Source Lookup Path dialog box.

Note: Searching for all source file name matches is slower than stopping at the first file name match found.

If the debugger is set to search for all source file name matches, the Select Source File dialog box opens when multiple files are found. The dialog box displays a list of all files that are found, from which you can choose the correct source to display during the debug session.


Feedback