From f21a0abfcd3d8fa8f0e1683c5eee438649bffee4 Mon Sep 17 00:00:00 2001 From: Jeff Hobbs Date: Fri, 4 May 2001 23:14:46 +0000 Subject: [PATCH] * docs/style.css: new file for html files to use. * README.txt: * index.html: * doc/*: updated for 2.1 release. --- ChangeLog | 11 +++ README.txt | 17 ++--- docs/bindings.html | 64 +++++++++++----- docs/dump.html | 72 ++++++++++++------ docs/idebug.html | 78 +++++++++++++------- docs/index.html | 64 +++++++++++----- docs/license.terms | 3 - docs/limits.html | 44 ++++++++--- docs/nontcl.html | 46 +++++++++--- docs/observe.html | 76 ++++++++++++------- docs/plugin.html | 65 +++++++++++----- docs/procs.html | 64 +++++++++++----- docs/purpose.html | 52 +++++++++---- docs/start.html | 180 ++++++++++++++++++++++++++------------------- docs/style.css | 76 +++++++++++++++++++ docs/tkcon.html | 112 +++++++++++++++++----------- docs/todo.html | 43 ++++++++--- index.html | 36 +++++---- 18 files changed, 755 insertions(+), 348 deletions(-) create mode 100644 docs/style.css diff --git a/ChangeLog b/ChangeLog index 64f9def..367774f 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,14 @@ +2001-05-04 Jeff Hobbs + + * docs/style.css: new file for html files to use. + * README.txt: + * index.html: + * doc/*: updated for 2.1 release. + + * tkcon.tcl: allowed 'tkcon font ...' and 'tkcon buffer ...' to + work before the main console have been created. + Changed "TkCon" -> "tkcon", updated for new release. + 2001-03-28 Jeff Hobbs * tkcon.tcl (::tkcon::Init): added safe interp check around 'cd' diff --git a/README.txt b/README.txt index 7f076ee..2bd4109 100644 --- a/README.txt +++ b/README.txt @@ -1,15 +1,14 @@ WHAT: Enhanced Tk Console for all Tk platforms WHERE: http://www.purl.org/net/hobbs/tcl/script/tkcon/ - http://www.hobbs.wservice.com/tcl/script/tkcon/ - http://www.neosoft.com/tcl/ (somewhere in the devel area) + http://tkcon.sourceforge.net/ -REQUIREMENTS: Tcl 7.6 / Tk 4.2 (as least the stable versions) - Tested through Tcl/Tk8.4. - TkCon is all Tcl/Tk code, no compiling required +REQUIREMENTS: Tcl/Tk 8.0+ + Tested through Tcl/Tk 8.4. + tkcon is all Tcl/Tk code, no compiling required -TkCon is a replacement for the standard console that comes with Tk (on -Windows/Mac, but also works on Unix). TkCon provides many more features +tkcon is a replacement for the standard console that comes with Tk (on +Windows/Mac, but also works on Unix). tkcon provides many more features than the standard console and works on all platforms where Tcl/Tk is available. It is meant primarily to aid one when working with the little details inside tcl and tk and to give Unix users the GUI console provided @@ -30,11 +29,11 @@ FEATURES: (including non-tcl ones) Works on all Tk platforms -CONTACT: Jeffrey Hobbs, jeff.hobbs at acm.org +CONTACT: Jeffrey Hobbs, jeff.hobbs at acm.org or jeff at hobbs.org GETTING STARTED: -TkCon is a single drop-in file. On Windows, I place this on the desktop +tkcon is a single drop-in file. On Windows, I place this on the desktop and double-click on it instead of wish/tclsh. On Unix, I place it in a known bin directory and run this instead of wish. I don't have a Mac... diff --git a/docs/bindings.html b/docs/bindings.html index 9f168b0..93b4453 100755 --- a/docs/bindings.html +++ b/docs/bindings.html @@ -1,38 +1,60 @@ -TkCon: Special Bindings +tkcon: Special Bindings + -

TkCon: Special Bindings

- +
+ + - - - - - - - - + +
TkCon DocsPurpose & FeaturesLimitationsTo Do
ChangesLicense TermsUsing TkCon with other Tk Languagestkcon: Special Bindings + +SourceForge Logo +
+ - +
+ + - - - + + + + + + + + +
Getting StartedSpecial BindingsProceduresDocumentationPurpose & FeaturesLimitationsTo DoLicense
Online Demo +(requires Tk plugin)Using TkCon with other Tk Languages
+ +
+ + - - - - + + + + + + + + + +
dumptkconidebugobserveGetting StartedSpecial BindingsProceduresScreenshot
dumptkconidebugobserve
- + +
+

Most of the bindings are the same as for the Text widget. Some have been modified to make sure that the integrity of the console is maintained. @@ -121,6 +143,8 @@ entire current command line. For the double quote, if there is no proper match then it just blinks the current double quote character. It does properly recognize most escaping (except escaped escapes), but does not look for commenting (why would you interactively put comments in?). +

+

© diff --git a/docs/dump.html b/docs/dump.html index 696a0f1..c530a6d 100755 --- a/docs/dump.html +++ b/docs/dump.html @@ -1,38 +1,60 @@ -TkCon: dump procedure +tkcon: dump procedure + -

TkCon: dump procedure

- +
+ + - - - - - - - - + +
TkCon DocsPurpose & FeaturesLimitationsTo Do
ChangesLicense TermsUsing TkCon with other Tk Languagestkcon: dump procedure + +SourceForge Logo +
+ - +
+ + - - - + + + + + + + + +
Getting StartedSpecial BindingsProceduresDocumentationPurpose & FeaturesLimitationsTo DoLicense
Online Demo +(requires Tk plugin)Using TkCon with other Tk Languages
+ +
+ + - - - - + + + + + + + + + +
dumptkconidebugobserveGetting StartedSpecial BindingsProceduresScreenshot
dumptkconidebugobserve
- + +
+

The dump command provides a way for the user to spit out state information about the interpreter in a Tcl readable (and human @@ -50,24 +72,26 @@ interpreted as appropriate for the method. The various methods are:

-
dump command args +
dump command args
Outputs one or more commands. -
dump procedure args +
dump procedure args
Outputs one or more procs in sourceable form. -
dump variable args +
dump variable args
Outputs the values of variables in sourceable form. Recognizes nested arrays. The -filter pattern is used as to filter array element names and is interepreted as a glob pattern (defaults to {*}). It is passed down for nested arrays. -
dump widget args +
dump widget args
Outputs one or more widgets by giving their configuration options. The -filter pattern is used as to filter the config options and is interpreted as a case insensitive regexp pattern (defaults to {.*})
+
+

© diff --git a/docs/idebug.html b/docs/idebug.html index e557910..540b7ae 100755 --- a/docs/idebug.html +++ b/docs/idebug.html @@ -1,38 +1,60 @@ -TkCon: idebug procedure +tkcon: idebug procedure + -

TkCon: idebug procedure

- +
+ + - - - - - - - - + +
TkCon DocsPurpose & FeaturesLimitationsTo Do
ChangesLicense TermsUsing TkCon with other Tk Languagestkcon: idebug procedure + +SourceForge Logo +
+ - +
+ + - - - + + + + + + + + +
Getting StartedSpecial BindingsProceduresDocumentationPurpose & FeaturesLimitationsTo DoLicense
Online Demo +(requires Tk plugin)Using TkCon with other Tk Languages
+ +
+ + - - - - + + + + + + + + + +
dumptkconidebugobserveGetting StartedSpecial BindingsProceduresScreenshot
dumptkconidebugobserve
- + +
+

The idebug command provides an interactive debugging environment for procedures via TkCon. You can place idebug break commands @@ -45,11 +67,11 @@ This procedure is experimental (to say the least). Comments are encouraged.

-
idebug body ?level? +
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? +
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 @@ -62,15 +84,15 @@ 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? +
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 +
idebug off
Turns idebug off. -
idebug on ?id? +
idebug on ?id?
Turns idebug on. If id is specified, it sets the id to it.
idebug {puts ?id?} args @@ -79,17 +101,19 @@ 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? +
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? +
idebug trace ?level?
Prints out the stack trace from the specified level up to the top level. level defaults to the current level.
+
+

© diff --git a/docs/index.html b/docs/index.html index f14763f..1c719e0 100755 --- a/docs/index.html +++ b/docs/index.html @@ -1,24 +1,44 @@ -TkCon: Documentation - +tkcon: Documentation + -

TkCon: Documentation (March 1999)

- +
+ + - - - - + + - - - +
TkCon DocsPurpose & FeaturesLimitationsTo Dotkcon Documentation (May 2001) + +SourceForge Logo +
ChangesLicense TermsUsing TkCon with other Tk Languages
+ + +
+ + + + + + + + + + +
DocumentationPurpose & FeaturesLimitationsTo DoLicense
Online Demo +(requires Tk plugin)Using TkCon with other Tk Languages
+ + +
+

Release Archives

@@ -29,22 +49,26 @@ features AND limitations of TkCon. I'm always open to suggestions for improvement. Send them to my suggestion box.

+

+
- +
- - - + + + - - - - + + + +
Getting Started:
-TkCon resource file and command line options
Special BindingsNew Procedures in TkConGetting Started +Special Bindingstkcon ProceduresScreenshot
dump proceduretkcon procedureidebug procedureobserve proceduredump proctkcon procidebug procobserve proc
+
+
© Jeffrey Hobbs
diff --git a/docs/license.terms b/docs/license.terms index 6928ccb..f8cf814 100755 --- a/docs/license.terms +++ b/docs/license.terms @@ -1,8 +1,5 @@ * COPYRIGHT AND LICENSE TERMS * -(This file blatantly stolen from Tcl/Tk license and adapted - thus assume -it falls under similar license terms). - This software is copyrighted by Jeffrey Hobbs . The following terms apply to all files associated with the software unless explicitly disclaimed in individual files. diff --git a/docs/limits.html b/docs/limits.html index 8c53468..5b960a0 100755 --- a/docs/limits.html +++ b/docs/limits.html @@ -1,27 +1,47 @@ -TkCon: Limitations +tkcon: Limitations + -

TkCon: Limitations

- +
+ + - - - - + + - - - +
TkCon DocsPurpose & FeaturesLimitationsTo Dotkcon: Limitations + +SourceForge Logo +
ChangesLicense TermsUsing TkCon with other Tk Languages
+ + +
+ + + + + + + + + + +
DocumentationPurpose & FeaturesLimitationsTo DoLicense
Online Demo +(requires Tk plugin)Using TkCon with other Tk Languages
+ +
+

Limitations:

-TkCon requires Tk4.2+. Since TkCon is meant to behave like the original Tk +TkCon requires Tk8.0+. Since TkCon is meant to behave like the original Tk console, it does not separate itself from the environment (it does not use send to function, except when attached to foreign Tk interpreters). This means that it can be can be altered or destroyed by any sourced @@ -46,6 +66,8 @@ When connecting to non-Tcl Tk interpreters (ie - PerlTk, SchemeTk, ...), you must use the syntax of the target environment. See my notes on using other Tk-embedded languages for more info. +
+

© diff --git a/docs/nontcl.html b/docs/nontcl.html index 47b3e11..dbc8fab 100755 --- a/docs/nontcl.html +++ b/docs/nontcl.html @@ -1,30 +1,50 @@ -TkCon for Non-Tcl Users +tkcon for Non-Tcl Users + -

TkCon for Non-Tcl Users

- +
+ + - - - - + + - - - +
TkCon DocsPurpose & FeaturesLimitationsTo Dotkcon: Non-Tcl Usage + +SourceForge Logo +
ChangesLicense TermsUsing TkCon with other Tk Languages
+ + +
+ + + + + + + + + + +
DocumentationPurpose & FeaturesLimitationsTo DoLicense
Online Demo +(requires Tk plugin)Using TkCon with other Tk Languages
+ +
+
This document is for those users who are trying to use TkCon with a non-Tcl based Tk language (ie - SchemeTk, PerlTk, PythonTk...).

-TkCon requires Tcl 7.6 / Tk 4.2 to -run (better with 8.0+). However, it can attach to any language with Tk4+ +TkCon requires Tcl/Tk 8.0+ to +run. However, it can attach to any language with Tk4+ embedded into it with the use of the Tk 'send' command. I have been able to succesfully talk to SchemeTk-3.0 and Perl/Tk. When using TkCon attached to these interpreters, you must remember to talk to the connected @@ -45,6 +65,8 @@ before it will work. (lusol@Turkey.CC.Lehigh.EDU) contributed a companion Perl/Tk program that does the trick with some extras. +

+

© diff --git a/docs/observe.html b/docs/observe.html index 09defbc..4345df1 100755 --- a/docs/observe.html +++ b/docs/observe.html @@ -1,38 +1,60 @@ -TkCon: observe procedure +tkcon: observe procedure + -

TkCon: observe procedure

- +
+ + - - - - - - - - + +
TkCon DocsPurpose & FeaturesLimitationsTo Do
ChangesLicense TermsUsing TkCon with other Tk Languagestkcon: observe procedure + +SourceForge Logo +
+ - +
+ + - - - + + + + + + + + +
Getting StartedSpecial BindingsProceduresDocumentationPurpose & FeaturesLimitationsTo DoLicense
Online Demo +(requires Tk plugin)Using TkCon with other Tk Languages
+ +
+ + - - - - + + + + + + + + + +
dumptkconidebugobserveGetting StartedSpecial BindingsProceduresScreenshot
dumptkconidebugobserve
- + +
+

This command provides runtime debugging output for variables and commands without the need to edit your code. For variables, the underlying mechanism @@ -47,30 +69,32 @@ This procedure is experimental. Comments are encouraged.

-
observe command cmdname ?maxlevel? +
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 +
observe cdelete cmdname
Removes the wrapper around an observed command. -
observe cinfo cmdname +
observe cinfo cmdname
Prints out useless info. -
observe variable varname operation ?args? +
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 +
observe vdelete varname operation
Deletes the trace wrapper around the named variable. -
observe vinfo varname +
observe vinfo varname
Prints out trace info about the named variable.
+
+

© diff --git a/docs/plugin.html b/docs/plugin.html index 100191c..52cafed 100755 --- a/docs/plugin.html +++ b/docs/plugin.html @@ -1,29 +1,59 @@ -TkCon: Tcl Plugin Stripped Demo +tkcon: Tcl Plugin Stripped Demo + -

TkCon: Tcl Plugin Stripped Demo

-
-TkCon Distribution -

+
+ + + + + + +
tkcon Documentation (May 2001) + +SourceForge Logo +
+ -This is the full TkCon script when run inside the plugin. It feels like a -stripped down version of TkCon, but the only limitations are those +
+ + + + + + + + + + + + +
DocumentationPurpose & FeaturesLimitationsTo DoLicense
Online Demo +(requires Tk plugin)Using TkCon with other Tk Languages
+ + +
+
+

+This is the full tkcon script when run inside the plugin. It feels like a +stripped down version of tkcon, but the only limitations are those established by the plugin. You can test the basic console features and get a feel for the mutli-color output. Below the demo are some ideas to try -out. v2 of the plugin is distributed with a megawidget version of TkCon for -debugging tclets. The demo below uses rev 1.20 of tkcon in CVS -(this correlates to v2.1alpha of tkcon). +out. v2 of the plugin is distributed with a megawidget version of tkcon for +debugging tclets. The demo below uses rev 1.28 of tkcon in CVS +(this correlates to v2.1 of tkcon).

- +

Have a look at some of the features: (culled from the -TkCon documentation) +tkcon documentation)
  • Variable / Path / Procedure Name Expansion. Type in set tc at the prompt. Hit <Control-Shift-V>. @@ -55,13 +85,12 @@ windows and TkCon. The default keys are <Control-x>/<Control-c>/<Control-v>.
+
+
-


- -
-Contact jeff.hobbs@acm.org -with questions or updated info. -
+
+
© +Jeffrey Hobbs
diff --git a/docs/procs.html b/docs/procs.html index 2a85eb1..23bd641 100755 --- a/docs/procs.html +++ b/docs/procs.html @@ -1,38 +1,60 @@ -TkCon: Procedures +tkcon: Procedures + -

TkCon: Procedures

- +
+ + - - - - - - - - + +
TkCon DocsPurpose & FeaturesLimitationsTo Do
ChangesLicense TermsUsing TkCon with other Tk Languagestkcon: Procedures + +SourceForge Logo +
+ - +
+ + - - - + + + + + + + + +
Getting StartedSpecial BindingsProceduresDocumentationPurpose & FeaturesLimitationsTo DoLicense
Online Demo +(requires Tk plugin)Using TkCon with other Tk Languages
+ +
+ + - - - - + + + + + + + + + +
dumptkconidebugobserveGetting StartedSpecial BindingsProceduresScreenshot
dumptkconidebugobserve
- + +
+

There are several new procedures introduced in TkCon to improve productivity and/or account for lost functionality in the Tcl environment @@ -134,6 +156,8 @@ found. There are several procedures that I use as helpers that some may find helpful in there coding (ie - expanding pathnames). Feel free to lift them from the code (but do assign proper attribution). +

+

© diff --git a/docs/purpose.html b/docs/purpose.html index a2b0c6c..c5348f7 100755 --- a/docs/purpose.html +++ b/docs/purpose.html @@ -1,29 +1,50 @@ -TkCon: Purpose & Features +tkcon: Purpose & Features + -

TkCon: Purpose & Features

- +
+ + - - - - + + - - - +
TkCon DocsPurpose & FeaturesLimitationsTo Dotkcon: Purpose & Features + +SourceForge Logo +
ChangesLicense TermsUsing TkCon with other Tk Languages
+ + +
+ + + + + + + + + + +
DocumentationPurpose & FeaturesLimitationsTo DoLicense
Online Demo +(requires Tk plugin)Using TkCon with other Tk Languages
+ + +
+

Purpose:

-TkCon is a replacement for the standard console that comes with Tk (on +tkcon is a replacement for the standard console that comes with Tk (on Windows/Mac, but also works on Unix). The console itself provides -many more features than the standard console. TkCon works on all +many more features than the standard console. tkcon works on all platforms where Tcl/Tk is available. It is meant primarily to aid one when working with the little details inside tcl and tk, giving Unix users the GUI console provided by default in the Mac and Windows Tk. It's also not a bad @@ -31,12 +52,12 @@ replacement for the default MS-DOS shell (although it needs lots of fine tuning).

See Limitations for a good idea of what -TkCon can't do for you. +tkcon can't do for you.

Features:

Just in case you don't run across them while playing, here are some of the -extras in TkCon: +extras in tkcon:
  • Command history
  • Path (Unix style) / Proc / Variable name expansion @@ -49,11 +70,14 @@ extras in TkCon:
  • Cut / Copy / Paste between windows
  • Communication between consoles and other Tk interpreters (including non-tcl ones) +
  • Hot Errors (click on error result to see stack trace)
  • Works on all Tk platforms
Read the documentation for how to take advantage of these features. +
+

© diff --git a/docs/start.html b/docs/start.html index 957a85e..2302179 100755 --- a/docs/start.html +++ b/docs/start.html @@ -1,38 +1,60 @@ -TkCon: Getting Started +tkcon: Getting Started + -

TkCon: Getting Started

- +
+ + - - - - - - - - + +
TkCon DocsPurpose & FeaturesLimitationsTo Do
ChangesLicense TermsUsing TkCon with other Tk Languagestkcon: Getting Started + +SourceForge Logo +
+ - +
+ + + + + + + + + + + + +
DocumentationPurpose & FeaturesLimitationsTo DoLicense
Online Demo +(requires Tk plugin)Using TkCon with other Tk Languages
+ +
+ + - - - + + + + - - - - + + + +
Getting StartedSpecial BindingsProceduresGetting StartedSpecial BindingsProceduresScreenshot
dumptkconidebugobservedumptkconidebugobserve
- + +
+

Resource File:

TkCon will search for a resource file in "$env(HOME)/.tkconrc" @@ -63,9 +85,10 @@ be argv/argc (with -- prepended). This carries over for any further consoles. This is meant only for wrapping TkCon around programs that require their own arguments. -
-color,* color +
-color-<color> color
Sets the requested color type to the specified color for tkcon. -See the Variables section for the various color,* types. +See the Variables section for the recognized +<color> names.
-eval (also -main or -e)
A tcl script to eval in each main interpreter. This is evaluated @@ -125,146 +148,151 @@ a white background for tkcon's text widgets.

Variables:

-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 global array variable TKCON. You can -'tkcon set TKCON' when the program is running to check its -state. Here is an explanation of certain variables you might change or use: +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 'tkcon set +::tkcon::COLOR' when the program is running to check its state. +Here is an explanation of certain variables you might change or use:
-
color,bg +
::tkcon::COLOR(bg)
The background color for tkcon text widgets. Defaults to the operating system default (determined at startup). -
color,blink +
::tkcon::COLOR(blink)
The background color of the electric brace highlighting, if on. Defaults to yellow. -
color,cursor +
::tkcon::COLOR(cursor)
The background color for the insertion cursor in tkcon. Defaults to black. -
color,disabled +
::tkcon::COLOR(disabled)
The foreground color for disabled menu items. Defaults to dark grey. -
color,proc +
::tkcon::COLOR(proc)
The foreground color of a recognized proc, if command highlighting is on. Defaults to dark green. -
color,var +
::tkcon::COLOR(var)
The background color of a recognized var, if command highlighting is on. Defaults to pink. -
color,prompt +
::tkcon::COLOR(prompt)
The foreground color of the prompt as output in the console. Defaults to brown. -
color,stdin +
::tkcon::COLOR(stdin)
The foreground color of the stdin for the console. Defaults to black. -
color,stdout +
::tkcon::COLOR(stdout)
The foreground color of the stdout as output in the console. Defaults to blue. -
color,stderr +
::tkcon::COLOR(stderr)
The foreground color of stderr as output in the console. Defaults to red.

-

autoload +
::tkcon::OPT(autoload)
Packages to automatically load into the slave interpreter (ie - 'Tk'). This is a list. Defaults to {} (none). -
blinktime +
::tkcon::OPT(blinktime)
The amount of time (in millisecs) that braced sections should blink for. Defaults to 500 (.5 secs), must be at least 100. -
blinkrange +
::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). -
buffer +
::tkcon::OPT(buffer)
The size of the console scroll buffer (in lines). Defaults to 512. -
calcmode +
::tkcon::OPT(calcmode)
Whether to allow expr commands to be run at the command line without prefixing them with expr (just a convenience). -
cols +
::tkcon::OPT(cols)
Number of columns for the console to start out with. Defaults to 80. -
dead +
::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. -
font +
::tkcon::OPT(exec) +
This corresponds to the -exec option above + +
::tkcon::OPT(font)
Font to use for tkcon text widgets (also specified with -font). Defaults to the system default, or a fixed width equivalent. -
history +
::tkcon::OPT(history)
The size of the history list to keep. Defaults to 48. -
hoterrors +
::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. -
library +
::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). -
lightbrace +
::tkcon::OPT(lightbrace)
Whether to use the brace highlighting feature or not (respectively 1 or 0, defaults to 1). -
lightcmd +
::tkcon::OPT(lightcmd)
Whether to use the command highlighting feature or not (respectively 1 or 0, defaults to 1). -
maineval +
::tkcon::OPT(maineval)
A tcl script to execute in the main interpreter after the slave interpreter is created and the user interface is initialized. -
nontcl +
::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. -
prompt1 +
::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] % }. -
rcfile -
Name of the resource file. $env(HOME) is prepended to -this. Defaults to .tkconrc on Unix and tkcon.cfg -otherwise. - -
rows +
::tkcon::OPT(rows)
Number of rows for the console to start out with. Defaults to 20. -
scollypos +
::tkcon::OPT(scollypos)
Y scrollbar position. Valid values are left or right. Defaults to left. -
showmenu +
::tkcon::OPT(showmenu)
Show the menubar on startup (1 or 0, defaults to 1). -
showmultiple +
::tkcon::OPT(showmultiple)
Show multiple matches for path/proc/var name expansion (1 or 0, defaults to 1). -
slaveeval +
::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: @@ -273,13 +301,13 @@ in a slave. Example: lappend auto_path . } -
slaveexit +
::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. -
subhistory +
::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 @@ -289,21 +317,25 @@ interpreters.

An example TkCon resource file might look like: - -

######################################################
+
+
######################################################
 ## My TkCon Resource File
  
-# Use 'fixed' as my default font (only valid on unix)
-set TKCON(maineval) {
-    set tkcon font fixed
-}
+# Use a fixed default font
+#tkcon font fixed; # valid on unix
+#tkcon font systemfixed; # valid on win
+tkcon font Courier 12; # valid everywhere
+
 # Keep 50 commands in history
-set TKCON(history) 50
+set ::tkcon::OPT(history) 50
+
 # Use a pink prompt
-set TKCON(color,prompt) pink
+set ::tkcon::COLOR(prompt) pink
 ######################################################

+

+

© diff --git a/docs/style.css b/docs/style.css new file mode 100644 index 0000000..d9ea817 --- /dev/null +++ b/docs/style.css @@ -0,0 +1,76 @@ + diff --git a/docs/tkcon.html b/docs/tkcon.html index 1da4e8c..0f00250 100755 --- a/docs/tkcon.html +++ b/docs/tkcon.html @@ -1,138 +1,162 @@ -TkCon: tkcon procedure +tkcon: tkcon procedure + -

TkCon: tkcon procedure

- +
+ + - - - - - - - - + +
TkCon DocsPurpose & FeaturesLimitationsTo Do
ChangesLicense TermsUsing TkCon with other Tk Languagestkcon: tkcon procedure + +SourceForge Logo +
+ - +
+ + - - - + + + + + + + + +
Getting StartedSpecial BindingsProceduresDocumentationPurpose & FeaturesLimitationsTo DoLicense
Online Demo +(requires Tk plugin)Using TkCon with other Tk Languages
+ +
+ + - - - - + + + + + + + + + +
dumptkconidebugobserveGetting StartedSpecial BindingsProceduresScreenshot
dumptkconidebugobserve
- + +
+

This provides lots of useful control over a console:

-
tkcon attach interpreter +
tkcon attach interpreter
Attaches TkCon to the named interpreter. The name must be that returned by [tk appname] or a valid path to a slave interpreter. It's best to use this via the Console->Attach Console menu. -
tkcon buffer ?size? +
tkcon buffer ?size?
Sets or queries the allowed size of the console text widget in lines. The text widget will automatically delete leading lines once this number has been exceeded (read: this is the scroll buffer size). -
tkcon bgerror ?msg errorInfo? +
tkcon bgerror ?msg errorInfo?
Does bgerror stuff in the TkCon master interpreter. -
tkcon close or tkcon destroy +
tkcon close or tkcon destroy
Destroys this TkCon widget. -
tkcon console args +
tkcon console args
Passes the args to the TkCon text widget (the console). -
tkcon error +
tkcon error
Pops up a dialog that gives the user a full trace of the last error received in the TkCon console. -
tkcon find string ?-case TCL_BOOLEAN +
tkcon find string ?-case TCL_BOOLEAN -regexp TCL_BOOLEAN?
Highlights all instances of string in the console. If the string is empty, it clears any previous highlighting. -
tkcon font ?fontname? +
tkcon font ?fontname?
Sets or returns the font used by tkcon text widgets. -
tkcon gets ?varname? +
tkcon gets ?varname?
Behaves like the traditional Tcl gets, but uses the TkCon console instead of stdin. -
tkcon hide +
tkcon hide
Withdraw the TkCon display from the screen (make sure you have a way to get it back). -
tkcon history ?-newline? +
tkcon history ?-newline?
Displays the TkCon history in sourceable form. If -newline is specified, it separates each command by an extra newline. -
tkcon iconify +
tkcon iconify
Iconifies the TkCon display. -
tkcon load filename +
tkcon load filename
Sources named file into the slave interpreter. If no filename is given, it will attempt to call tk_getOpenFile to pop up the file select box. -
tkcon main ?arg arg ...? +
tkcon main ?arg arg ...?
Passes the args to the main TkCon interpreter to be evaluated and returns the result. -
tkcon master args +
tkcon master args
Passes the args to the master interpreter to be evaluated and returns the result. -
tkcon new +
tkcon new
Creates a new TkCon widget. -
tkcon save ?filename ?type?? +
tkcon save ?filename ?type??
Saves the console buffer to the given filename. If no filename is given, it will attempt to call tk_getSaveFile to pop up the file select box. If no type is given, a dialog will ask you to specify what portion of the text you want to save. -
tkcon set var ?value? +
tkcon set var ?value?
Queries or sets a master interpreter variable. -
tkcon append var ?value? +
tkcon append var ?value?
Like set, but uses append on the variable. -
tkcon lappend var ?value? +
tkcon lappend var ?value?
Like set, but uses lappend on the variable. -
tkcon show or tkcon deiconify +
tkcon show or tkcon deiconify
Redisplays TkCon on the screen. -
tkcon slave ?slavename ?arg arg ...?? +
tkcon slave ?slavename ?arg arg ...??
If called with no args, it returns the name of all the TkCon interpreters. Otherwise given an interp name it passes the args to the named interpreter to be evaluated and returns the result. If no args are passed, then it returns the [tk appname] of that interpreter. -
tkcon title ?title? +
tkcon title ?title?
Sets or returns the title for TkCon. -
tkcon version +
tkcon version
Returns of version of TkCon.
+
+

© diff --git a/docs/todo.html b/docs/todo.html index 6415e19..d4c7460 100755 --- a/docs/todo.html +++ b/docs/todo.html @@ -1,24 +1,44 @@ -TkCon: To Do Ideas +tkcon: To Do Ideas + -

TkCon: To Do Ideas

- +
+ + - - - - + + - - - +
TkCon DocsPurpose & FeaturesLimitationsTo Dotkcon: To Do Ideas + +SourceForge Logo +
ChangesLicense TermsUsing TkCon with other Tk Languages
+ + +
+ + + + + + + + + + +
DocumentationPurpose & FeaturesLimitationsTo DoLicense
Online Demo +(requires Tk plugin)Using TkCon with other Tk Languages
+ +
+

Future Ideas

    @@ -68,6 +88,9 @@ Works with slaves, but not foreign interps.
  • You tell me...
+
+
+
© Jeffrey Hobbs
diff --git a/index.html b/index.html index 2003d2b..c350921 100755 --- a/index.html +++ b/index.html @@ -1,45 +1,48 @@ Enhanced Tk Console: tkcon + - +
+ + - +

Enhanced Tk Console: tkcon

Enhanced Tk Console: tkcon - + SourceForge Logo
+ - - - - - + +
tkcon Documentation License (bourbon ware)
-
+ - - + + + + - @@ -47,6 +50,7 @@ You can grab the latest sources from the
Screenshot Online Demo! (requires -Tk plugin) DocumentationScreenshotOnline Demo! (requires +Tk plugin)License
+ Release Archives

-

Last full release (v1.6, April 1999):
+
Last full release (v2.1, May 4 2001):
 140159 Apr  1 11:52 tkcon.tcl
  86045 Apr  1 12:50 tkcon.tar.gz

You can grab the latest sources from the -tkcon CVS repository +tkcon CVS repository (currently v2.1alpha).

+

tkcon is a replacement for the standard console that comes with Tk (on @@ -61,7 +65,7 @@ tuning).


© -Jeffrey Hobbs
+Jeffrey Hobbs
-- 2.23.0