Control Toolbar

XML source selector - The current selection represents the source document used as input by the transformation engine. A drop-down list contains all opened files (XML files being emphasized). This option allows you to use other file types also as source documents. In an XQuery debugging session this selection field can be set to the default value NONE, because usually XQuery documents do not require an input source.

XSL / XQuery selector - The current selection represents the stylesheet or XQuery document to be used by the transformation engine. The selection list contains all opened files (XSLT / XQuery files being emphasized).

Link with editor - When enabled, the XML and XSLT/XQuery selectors display the names of the files opened in the central editor panels. This button is disabled by default.

Output selector - The selection represents the output file specified in the associated transformation scenario.

XSLT / XQuery parameters - XSLT / XQuery parameters to be used by the transformation.

Libraries - Add and remove the Java classes and jars used as XSLT extensions.

Turn on profiling - Enables / Disables current transformation profiling.

Enable XHTML output - Enables the rendering of the output in the XHTML output view during the transformation process. For performance issues, disable XHTML output when working with very large files. Note that only XHTML conformant documents can be rendered by this view. In order to view the output result of other formats, such as HTML, save the Text output area to a file and use an external browser for viewing.

When starting a debug session from the editor perspective using the Debug Scenario action, the state of this toolbar button reflects the state of the Show as XHTML output option from the scenario.

Turn on/off output to source mapping - Enables or disables the output to source mapping between every line of output and the instruction element / source context that generated it.

Debugger Preferences - Quick link to Debugger preferences page.

XSLT / XQuery engine selector - Lists the processors available for debugging XSLT and XQuery transformations.

XSLT / XQuery engine advanced options - Advanced options available for Saxon 9.4.0.4.

Step into - Starts the debugging process and runs until the next stylesheet node or the next XPath 2.0 expression step (next transformation step).

Step over - Executes the current stylesheet node (including its sub-elements) and goes to the next node in document order (usually the next sibling of the current node) or to the next step of an XPath 2.0 expression.

Step over

Step out - Steps out to the parent node (equivalent to the Step over on the parent).

Step out

Run - Starts the debugging process. The execution of the process is paused when a breakpoint is encountered. (see breakpoints).

Run to cursor - Starts the debugging process and runs until one of the following conditions occur: the line of cursor is reached, a valid breakpoint is reached or the execution ends.

Run to end - Runs the transformation until the end, without taking into account enabled breakpoints (if any).

Pause - Interrupts the current transformation. This action is useful for long transformations (DocBook for instance) when you want to find out what point the transformation has reached. The transformation can be resumed after.

Stop - Ends the transformation process.

Show current execution nodes - Positions the cursor at the current debug context. Possible displayed states:

entering () or leaving () an XML execution node;
entering () or leaving () an XSL execution node;
entering () or leaving () an XPath execution node.
Note: When you set a MarkLogic server as a processor, the Show current execution nodes button is named Refresh current session context from server. Click this button to refresh the information in all the views.