Certain variables in TkCon can be modified to suit your needs.
It's easiest to do this in the resource file, but you can do it
when time the program is running (and some can be changed via the
Prefs menu). All these are part of the master
interpreter's ::tkcon namespace. The modifiable
array variables are ::tkcon::COLOR and ::tkcon::OPT. You can call
when the program is running to check its state. Here is an
explanation of certain variables you might change or use:
- ::tkcon::COLOR(bg)
-
The background color for tkcon text widgets. Defaults to the
operating system default (determined at startup).
- ::tkcon::COLOR(blink)
-
The background color of the electric brace highlighting, if on.
Defaults to yellow.
- ::tkcon::COLOR(cursor)
-
The background color for the insertion cursor in tkcon. Defaults
to black.
- ::tkcon::COLOR(disabled)
-
The foreground color for disabled menu items. Defaults to dark
grey.
- ::tkcon::COLOR(proc)
-
The foreground color of a recognized proc, if command
highlighting is on. Defaults to dark green.
- ::tkcon::COLOR(var)
-
The background color of a recognized var, if command
highlighting is on. Defaults to pink.
- ::tkcon::COLOR(prompt)
-
The foreground color of the prompt as output in the console.
Defaults to brown.
- ::tkcon::COLOR(stdin)
-
The foreground color of the stdin for the console. Defaults to
black.
- ::tkcon::COLOR(stdout)
-
The foreground color of the stdout as output in the console.
Defaults to blue.
- ::tkcon::COLOR(stderr)
-
The foreground color of stderr as output in the console.
Defaults to red.
- ::tkcon::OPT(autoload)
-
Packages to automatically load into the slave interpreter (i.e.
'Tk'). This is a list. Defaults to {} (none).
- ::tkcon::OPT(blinktime)
-
The amount of time (in millisecs) that braced sections should
blink for. Defaults to 500 (0.5 secs), must be at least 100.
- ::tkcon::OPT(blinkrange)
-
Whether to blink the entire range for electric brace matching or
to just blink the actual matching braces (respectively 1 or 0,
defaults to 1).
- ::tkcon::OPT(buffer)
-
The size of the console scroll buffer (in lines). Defaults to
512.
- ::tkcon::OPT(calcmode)
-
Whether to allow expr commands to be run at the command line
without prefixing them with expr (just a convenience).
- ::tkcon::OPT(cols)
-
Number of columns for the console to start out with. Defaults to
80.
- ::tkcon::OPT(dead)
-
What to do with dead connected interpreters. If dead is leave,
TkCon automatically exits the dead interpreter. If dead is ignore
then it remains attached waiting for the interpreter to reappear.
Otherwise TkCon will prompt you.
- ::tkcon::OPT(exec)
-
This corresponds to the -exec tkcon option
(see tkcon(1)).
- ::tkcon::OPT(font)
-
Font to use for tkcon text widgets (also specified with -font option). Defaults to the system default, or a
fixed width equivalent.
- ::tkcon::OPT(gets)
-
Controls whether tkcon will overload the gets command to work
with tkcon. The valid values are: congets (the default), which will
redirect stdin requests to the tkcon window; gets, which will pop
up a dialog to get input; and {} (empty string) which tells tkcon
not to overload gets. This value must be set at startup to alter
tkcon's behavior.
- ::tkcon::OPT(history)
-
The size of the history list to keep. Defaults to 48.
- ::tkcon::OPT(hoterrors)
-
Whether hot errors are enabled or not. When enabled, errors that
are returned to the console are marked with a link to the error
info that will pop up in an minimal editor. This requires more
memory because each error that occurs will maintain bindings for
this feature, as long as the error is in the text widget. Defaults
to on.
- ::tkcon::OPT(library)
-
The path to any tcl library directories (these are appended to
the auto_path when the after the resource file
is loaded in).
- ::tkcon::OPT(lightbrace)
-
Whether to use the brace highlighting feature or not
(respectively 1 or 0, defaults to 1).
- ::tkcon::OPT(lightcmd)
-
Whether to use the command highlighting feature or not
(respectively 1 or 0, defaults to 1).
- ::tkcon::OPT(maineval)
-
A tcl script to execute in the main interpreter after the slave
interpreter is created and the user interface is initialized.
- ::tkcon::OPT(maxlinelen)
-
A number that specifies the limit of long result lines. True
result is still captured in $_ (and 'puts $_' works). Defaults to 0
(unlimited).
- ::tkcon::OPT(maxmenu)
-
A number that specifies the maximum number of packages to show
vertically in the Interp->Packages menu
before breaking into another column. Defaults to 15.
- ::tkcon::OPT(nontcl)
-
For those who might be using non-Tcl based Tk attachments, set
this to 1. It prevents TkCon from trying to evaluate its own Tcl
code in an attached interpreter. Also see my notes for non-Tcl
based Tk interpreters.
- ::tkcon::OPT(prompt1)
-
Like tcl_prompt1, except it doesn't require
you use puts. No equivalent for tcl_prompt2 is available (it's unnecessary IMHO).
Defaults to {([file tail [pwd]]) [history nextid] % }.
- ::tkcon::OPT(rows)
-
Number of rows for the console to start out with. Defaults to
20.
- ::tkcon::OPT(scollypos)
-
Y scrollbar position. Valid values are left or right. Defaults
to right.
- ::tkcon::OPT(showmenu)
-
Show the menubar on startup (1 or 0, defaults to 1).
- ::tkcon::OPT(showmultiple)
-
Show multiple matches for path/proc/var name expansion (1 or 0,
defaults to 1).
- ::tkcon::OPT(slaveeval)
-
A tcl script to execute in each slave interpreter right after
it's created. This allows the user to have user defined info always
available in a slave.
Example:
set ::tkcon::OPT(slaveeval) {
proc foo args { puts $args }
lappend auto_path .
}
- ::tkcon::OPT(slaveexit)
-
Allows the prevention of exit in slaves from exitting the entire
application. If it is equal to exit, exit will exit as usual,
otherwise it will just close down that interpreter (and any
children). Defaults to close.
- ::tkcon::OPT(subhistory)
-
Allow history substitution to occur (0 or 1, defaults to 1). The
history list is maintained in a single interpreter per TkCon
console instance. Thus you have history which can range over a
series of attached interpreters.
