*print-restart-frames* Variable

Summary

Controls whether restart frames are printed in debugger output.

Package

dbg

Initial Value

nil

Description

The variable *print-restart-frames* is used by the debugger when it displays the stack frames. Restart frames are formed when restarts are established (see 3.3 The stack in the debugger), but are normally not shown by the debugger. However if *print-restart-frames* is set to t then the restart frames are shown.

Examples

USER 43 > (setq dbg:*print-restart-frames* t)

T 
USER 44 > (truncate 12.5 0.0)

Error: Division-by-zero caused by TRUNCATE
        of (12.5 0.0)
  1 (continue) Return a value to use
  2 Supply new arguments to use
  3 (abort) return to top loop level 0.

Type :c followed by a number to proceed

USER 45 : 1 > :b 5 
Restart frame: (ABORT) 
Catch frame: (NIL) 
Catch frame: #:|block-catcher-3223| 
Call to DIVISION-BY-ZERO-ERROR  : 
Call to TRUNCATEANY  : 
USER 46 : 1 > 

Notes

1. *print-restart-frames* can be set to value by:

   (set-debugger-options :restarts value)
   

2. *print-restart-frames* is an extension to Common Lisp.

See also

3.6 Debugger control variables
set-debugger-options