AMG: [idebug] is a command ensemble included with Tkcon that facilitates debugging. The concept of operations is that the Tkcon [edit] command is used to insert calls to [idebug] into procedures being debugged in order to create breakpoints and debug prints, then when the script is run with debugging enabled (see [idebug on]), these breakpoints and debug prints are armed and ready to trigger.
Documentation
The following text is copied from [L1 ].
The idebug command provides an interactive debugging environment for procedures via TkCon. You can place idebug break commands into your procedure to create breakpoints. It will pop up the TkCon console and put you into a "debugging" mode. The body, show & trace methods are intended for internal use only.
This procedure works for minimal debugging sessions. Comments are encouraged.
- idebug body ?level?
- Prints out the body of the command (if it is a procedure) at the specified level. level defaults to the current level.
- idebug break ?id?
- Creates a breakpoint within a procedure. This will only trigger if idebug is on and the id matches the pattern. If so, TkCon will pop to the front with the prompt changed to an idebug prompt. You are given the basic ability to observe the call stack an query/set variables or execute Tcl commands at any level. A separate history is maintained in debugging mode. To see the special commands available at the debug prompt, type ? and hit return.
- idebug {echo ?id?} ?args?
- Behaves just like echo, but only triggers when idebug is on. You can specify an optional id to further restrict triggering. If no id is specified, it defaults to the name of the command in which the call was made.
- idebug id ?id?
- Query or set the idebug id. This id is used by other idebug methods to determine if they should trigger or not. The idebug id can be a glob pattern and defaults to *.
- idebug off
- Turns idebug off.
- idebug on ?id?
- Turns idebug on. If id is specified, it sets the id to it.
- idebug {puts ?id?} args
- Behaves just like puts, but only triggers when idebug is on. You can specify an optional id to further restrict triggering. If no id is specified, it defaults to the name of the command in which the call was made.
- idebug show type ?level? ?VERBOSE?
- type must be one of vars, locals or globals. This method will output the variables/locals/globals present in a particular level. If VERBOSE is added, then it actually 'dump's out the values as well. level defaults to the level in which this method was called.
- idebug trace ?level?
- Prints out the stack trace from the specified level up to the top level. level defaults to the current level.
See also