11.2 Tracing and Untracing functions

The Trace State view has a Trace pane where you can enter a function name. Press Return or click the button to trace that function.

The Traced Functions pane shows the list of functions that are currently traced. When some functions are selected, the Function menu contains the standard commands described in Performing operations on selected objects. As with other tools, choose Edit > Select All and Edit > Deselect All to select and deselect all the functions listed in the Traced Functions area.

The Selected Options area shows the trace options for a function selected in the Traced Functions pane. The trace options allow you to restrict or expand upon the information printed during a trace and can be modified by double-clicking on the item in the Traced Functions pane which raises the Trace Options dialog. For information about the trace options, see the section "Tracing options" in the LispWorks User Guide . Note that the options only apply to the first selected function. Each traced function has its own, independent, set of options.

The Tracing Enabled button can be used to turn all tracing off, whilst retaining the tracing state, and switch it back on again.

The Untrace button untraces the functions selected in the Traced Functions pane.

The Untrace All button untraces all functions.

In addition, the Tracer tool will track changes to the set of traced functions that are made from other tools, for example calls to the macros trace and untrace or the Trace submenu described in Tracing symbols from tools.

11.2.1 Tracing methods

Common LispWorks User Guide (Macintosh version) - 21 Feb 2008