3.10 Tracing symbols from tools

For some tools, submenus under the relevant main menus (for example, the Expression menu on the Editor tool) contain a Trace submenu that allows you to set tracing options for a function, method, macro, or generic function. This is a useful shortcut to the trace macro, since it gives you some control over tracing in the environment without having to work directly at the Common Lisp prompt.

Below, the current function means the currently selected function, method, macro or generic function, or in the case of the Editor and Listener, the symbol under the cursor.

A Trace submenu generally has the following commands:

• Choose Trace to trace the current function.
• Choose Trace Inside to trace the current function within the current context. Choosing this command sets the :inside option for trace.
• Choose Trace with Break to trace the current function, and enter the debugger on entry to it. Choosing this command sets the :break option to t.
• Choose Untrace to turn off tracing on the current function.
• Choose Untrace All to turn off tracing on currently traced functions. Note that this does not turn off tracing in the environment as a whole.
• Choose Show in Tracer to trace the current function and display in the Tracer tool. This offers you more control over tracing. See 11 The Tracer for details.
• Choose Toggle Tracing to turn all tracing commands in the environment on or off. Choose Toggle Tracing again to restore the previous tracing state.