"Fossies" - the Fresh Open Source Software Archive

Member "SAOImageDS9/tkcon/docs/idebug.n.man" (13 Nov 2019, 2962 Bytes) of package /linux/misc/ds9.8.1.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 [comment {-*- tcl -*- idebug manpage}]
    2 [manpage_begin idebug n 2.5]
    3 [copyright {Jeffrey Hobbs <jeff at hobbs.org>}]
    4 [moddesc   {TkCon}]
    5 [titledesc {Interactive debugging environment in TkCon}]
    6 
    7 [description]
    8 [para]
    9 The idebug command provides an interactive debugging
   10 environment for procedures via TkCon.
   11 You can place idebug break commands into your procedure
   12 to create breakpoints.
   13 It will pop up the TkCon console and put you into a
   14 "debugging" mode.
   15 The [arg body], [arg show] & [arg trace] methods are
   16 intended for internal use only.
   17 
   18 This procedure works for minimal debugging sessions.
   19 Comments are encouraged.
   20 
   21 [list_begin definitions]
   22 
   23 [call [cmd idebug] [arg body] [opt [arg level]]]
   24 Prints out the body of the command (if it is a procedure)
   25 at the specified level.
   26 level defaults to the current level.
   27 
   28 [call [cmd idebug] [arg break] [opt [arg id]]]
   29 Creates a breakpoint within a procedure.
   30 This will only trigger if idebug is on and the [arg id] matches the pattern.
   31 If so, TkCon will pop to the front with the prompt changed
   32 to an idebug prompt.
   33 You are given the basic ability to observe the call stack
   34 an query/set variables or execute Tcl commands at any level.
   35 A separate history is maintained in debugging mode.
   36 To see the special commands available at the debug prompt,
   37 type ? and hit return.
   38 
   39 [call [cmd idebug] \{[arg "[arg echo] [opt [arg id]]"]\} [opt [arg args]]]
   40 Behaves just like [cmd echo], but only triggers when idebug is on.
   41 You can specify an optional [arg id] to further restrict triggering.
   42 If no id is specified, it defaults to the name of the command
   43 in which the call was made.
   44 
   45 [call [cmd idebug] [arg id] [opt [arg id]]]
   46 Query or set the idebug id.
   47 This id is used by other idebug methods to determine if
   48 they should trigger or not.
   49 The idebug id can be a glob pattern and defaults to *.
   50 
   51 [call [cmd idebug] [arg off]]
   52 Turns idebug off.
   53 
   54 [call [cmd idebug] [arg on] [opt [arg id]]]
   55 Turns idebug on.
   56 If [arg id] is specified, it sets the id to it.
   57 
   58 [call [cmd idebug] \{[arg "[arg puts] [opt [arg id]]"]\} [arg args]]
   59 Behaves just like [cmd puts], but only triggers when idebug is on.
   60 You can specify an optional [arg id] to further restrict triggering.
   61 If no id is specified, it defaults to the name of the
   62 command in which the call was made.
   63 
   64 [call [cmd idebug] [arg show] [arg type] [opt [arg level]] [opt [arg VERBOSE]]]
   65 type must be one of vars, locals or globals.
   66 This method will output the variables/locals/globals present
   67 in a particular level.
   68 If [arg VERBOSE] is added, then it actually [cmd dump]s out the values as well.
   69 level defaults to the level in which this method was called.
   70 
   71 [call [cmd idebug] [arg trace] [opt [arg level]]]
   72 Prints out the stack trace from the specified level up to the top level.
   73 level defaults to the current level.
   74 
   75 [list_end]
   76 
   77 [see_also [cmd tkcon](1)]
   78 [see_also [cmd tkconrc](5) [cmd tkcon](n) [cmd dump](n)]
   79 [see_also [cmd observe](n)]
   80 [keywords Tk console debug]
   81 
   82 [manpage_end]
   83