Major Section: TRACE
Example: (trace$ foo bar)where theGeneral Form: (trace$ fn1 fn2 ... fnk)
fni
are defined or even constrained functions.
see untrace$ for how to undo the effect of trace$
.
Basically, trace$
calls on the underlying Lisp to trace the specified
functions as well as their executable-counterpart
s. However, for GCL
and Allegro CL the underlying Lisp trace routines are modified before an
image is saved in order to hide the ACL2 world and other large data
structures and provide slightly prettier output.
Recursive calls of executable-counterpart functions will not generally be traced.
Output from trace$
normally goes to the screen, i.e.,
standard-co
. But it can be redirected to a file;
see open-trace-file.
Also see wet (``with-error-trace
'') for a different way that ACL2
takes advantage of the underlying Lisp, namely to provide a backtrace when
there is an error.
Note that from a logical perspective all trace printing is a fiction. For a
related fiction, see cw. Trace$
returns nil