Setting a line breakpoint

A line breakpoint is set on an executable line of a program in the editor.

When a breakpoint is enabled, all threads suspend before that line of code is executed. The debugger selects the thread that has been stopped by the breakpoint and automatically displays the stack frames for that thread. The line where the breakpoint was set is highlighted in the editor.

In the Breakpoints view, there are two indicators to the left of a set breakpoint. To the far left is a check box which indicates if the breakpoint is enabled (when enabled, the check box contains a check mark). To the near left, a filled indicator indicates the set breakpoint (when the breakpoint is disabled, this indicator is not filled).

You can add a line breakpoint to source that you have opened in the editor prior to debugging or to source that is open in the editor during a debug session. To add a line breakpoint in the editor, do the following:

    If you are setting a breakpoint prior to debugging, open the file where you want to add the breakpoint. If you are setting a breakpoint during a debug session, the source file will be opened in the editor automatically. In either the editor XSL file or XML file, do one of the following:

    1. Right-click the marker bar (the vertical bar to the left of the main text area) directly to the left of the line where you want to add the breakpoint and select Toggle Breakpoints from the pop-up menu.

    2. Double-click the marker bar directly to the left of the line where you want to add the breakpoint.

    Note: In XSL files, the debugger only recognizes breakpoints that are set in template rules. A new line breakpoint marker appears in both the Breakpoints view and on the marker bar (directly to the left of the line where you added the breakpoint).

Note: In the editor, you cannot set a line breakpoint on a line that already has a breakpoint set on it. When you right-click a line that already has a breakpoint set on it, choosing the Toggle Breakpoints action will remove the breakpoint. Similarly, double-clicking the line will cause removal of the breakpoint.

 

Related concepts

Breakpoints

 

Related tasks

Using breakpoints
Enabling and disabling breakpoints
Removing breakpoints