\"  ddebug.roff from ObjectProDSP 0.1
\"  Copyright (C) 1994, Mountain Math Software, All rights reserved.
\"  Licensed for free use and distribution under version 2 of the Gnu General
\"  Public License. Please see file COPYING for details and restrictions.
\"  
\"  ObjectProDSP is a trademark of Mountain Math Software.
\"  
.H 1 "Debugging menu"

The `debug' menu controls options that are helpful in debugging your
own processing nodes. Trace outputs the name of each node just
before it is executed to the log file `dsp.messages'.
Trace is helpful if your
node crashes the program. It allows you to trace which node is causing
the problem. `heap ck' does a simple heap consistency check just before
and just after each node is executing by allocating and freeing many memory
segments. This frequently catches problems related to
an inconsistent heap and makes it easier to trace the source of the problem.
This option can significantly increase execution time.

Finally you can control how often some overflows are reported
with the `over lin' option. There are two different mechanisms
for reporting overflow. The more complex one is controlled
by this option and only works if the node makes special provisions
for it. Most conversions check for overflow and issue a warning
if an overflow occurs. The total number of warnings reported for
each network execution is limited to four. All warnings will
be written to `dsp.messages' if trace is enabled.
