2 The Debugger

2.5 Debugger control variables

common-lisp:*debug-io*

Variable

: The value of this variable is the stream which the debugger uses for its input and output.

dbg:*debug-print-length*

Variable

: The value to whichcommon-lisp:*print-length* is bound during output from the debugger.

dbg:*debug-print-level*

Variable

: The value to whichcommon-lisp:*print-level* is bound during output from the debugger.

dbg:*hidden-packages*

Variable

: This variable should be bound to a list of packages. The debugger suppresses symbols from these packages (so, for example, it does not display call frames for functions in these packages).

dbg:*print-binding-frames* dbg:*print-catch-frames* dbg:*print-handler-frames* dbg:*print-open-frames* dbg:*print-restart-frames* dbg:*print-non-symbol-frames*

Variables

: These six variables control whether or not the corresponding types of frame are displayed by the debugger. For each variable, if the variable is non-nil then that type of frame is shown. Initially onlydbg:*print-catch-frames* is non-nil. Note that the call frames are always displayed.

The following function is used in conjunction with these variables.

dbg:set-debugger-options

Function

dbg:set-debugger-options &key all bindings catchers hidden non-symbol handler restarts invisible

: A call toset-debugger-options allows you to set the above variables without having the inconvenience of setting each variable individually with a call tosetq and without having to remember the precise names for each of the variables.
: The keywords in the function refer to the different system variables as described below:
: :all -- affects the state of the:all command.
: :bindings --dbg:*print-binding-frames*
: :catchers --dbg:*print-catch-frames*
: :hidden --dbg:*hidden-packages*
: :non-symbol --dbg:*print-non-symbol-frames*
: :handler --dbg:*print-handler-frames*
: :restarts --dbg:*print-restart-frames*
: :invisible --dbg:*print-invisible-frames*