(index ("trace" 0) ("untrace" 344) ("trace/untrace" 622) ("trace-module" 752) ("untrace-module" 1023) ("break" 1167) ("unbreak" 1779) ("continue" 1938) ("c" 1938) ("trace-output-port" 2187) ("trace-verbose" 2398) ("trace-length-limit" 2576) ("trace-call-sites" 2899) ("trace-call-site-length-limit" 3391))
(def (sig (procedure "(trace [PROCEDURE ...])" (id trace))) (p "Modifies the given procedures by printing some information on entry and exit. When given no arguments, " (tt "(trace)") " lists all currently traced procedures.") (p "Note that " (tt "PROCEDURE") " may be any procedure and doesn't necessarily have to be a toplevel definition."))
(def (sig (procedure "(untrace [PROCEDURE ...])" (id untrace))) (p "Removes tracing from " (tt "PROCEDURE ...") ", which should previously have been traced with " (tt "trace") ". When given no arguments, " (tt "(untrace)") " removes untraces all currently traced procedures."))
(def (sig (procedure "(trace/untrace PROCEDURE ...)" (id trace/untrace))) (p "Toggles tracing on/off for the given procedures."))
(def (sig (procedure "(trace-module MODULENAME ...)" (id trace-module))) (p "Traces all exported toplevel procedures of the modules with the names given in " (tt "MODULENAME ...") ". The module must already be loaded. Note that core-library modules can not be traced."))
(def (sig (procedure "(untrace-module MODULENAME ...)" (id untrace-module))) (p "Untraces all currently traced exports of the given modules."))
(def (sig (procedure "(break [PROCEDURE ...])" (id break))) (p "Modifies the given procedures to signal a condition on entry. The condition is of the kinds " (tt "exn") " and " (tt "breakpoint") " and will terminate execution unless caught. In the interpreter, the condition is accessible on the toplevel using the " (tt ",exn") " command. Use " (tt "(continue)") " to continue execution. If no arguments are given, " (tt "(break)") " lists all procedures that currently have breakpoints set.") (p "Note that " (tt "PROCEDURE") " may be any procedure and doesn't necessarily have to be a toplevel definition."))
(def (sig (procedure "(unbreak [PROCEDURE ...])" (id unbreak))) (p "Removes breakpoints from the given procedures (or from all, if no arguments are given)."))
(def (sig (procedure "(continue [CONDITION])" (id continue)) (procedure "(c [CONDITION])" (id c))) (p "Continues execution from the breakpoint that signalled " (tt "CONDITION") ", or from the last breakpoint if " (tt "CONDITION") " is not given."))
(def (sig (parameter "(trace-output-port [PORT])" (id trace-output-port))) (p "Specifies the port to which tracing information should be written and defaults to the value of " (tt "(current-output-port)") "."))
(def (sig (parameter "(trace-verbose [BOOL])" (id trace-verbose))) (p "If true (the default) show a message when enabling or disabling trace- or break-points for a procedure."))
(def (sig (parameter "(trace-length-limit [LIMIT])" (id trace-length-limit))) (p "This allows you to determine the maximum length of the part of the output that shows the traced procedure plus its arguments.  " (tt "LIMIT") " is a number of characters, or " (tt "#f") " in case you don't want to limit it (the default)."))
(def (sig (parameter "(trace-call-sites [BOOL])" (id trace-call-sites))) (p "If true, show call site information in the trace, which makes it easier to see where the procedure is called from.  This information is taken from the trace buffer: it shows the most recent entry in that buffer, so this only works reliably if the call sites aren't optimised away and are compiled with " (tt "-d2") " or higher (and " (tt "-no-trace") " is not used).") (p "This option defaults to " (tt "#f") "."))
(def (sig (parameter "(trace-call-site-length-limit [LIMIT])" (id trace-call-site-length-limit))) (p "When " (tt "trace-call-sites") " is " (tt "#t") ", this allows you to determine the maximum length of the call site text.  " (tt "LIMIT") " is a number of characters, or " (tt "#f") " in case you don't want to limit it.") (p "This option defaults to " (tt "100")))
