XLISP *tracelimit*

Nyquist / XLISP 2.0 - Contents | Tutorials | Examples | Reference

# *tracelimit*

Type: | - | system variable
Source: | - | xlinit.c, xldbug.c

## Syntax

*tracelimit*

## Description

The *tracelimit* system variable 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:#<Subr-BREAK...>
                              ;        Function:#<Closure-FEE...>
                              ;        Arguments:
                              ;          5
                              ;        Function:#<Closure-FOO...>
                              ;        Arguments:
                              ;          5

    (clean-up)                ; from break loop
    (setq *tracelimit* 2)     ; show only 2 entries

    (foo 5)                   ; break: **BREAK**
                              ; prints Function:#<Subr-BREAK...>
                              ;        Function:#<Closure-FEE...>
                              ;        Arguments:
                              ;          5

    (clean-up)                ; from break loop

Note: *tracenable* and *tracelimit* system variables have to do with back trace information at entry to a break loop and are not related to the trace and untrace functions.

See the *tracelimit* system variable in the XLISP 2.0 manual.

Back to Top

Nyquist / XLISP 2.0 - Contents | Tutorials | Examples | Reference