


observe(n)                    TkCon                    observe(n)


______________________________________________________________________________

NAME
       observe - Runtime debugging output in TkCon

SYNOPSIS
       observe command cmdname ?maxlevel?

       observe cdelete cmdname

       observe cinfo cmdname

       observe variable varname operation ?args?

       observe vdelete varname operation

       observe vinfo varname

_________________________________________________________________

DESCRIPTION
       This  command  provides runtime debugging output for variables and com-
       mands without the need to edit your code.  For variables, the  underly-
       ing  mechanism  uses  trace and dump var.  For commands, it renames the
       observed procedure and uses  a  special  wrapper  procedure.   WARNING:
       using  this  procedure  after  checkpointing state will result in major
       problems if you clean state because the renamed (true) commands will be
       lost.

       This procedure is experimental.  Comments are encouraged.

       observe command cmdname ?maxlevel?
              This will create a wrapper command which prints out (using dump)
              the call stack to the console.  maxlevel represents the  maximum
              number  of  levels  of  the  call  stack  which  will be printed
              (defaults to 4).

       observe cdelete cmdname
              Removes the wrapper around an observed command.

       observe cinfo cmdname
              Prints out useless info.

       observe variable varname operation ?args?
              Currently a wrapper around trace that uses dump to print out the
              value  of the named variable whenever the specified operation on
              that variable occurs (must be read, write or unset).

       observe vdelete varname operation
              Deletes the trace wrapper around the named variable.

       observe vinfo varname
              Prints out trace info about the named variable.




observe.n                      2.5                              1





observe(n)                    TkCon                    observe(n)


SEE ALSO
       dump(n), idebug(n), tkcon(1), tkcon(n), tkconrc(5)

KEYWORDS
       Tk, console, debug

COPYRIGHT
       Copyright (c) Jeffrey Hobbs <jeff at hobbs.org>

















































observe.n                      2.5                              2


