Debian Codegraph @

docsrc/xlisp/xlisp-doc/reference/global-tracelimit.htm

raw
1 <html><head><title>XLISP *tracelimit*</title>
2
3 <link rel="stylesheet" type="text/css" href="reference.css">
4
5 </head>
6
7 <body>
8
9 <a href="../start.htm">Nyquist / XLISP 2.0</a>&nbsp; -&nbsp;
10 <a href="../manual/contents.htm">Contents</a> |
11 <a href="../tutorials/tutorials.htm">Tutorials</a> |
12 <a href="../examples/examples.htm">Examples</a> |
13 <a href="reference-index.htm">Reference</a>
14
15 <hr>
16
17 <h1>*tracelimit*</h1>
18
19 <hr>
20
21 <p><table cellpadding="0" cellspacing="0" style="margin-left:10px"><tbody>
22 <tr valign="top">
23 <td><nobr>Type:</nobr></td>
24 <td><nobr>&nbsp;&nbsp;-&nbsp;&nbsp;</nobr></td>
25 <td width="100%"><nobr>system variable</nobr></td>
26 </tr>
27 <tr valign="top">
28 <td><nobr>Source:</nobr></td>
29 <td><nobr>&nbsp;&nbsp;-&nbsp;&nbsp;</nobr></td>
30 <td width="100%"><nobr>xlinit.c, xldbug.c</nobr></td>
31 </tr>
32 </tbody></table></p>
33
34 <h2>Syntax</h2>
35
36 <dl>
37 <dt>&nbsp;*tracelimit*</dt>
38 </dl>
39
40 <h2>Description</h2>
41
42 <p>The *tracelimit* system variable controls the number of forms printed on
43 entry to the <nobr><a href="../manual/xlisp-man-004.htm">break
44 loop</a></nobr>. If *tracelimit* is an integer, then the integer is the
45 maximum number of forms that will be printed. If *tracelimit* is <a
46 href="nil.htm">NIL</a> or a non-integer, then all of the forms
47 will be printed. Note that <a href="global-tracenable.htm">*tracenable*</a>
48 needs to be set to a non-<a href="nil.htm">NIL</a> value to
49 enable the printing of back-trace information on entry to the <nobr><a
50 href="../manual/xlisp-man-004.htm">break loop</a></nobr>.</p>
51
52 <h2>Examples</h2>
53
54 <pre class="example">
55 (defun foo (x) (fee x)) <font color="#008844">; define FOO</font>
56 (defun fee (y) (break)) <font color="#008844">; define FEE</font>
57 (setq *tracenable* T) <font color="#008844">; enable the back trace</font>
58 (setq *tracelimit* NIL) <font color="#008844">; show all the entries</font>
59
60 (foo 5) <font color="#008844">; break: **BREAK**</font>
61 <font color="#008844">; prints Function:#&lt;Subr-BREAK...&gt;</font>
62 <font color="#008844">; Function:#&lt;Closure-FEE...&gt;</font>
63 <font color="#008844">; Arguments:</font>
64 <font color="#008844">; 5</font>
65 <font color="#008844">; Function:#&lt;Closure-FOO...&gt;</font>
66 <font color="#008844">; Arguments:</font>
67 <font color="#008844">; 5</font>
68
69 (clean-up) <font color="#008844">; from break loop</font>
70 (setq *tracelimit* 2) <font color="#008844">; show only 2 entries</font>
71
72 (foo 5) <font color="#008844">; break: **BREAK**</font>
73 <font color="#008844">; prints Function:#&lt;Subr-BREAK...&gt;</font>
74 <font color="#008844">; Function:#&lt;Closure-FEE...&gt;</font>
75 <font color="#008844">; Arguments:</font>
76 <font color="#008844">; 5</font>
77
78 (clean-up) <font color="#008844">; from break loop</font>
79 </pre>
80
81 <p><b>Note:</b> <a href="global-tracenable.htm">*tracenable*</a> and
82 *tracelimit* system variables have to do with back trace information at
83 entry to a
84 <nobr><a href="../manual/xlisp-man-004.htm">break loop</a></nobr>
85 and are not related to the
86 <a href="trace.htm">trace</a> and
87 <a href="untrace.htm">untrace</a> functions.</p>
88
89 <p>See the
90 <a href="../manual/xlisp-man-011.htm#tracelimit">*tracelimit*</a>
91 system variable in the <nobr>XLISP 2.0</nobr> manual.</p>
92
93 <p><nobr>&nbsp;&nbsp;<a href="#top">Back to Top</nobr></a></p>
94
95 <hr>
96
97 <a href="../start.htm">Nyquist / XLISP 2.0</a>&nbsp; -&nbsp;
98 <a href="../manual/contents.htm">Contents</a> |
99 <a href="../tutorials/tutorials.htm">Tutorials</a> |
100 <a href="../examples/examples.htm">Examples</a> |
101 <a href="reference-index.htm">Reference</a>
102
103 </body></html>