| Wiki Markup |
|---|
{alias:cmdtrace}
h2. Name
*cmdtrace* — Control tcl command tracing
h2. Syntax
{panel:|borderStyle=solid|borderWidth=1|bgColor=#FFFFAA}
*cmdtrace on* \[_level_]
*cmdtrace off*
*cmdtrace maxblockcount* _count_
{panel}
h2. Description
The *cmdtrace* turns on or off tcl command tracing. Traced commands are visible in Geocaps command log window. Enabling command tracing will reduce Tcl performance somewhat, although built-in C++ algorithms are not affected. Don't trace more levels than you need if this is a concern.
You may wish to trace commands only at a given level. A level refers to the level of nested scope in which a command is executed. A toplevel command, executed outside any proc and namespaces, belong to level 1. Commands called from a level 1 command will have level 2, etc.
h2. Arguments
*on* _level_
{indent}Enables command tracing. The default level is 0, meaning all levels are traced. If you specify a level only commands lower or equal to that level will be traced.
{indent}
*off*
{indent}Disables command tracing.{indent}
*maxblockcount* _count_
{indent}How many lines to keep in the command log window. The default value is 2000.{indent}
h2. Examples
The following example show commands at level 1 and level 2.
h3. Commands at different levels
{noformat:|borderWidth=1|bgColor=#eeeeee} |
Name
cmdtrace — Control tcl command tracing
Syntax
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
cmdtrace on [level] |
Description
The cmdtrace turns on or off tcl command tracing. Traced commands are visible in Geocaps command log window. Enabling command tracing will reduce Tcl performance somewhat, although built-in C++ algorithms are not affected. Don't trace more levels than you need if this is a concern.
You may wish to trace commands only at a given level. A level refers to the level of nested scope in which a command is executed. A toplevel command, executed outside any proc and namespaces, belong to level 1. Commands called from a level 1 command will have level 2, etc.
Arguments
on level
off
maxblockcount count
Examples
The following example show commands at level 1 and level 2.
Commands at different levels
| No Format | ||||
|---|---|---|---|---|
| ||||
namespace eval myspace {
variable x 1
}
proc myproc {} {
puts hello
}
puts "I'm a toplevel command"
myproc
{noformat}
|
Executing
...
the
...
previous
...
example
...
yields
...
the
...
following
...
output
...
in
...
Geocaps
...
command
...
log.
...
The
...
left-most
...
number
...
indicates
...
the
...
level.
...
Note
...
that
...
proc
...
and
...
namespace
...
are
...
commands
...
like
...
any
...
other
...
in
...
Tcl.
...
| No Format | ||||
|---|---|---|---|---|
| ||||
1:namespace eval myspace {
variable x 1
}
2:variable x 1
1:proc myproc {} {
puts hello
}
1:puts "I'm a toplevel command"
1:myproc
2:puts hello
{noformat}
{pagebreak} |