Changeset 33688 in project


Ignore:
Timestamp:
10/01/16 12:19:34 (5 years ago)
Author:
sjamaan
Message:

Update trace docs with new call-site and length limitations.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • wiki/eggref/4/trace

    r26066 r33688  
    101101or break-points for a procedure.
    102102
     103=== trace-length-limit
     104
     105<parameter>(trace-length-limit [LIMIT])</parameter>
     106
     107This allows you to determine the maximum length of the part of the
     108output that shows the traced procedure plus its arguments.  {{LIMIT}}
     109is a number of characters, or {{#f}} in case you don't want to limit
     110it (the default).
     111
     112=== trace-call-sites
     113
     114<parameter>(trace-call-sites [BOOL])</parameter>
     115
     116If true, show call site information in the trace, which makes it
     117easier to see where the procedure is called from.  This information is
     118taken from the trace buffer: it shows the most recent entry in that
     119buffer, so this only works reliably if the call sites aren't optimised
     120away and are compiled with {{-d2}} or higher (and {{-no-trace}} is
     121not used).
     122
     123This option defaults to {{#f}}.
     124
     125=== trace-call-site-length-limit
     126
     127<parameter>(trace-call-site-length-limit [LIMIT])</parameter>
     128
     129When {{trace-call-sites}} is {{#t}}, this allows you to determine the
     130maximum length of the call site text.  {{LIMIT}} is a number of
     131characters, or {{#f}} in case you don't want to limit it.
     132
     133This option defaults to {{100}}
    103134
    104135=== License
     
    109140=== Version history
    110141
     142; 0.9 : Added {{trace-length-limit}} and added call site tracing (thanks to Matt Welland).
     143; 0.8 : Changed {{trace-module}} to only trace exported procedures, not other objects.
     144; 0.7 : Fixed scrutinizer warnings about procedure call with wrong argument count (#842, thanks to Mario Goulart).
    111145; 0.6 : added {{trace-module}} and {{untrace-module}}
    112146; 0.4 : added {{trace/untrace}} and {{trace-verbose}}
Note: See TracChangeset for help on using the changeset viewer.