dbgmsg: Debug message displayΒΆ

$SCULPTOR/debug/dbgmsg.q

This program dynamically displays user-defined debug messages in a table. Messages are defined by means of the dbgmsg() function.

Programs that use this feature must be compiled with the declaration

!compat enable_debug = integer

where integer is non-zero.

The Sculptor keyed file $SCULPTOR/debug/dbgmsg must exist. This file is re-created whenever dbgmsg.q is run; old debug messages are therefore cleared out every time the program starts,

Start dbgmsg.q before starting the program that is to be debugged. Whenever a debug message is encountered it is added to the scrollable table in the debug program.

If Auto Refresh is On, the table is automatically scrolled down to view the most recent message. Turn it off in order to scroll back and view earlier messages, and turn it back on to see new messages.

A Print option is available to print off a list of all the messages in the table.

Multiple interacting programs can be debugged using this tool.


RELATED TOPICS

dbgmsg()

!compat enable_debug

The Sculptor debug program scdebug