Structural Informatics Group (SIG) logo
Home | Projects | Demos | Downloads | Publications | Local Info | About Us | New site
Go to the first, previous, next, last section, table of contents.

*tracelimit*

*tracelimit*

type: system variable
location: built-in
source file: xlinit.c  and  xldbug.c
Common LISP compatible: no
supported on: all machines

SYNTAX

*tracelimit*

DESCRIPTION

*TRACELIMIT* is a system variable that controls the number of forms printed on entry to the break loop. If *TRACELIMIT* is an integer, then the integer is the maximum number of forms that will be printed. If *TRACELIMIT* is NIL or a non-integer, then all of the forms will be printed. Note that *TRACENABLE* needs to be set to a non-NIL value to enable the printing of back-trace information on entry to the break loop.

EXAMPLES

(defun foo (x) (fee x))                 ; define FOO
(defun fee (y) (break))                 ; define FEE
(setq *tracenable* T)                   ; enable the back trace
(setq *tracelimit* NIL)                 ; show all the entries
(foo 5)                                 ; break: **BREAK**
                                        ; prints  Function:.....BREAK..
                                        ;         Function:.....FEE....
                                        ;         Arguments:
                                        ;           5
                                        ;         Function:.....FOO....
                                        ;         Arguments:
                                        ;           5
(clean-up)                              ; from break loop
(setq *tracelimit* 2)                   ; show only 2 entries
(foo 5)                                 ; break: **BREAK**
                                        ; prints  Function:.....BREAK..
                                        ;         Function:.....FEE....
                                        ;         Arguments:
                                        ;           5
(clean-up)                              ; from break loop

NOTE: *TRACENABLE* and *TRACELIMIT* have to do with back trace information at entry to a break loop and have nothing to do with TRACE and UNTRACE.


Go to the first, previous, next, last section, table of contents.