+2001-05-04 Jeff Hobbs <jeffh@ActiveState.com>
+
+ * 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 <jeffh@activestate.com>
* tkcon.tcl (::tkcon::Init): added safe interp check around 'cd'
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
(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...
<HTML>
<HEAD>
-<TITLE>TkCon: Special Bindings</TITLE>
+<TITLE>tkcon: Special Bindings</TITLE>
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="./style.css">
</HEAD>
<BODY BGCOLOR=#FFFFFF>
-<H1>TkCon: Special Bindings</H1>
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=0 BGCOLOR=#000000><TR><TD>
+<!-- start header info -->
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=#FFFFFF>
<TR>
-<TD BGCOLOR=#FFFF33><B><A HREF="index.html">TkCon Docs</A></B></TD>
-<TD><B><A HREF="purpose.html">Purpose & Features</A></B></TD>
-<TD><B><A HREF="limits.html">Limitations</A></B></TD>
-<TD><B><A HREF="todo.html">To Do</A></B></TD>
-</TR>
-<TD><B><A HREF="changes.txt">Changes</A></B></TD>
-<TD><B><A HREF="license.terms">License Terms</A></B></TD>
-<TD COLSPAN=2><B><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></B></TD>
+<TH><FONT SIZE=+3>tkcon: Special Bindings</FONT></TH>
+<TD align=right>
+<A href="http://tkcon.sourceforge.net/">
+<IMG src="http://sourceforge.net/sflogo.php?group_id=11462&type=1" width="88"
+height="31" border="0" alt="SourceForge Logo"></A>
+</TD>
</TR>
</TABLE>
+<!-- end header info -->
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+</TD></TR><TR><TD>
+<!-- start main navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#CCCCCC width=100%>
<TR>
-<TD><B><A HREF="start.html">Getting Started</A></B></TD>
-<TD BGCOLOR=#CCFF99><B><A HREF="bindings.html">Special Bindings</A></B></TD>
-<TD><B><A HREF="procs.html">Procedures</A></B></TD>
+<TH CLASS="hi"><A HREF="index.html" CLASS="hi">Documentation</A></TH>
+<TH><A HREF="purpose.html">Purpose & Features</A></TH>
+<TH><A HREF="limits.html">Limitations</A></TH>
+<TH><A HREF="todo.html">To Do</A></TH>
+<TH><A HREF="license.terms">License</A></TH>
+</TR><TR>
+<TH COLSPAN=2><A HREF="plugin.html">Online Demo</A>
+(requires <A HREF="http://tcl.activestate.com/software/plugin/">Tk plugin</A>)</TH>
+<TH COLSPAN=3><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></TH>
</TR>
+</TABLE>
+<!-- end main navigation table -->
+</TD></TR><TR><TD>
+<!-- start secondary navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#BBBBBB width=100%>
<TR>
-<TD><B><A HREF="dump.html"><CODE>dump</CODE></A></B></TD>
-<TD><B><A HREF="tkcon.html"><CODE>tkcon</CODE></A></B></TD>
-<TD><B><A HREF="idebug.html"><CODE>idebug</CODE></A></B></TD>
-<TD><B><A HREF="observe.html"><CODE>observe</CODE></A></B></TD>
+<TH><A HREF="start.html">Getting Started</A></TH>
+<TH CLASS="hi2"><A HREF="bindings.html" CLASS="hi2">Special Bindings</A></TH>
+<TH><A HREF="procs.html">Procedures</A></TH>
+<TH><A HREF="demopic.gif">Screenshot</A></TH>
+</TR>
+<TR>
+<TH><A HREF="dump.html"><CODE>dump</CODE></A></TH>
+<TH><A HREF="tkcon.html"><CODE>tkcon</CODE></A></TH>
+<TH><A HREF="idebug.html"><CODE>idebug</CODE></A></TH>
+<TH><A HREF="observe.html"><CODE>observe</CODE></A></TH>
</TR>
</TABLE>
-
+<!-- end secondary navigation table -->
+</TD></TR><TR><TD BGCOLOR=#FFFFFF>
+<DIV CLASS="indent">
<P>
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.
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?).
+</DIV>
+</TD></TR></TABLE>
<HR NOSHADE SIZE=1>
<ADDRESS><FONT SIZE=2>©
<HTML>
<HEAD>
-<TITLE>TkCon: dump procedure</TITLE>
+<TITLE>tkcon: dump procedure</TITLE>
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="./style.css">
</HEAD>
<BODY BGCOLOR=#FFFFFF>
-<H1>TkCon: <CODE>dump</CODE> procedure</H1>
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=0 BGCOLOR=#000000><TR><TD>
+<!-- start header info -->
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=#FFFFFF>
<TR>
-<TD BGCOLOR=#FFFF33><B><A HREF="index.html">TkCon Docs</A></B></TD>
-<TD><B><A HREF="purpose.html">Purpose & Features</A></B></TD>
-<TD><B><A HREF="limits.html">Limitations</A></B></TD>
-<TD><B><A HREF="todo.html">To Do</A></B></TD>
-</TR>
-<TD><B><A HREF="changes.txt">Changes</A></B></TD>
-<TD><B><A HREF="license.terms">License Terms</A></B></TD>
-<TD COLSPAN=2><B><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></B></TD>
+<TH><FONT SIZE=+3>tkcon: <CODE>dump</CODE> procedure</FONT></TH>
+<TD align=right>
+<A href="http://tkcon.sourceforge.net/">
+<IMG src="http://sourceforge.net/sflogo.php?group_id=11462&type=1" width="88"
+height="31" border="0" alt="SourceForge Logo"></A>
+</TD>
</TR>
</TABLE>
+<!-- end header info -->
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+</TD></TR><TR><TD>
+<!-- start main navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#CCCCCC width=100%>
<TR>
-<TD><B><A HREF="start.html">Getting Started</A></B></TD>
-<TD><B><A HREF="bindings.html">Special Bindings</A></B></TD>
-<TD><B><A HREF="procs.html">Procedures</A></B></TD>
+<TH CLASS="hi"><A HREF="index.html" CLASS="hi">Documentation</A></TH>
+<TH><A HREF="purpose.html">Purpose & Features</A></TH>
+<TH><A HREF="limits.html">Limitations</A></TH>
+<TH><A HREF="todo.html">To Do</A></TH>
+<TH><A HREF="license.terms">License</A></TH>
+</TR><TR>
+<TH COLSPAN=2><A HREF="plugin.html">Online Demo</A>
+(requires <A HREF="http://tcl.activestate.com/software/plugin/">Tk plugin</A>)</TH>
+<TH COLSPAN=3><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></TH>
</TR>
+</TABLE>
+<!-- end main navigation table -->
+</TD></TR><TR><TD>
+<!-- start secondary navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#BBBBBB width=100%>
<TR>
-<TD BGCOLOR=#CCFF99><B><A HREF="dump.html"><CODE>dump</CODE></A></B></TD>
-<TD><B><A HREF="tkcon.html"><CODE>tkcon</CODE></A></B></TD>
-<TD><B><A HREF="idebug.html"><CODE>idebug</CODE></A></B></TD>
-<TD><B><A HREF="observe.html"><CODE>observe</CODE></A></B></TD>
+<TH><A HREF="start.html">Getting Started</A></TH>
+<TH><A HREF="bindings.html">Special Bindings</A></TH>
+<TH><A HREF="procs.html">Procedures</A></TH>
+<TH><A HREF="demopic.gif">Screenshot</A></TH>
+</TR>
+<TR>
+<TH CLASS="hi2"><A HREF="dump.html" CLASS="hi2"><CODE>dump</CODE></A></TH>
+<TH><A HREF="tkcon.html"><CODE>tkcon</CODE></A></TH>
+<TH><A HREF="idebug.html"><CODE>idebug</CODE></A></TH>
+<TH><A HREF="observe.html"><CODE>observe</CODE></A></TH>
</TR>
</TABLE>
-
+<!-- end secondary navigation table -->
+</TD></TR><TR><TD BGCOLOR=#FFFFFF>
+<DIV CLASS="indent">
<P>
The <CODE>dump</CODE> command provides a way for the user to spit out
state information about the interpreter in a Tcl readable (and human
<DL>
-<DT> dump <b>command</b> <i>args</i>
+<DT> <CODE>dump <b>command</b></CODE> <i>args</i>
<DD> Outputs one or more commands.
-<DT> dump <b>procedure</b> <i>args</i>
+<DT> <CODE>dump <b>procedure</b></CODE> <i>args</i>
<DD> Outputs one or more procs in sourceable form.
-<DT> dump <b>variable</b> <i>args</i>
+<DT> <CODE>dump <b>variable</b></CODE> <i>args</i>
<DD> Outputs the values of variables in sourceable form. Recognizes nested
arrays. The <i>-filter</i> 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.
-<DT> dump <b>widget</b> <i>args</i>
+<DT> <CODE>dump <b>widget</b></CODE> <i>args</i>
<DD> Outputs one or more widgets by giving their configuration options.
The <i>-filter</i> pattern is used as to filter the config options and
is interpreted as a case insensitive regexp pattern (defaults to {.*})
</DL>
+</DIV>
+</TD></TR></TABLE>
<HR NOSHADE SIZE=1>
<ADDRESS><FONT SIZE=2>©
<HTML>
<HEAD>
-<TITLE>TkCon: idebug procedure</TITLE>
+<TITLE>tkcon: idebug procedure</TITLE>
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="./style.css">
</HEAD>
<BODY BGCOLOR=#FFFFFF>
-<H1>TkCon: <CODE>idebug</CODE> procedure</H1>
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=0 BGCOLOR=#000000><TR><TD>
+<!-- start header info -->
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=#FFFFFF>
<TR>
-<TD BGCOLOR=#FFFF33><B><A HREF="index.html">TkCon Docs</A></B></TD>
-<TD><B><A HREF="purpose.html">Purpose & Features</A></B></TD>
-<TD><B><A HREF="limits.html">Limitations</A></B></TD>
-<TD><B><A HREF="todo.html">To Do</A></B></TD>
-</TR>
-<TD><B><A HREF="changes.txt">Changes</A></B></TD>
-<TD><B><A HREF="license.terms">License Terms</A></B></TD>
-<TD COLSPAN=2><B><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></B></TD>
+<TH><FONT SIZE=+3>tkcon: <CODE>idebug</CODE> procedure</FONT></TH>
+<TD align=right>
+<A href="http://tkcon.sourceforge.net/">
+<IMG src="http://sourceforge.net/sflogo.php?group_id=11462&type=1" width="88"
+height="31" border="0" alt="SourceForge Logo"></A>
+</TD>
</TR>
</TABLE>
+<!-- end header info -->
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+</TD></TR><TR><TD>
+<!-- start main navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#CCCCCC width=100%>
<TR>
-<TD><B><A HREF="start.html">Getting Started</A></B></TD>
-<TD><B><A HREF="bindings.html">Special Bindings</A></B></TD>
-<TD><B><A HREF="procs.html">Procedures</A></B></TD>
+<TH CLASS="hi"><A HREF="index.html" CLASS="hi">Documentation</A></TH>
+<TH><A HREF="purpose.html">Purpose & Features</A></TH>
+<TH><A HREF="limits.html">Limitations</A></TH>
+<TH><A HREF="todo.html">To Do</A></TH>
+<TH><A HREF="license.terms">License</A></TH>
+</TR><TR>
+<TH COLSPAN=2><A HREF="plugin.html">Online Demo</A>
+(requires <A HREF="http://tcl.activestate.com/software/plugin/">Tk plugin</A>)</TH>
+<TH COLSPAN=3><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></TH>
</TR>
+</TABLE>
+<!-- end main navigation table -->
+</TD></TR><TR><TD>
+<!-- start secondary navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#BBBBBB width=100%>
<TR>
-<TD><B><A HREF="dump.html"><CODE>dump</CODE></A></B></TD>
-<TD><B><A HREF="tkcon.html"><CODE>tkcon</CODE></A></B></TD>
-<TD BGCOLOR=#CCFF99><B><A HREF="idebug.html"><CODE>idebug</CODE></A></B></TD>
-<TD><B><A HREF="observe.html"><CODE>observe</CODE></A></B></TD>
+<TH><A HREF="start.html">Getting Started</A></TH>
+<TH><A HREF="bindings.html">Special Bindings</A></TH>
+<TH><A HREF="procs.html">Procedures</A></TH>
+<TH><A HREF="demopic.gif">Screenshot</A></TH>
+</TR>
+<TR>
+<TH><A HREF="dump.html"><CODE>dump</CODE></A></TH>
+<TH><A HREF="tkcon.html"><CODE>tkcon</CODE></A></TH>
+<TH CLASS="hi2"><A HREF="idebug.html" CLASS="hi2"><CODE>idebug</CODE></A></TH>
+<TH><A HREF="observe.html"><CODE>observe</CODE></A></TH>
</TR>
</TABLE>
-
+<!-- end secondary navigation table -->
+</TD></TR><TR><TD BGCOLOR=#FFFFFF>
+<DIV CLASS="indent">
<P>
The <B>idebug</B> command provides an interactive debugging environment for
procedures via TkCon. You can place <code>idebug break</code> commands
<DL>
-<DT> <CODE>idebug body</CODE> <I>?level?</I>
+<DT> <CODE>idebug <b>body</b></CODE> <I>?level?</I>
<DD> Prints out the body of the command (if it is a procedure) at the
specified level. <i>level</i> defaults to the current level.
-<DT> <CODE>idebug break</CODE> <I>?id?</I>
+<DT> <CODE>idebug <b>break</b></CODE> <I>?id?</I>
<DD> 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
id is specified, it defaults to the name of the command in which the call
was made.
-<DT> <CODE>idebug id</CODE> <I>?id?</I>
+<DT> <CODE>idebug <b>id</b></CODE> <I>?id?</I>
<DD> 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 *.
-<DT> <CODE>idebug off</CODE>
+<DT> <CODE>idebug <b>off</b></CODE>
<DD> Turns idebug off.
-<DT> <CODE>idebug on</CODE> <I>?id?</I>
+<DT> <CODE>idebug <b>on</b></CODE> <I>?id?</I>
<DD> Turns idebug on. If <i>id</i> is specified, it sets the id to it.
<DT> <CODE>idebug {puts ?id?}</CODE> <I>args</I>
id is specified, it defaults to the name of the command in which the call
was made.
-<DT> <CODE>idebug show</CODE> <I>type ?level? ?VERBOSE?</I>
+<DT> <CODE>idebug <b>show</b></CODE> <I>type ?level? ?VERBOSE?</I>
<DD> <i>type</i> 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.
<i>level</i> defaults to the level in which this method was called.
-<DT> <CODE>idebug trace</CODE> <I>?level?</I>
+<DT> <CODE>idebug <b>trace</b></CODE> <I>?level?</I>
<DD> Prints out the stack trace from the specified level up to the top
level. <i>level</i> defaults to the current level.
</DL>
+</DIV>
+</TD></TR></TABLE>
<HR NOSHADE SIZE=1>
<ADDRESS><FONT SIZE=2>©
<HTML>
<HEAD>
-<TITLE>TkCon: Documentation</TITLE>
-
+<TITLE>tkcon: Documentation</TITLE>
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="./style.css">
</HEAD>
<BODY BGCOLOR=#FFFFFF>
-<H1>TkCon: Documentation (March 1999)</H1>
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=0 BGCOLOR=#000000><TR><TD>
+<!-- start header info -->
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=#FFFFFF>
<TR>
-<TD BGCOLOR=#FFFF33><B><A HREF="index.html">TkCon Docs</A></B></TD>
-<TD><B><A HREF="purpose.html">Purpose & Features</A></B></TD>
-<TD><B><A HREF="limits.html">Limitations</A></B></TD>
-<TD><B><A HREF="todo.html">To Do</A></B></TD>
+<TD><FONT SIZE=+3><B>tkcon Documentation</B> (May 2001)</FONT></TD>
+<TD align=right>
+<A href="http://tkcon.sourceforge.net/">
+<IMG src="http://sourceforge.net/sflogo.php?group_id=11462&type=1" width="88"
+height="31" border="0" alt="SourceForge Logo"></A>
+</TD>
</TR>
-<TD><B><A HREF="changes.txt">Changes</A></B></TD>
-<TD><B><A HREF="license.terms">License Terms</A></B></TD>
-<TD COLSPAN=2><B><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></B></TD>
+</TABLE>
+<!-- end header info -->
+
+</TD></TR><TR><TD>
+<!-- start main navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#CCCCCC width=100%>
+<TR>
+<TH CLASS="hi"><A HREF="index.html" CLASS="hi">Documentation</A></TH>
+<TH><A HREF="purpose.html">Purpose & Features</A></TH>
+<TH><A HREF="limits.html">Limitations</A></TH>
+<TH><A HREF="todo.html">To Do</A></TH>
+<TH><A HREF="license.terms">License</A></TH>
+</TR><TR>
+<TH COLSPAN=2><A HREF="plugin.html">Online Demo</A>
+(requires <A HREF="http://tcl.activestate.com/software/plugin/">Tk plugin</A>)</TH>
+<TH COLSPAN=3><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></TH>
</TR>
</TABLE>
+<!-- end main navigation table -->
+
+</TD></TR><TR><TD BGCOLOR=#FFFFFF>
+<DIV CLASS="indent">
<H4><A HREF="ftp://tkcon.sourceforge.net/pub/tkcon/">Release Archives</A></H4>
improvement. Send them to my
<A HREF="mailto:jeff.hobbs@acm.org">suggestion box</A>.
<P>
+</DIV>
+</TD></TR><TR><TD>
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#CCCCCC width=100%>
<TR>
-<TD><B><A HREF="start.html">Getting Started:</A></B><BR>
-<SMALL>TkCon resource file and command line options</SMALL></TD>
-<TD><B><A HREF="bindings.html">Special Bindings</A></B></TD>
-<TD><B><A HREF="procs.html">New Procedures in TkCon</A></B></TD>
+<TH><A HREF="start.html">Getting Started</A></TD>
+<TH><A HREF="bindings.html">Special Bindings</A></TH>
+<TH><A HREF="procs.html">tkcon Procedures</A></TH>
+<TH><A HREF="demopic.gif">Screenshot</A></TH>
</TR>
<TR>
-<TD><B><A HREF="dump.html"><CODE>dump</CODE> procedure</A></B></TD>
-<TD><B><A HREF="tkcon.html"><CODE>tkcon</CODE> procedure</A></B></TD>
-<TD><B><A HREF="idebug.html"><CODE>idebug</CODE> procedure</A></B></TD>
-<TD><B><A HREF="observe.html"><CODE>observe</CODE> procedure</A></B></TD>
+<TH><A HREF="dump.html"><CODE>dump</CODE> proc</A></TH>
+<TH><A HREF="tkcon.html"><CODE>tkcon</CODE> proc</A></TH>
+<TH><A HREF="idebug.html"><CODE>idebug</CODE> proc</A></TH>
+<TH><A HREF="observe.html"><CODE>observe</CODE> proc</A></TH>
</TR>
</TABLE>
+</TD></TR></TABLE>
+
<HR NOSHADE SIZE=1>
<ADDRESS><FONT SIZE=2>©
<A HREF="mailto:jeff.hobbs@acm.org">Jeffrey Hobbs</A></FONT></ADDRESS>
* 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 <jeff.hobbs@acm.org>. The
following terms apply to all files associated with the software unless
explicitly disclaimed in individual files.
<HTML>
<HEAD>
-<TITLE>TkCon: Limitations</TITLE>
+<TITLE>tkcon: Limitations</TITLE>
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="./style.css">
</HEAD>
<BODY BGCOLOR=#FFFFFF>
-<H1>TkCon: Limitations</H1>
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=0 BGCOLOR=#000000><TR><TD>
+<!-- start header info -->
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=#FFFFFF>
<TR>
-<TD><B><A HREF="index.html">TkCon Docs</A></B></TD>
-<TD><B><A HREF="purpose.html">Purpose & Features</A></B></TD>
-<TD BGCOLOR=#FFFF33><B><A HREF="limits.html">Limitations</A></B></TD>
-<TD><B><A HREF="todo.html">To Do</A></B></TD>
+<TH><FONT SIZE=+3>tkcon: Limitations</FONT></TH>
+<TD align=right>
+<A href="http://tkcon.sourceforge.net/">
+<IMG src="http://sourceforge.net/sflogo.php?group_id=11462&type=1" width="88"
+height="31" border="0" alt="SourceForge Logo"></A>
+</TD>
</TR>
-<TD><B><A HREF="changes.txt">Changes</A></B></TD>
-<TD><B><A HREF="license.terms">License Terms</A></B></TD>
-<TD COLSPAN=2><B><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></B></TD>
+</TABLE>
+<!-- end header info -->
+
+</TD></TR><TR><TD>
+<!-- start main navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#CCCCCC width=100%>
+<TR>
+<TH><A HREF="index.html">Documentation</A></TH>
+<TH><A HREF="purpose.html">Purpose & Features</A></TH>
+<TH CLASS="hi"><A HREF="limits.html" CLASS="hi">Limitations</A></TH>
+<TH><A HREF="todo.html">To Do</A></TH>
+<TH><A HREF="license.terms">License</A></TH>
+</TR><TR>
+<TH COLSPAN=2><A HREF="plugin.html">Online Demo</A>
+(requires <A HREF="http://tcl.activestate.com/software/plugin/">Tk plugin</A>)</TH>
+<TH COLSPAN=3><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></TH>
</TR>
</TABLE>
+<!-- end main navigation table -->
+</TD></TR><TR><TD BGCOLOR=#FFFFFF>
+<DIV CLASS="indent">
<H3>Limitations:</H3>
-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
you must use the syntax of the target environment. See my
<A HREF="nontcl.html">notes on using other Tk-embedded languages</A> for
more info.
+</DIV>
+</TD></TR></TABLE>
<HR NOSHADE SIZE=1>
<ADDRESS><FONT SIZE=2>©
<HTML>
<HEAD>
-<TITLE>TkCon for Non-Tcl Users</TITLE>
+<TITLE>tkcon for Non-Tcl Users</TITLE>
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="./style.css">
</HEAD>
<BODY BGCOLOR=#FFFFFF>
-<H1>TkCon for Non-Tcl Users</H1>
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=0 BGCOLOR=#000000><TR><TD>
+<!-- start header info -->
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=#FFFFFF>
<TR>
-<TD><B><A HREF="index.html">TkCon Docs</A></B></TD>
-<TD><B><A HREF="purpose.html">Purpose & Features</A></B></TD>
-<TD><B><A HREF="limits.html">Limitations</A></B></TD>
-<TD><B><A HREF="todo.html">To Do</A></B></TD>
+<TH><FONT SIZE=+3>tkcon: Non-Tcl Usage</FONT></TH>
+<TD align=right>
+<A href="http://tkcon.sourceforge.net/">
+<IMG src="http://sourceforge.net/sflogo.php?group_id=11462&type=1" width="88"
+height="31" border="0" alt="SourceForge Logo"></A>
+</TD>
</TR>
-<TD><B><A HREF="changes.txt">Changes</A></B></TD>
-<TD><B><A HREF="license.terms">License Terms</A></B></TD>
-<TD COLSPAN=2 BGCOLOR=#FFFF33><B><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></B></TD>
+</TABLE>
+<!-- end header info -->
+
+</TD></TR><TR><TD>
+<!-- start main navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#CCCCCC width=100%>
+<TR>
+<TH><A HREF="index.html">Documentation</A></TH>
+<TH><A HREF="purpose.html">Purpose & Features</A></TH>
+<TH><A HREF="limits.html">Limitations</A></TH>
+<TH><A HREF="todo.html">To Do</A></TH>
+<TH><A HREF="license.terms">License</A></TH>
+</TR><TR>
+<TH COLSPAN=2><A HREF="plugin.html">Online Demo</A>
+(requires <A HREF="http://tcl.activestate.com/software/plugin/">Tk plugin</A>)</TH>
+<TH COLSPAN=3 CLASS="hi"><A HREF="nontcl.html" CLASS="hi">Using TkCon with other Tk Languages</A></TH>
</TR>
</TABLE>
+<!-- end main navigation table -->
+</TD></TR><TR><TD BGCOLOR=#FFFFFF>
+<DIV CLASS="indent">
<I>This document is for those users who are trying to use TkCon with a
non-Tcl based Tk language (ie - SchemeTk, PerlTk, PythonTk...).</I>
<P>
-TkCon requires <A HREF="http://www.scriptics.com/">Tcl 7.6 / Tk 4.2</A> to
-run (better with 8.0+). However, it can attach to any language with Tk4+
+TkCon requires <A HREF="http://tcl.activestate.com/">Tcl/Tk 8.0+</A> 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
(lusol@Turkey.CC.Lehigh.EDU)</A> contributed
a <A HREF="perl.txt">companion Perl/Tk program</A> that does the trick with
some extras.
+</DIV>
+</TD></TR></TABLE>
<HR NOSHADE SIZE=1>
<ADDRESS><FONT SIZE=2>©
<HTML>
<HEAD>
-<TITLE>TkCon: observe procedure</TITLE>
+<TITLE>tkcon: observe procedure</TITLE>
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="./style.css">
</HEAD>
<BODY BGCOLOR=#FFFFFF>
-<H1>TkCon: <CODE>observe</CODE> procedure</H1>
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=0 BGCOLOR=#000000><TR><TD>
+<!-- start header info -->
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=#FFFFFF>
<TR>
-<TD BGCOLOR=#FFFF33><B><A HREF="index.html">TkCon Docs</A></B></TD>
-<TD><B><A HREF="purpose.html">Purpose & Features</A></B></TD>
-<TD><B><A HREF="limits.html">Limitations</A></B></TD>
-<TD><B><A HREF="todo.html">To Do</A></B></TD>
-</TR>
-<TD><B><A HREF="changes.txt">Changes</A></B></TD>
-<TD><B><A HREF="license.terms">License Terms</A></B></TD>
-<TD COLSPAN=2><B><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></B></TD>
+<TH><FONT SIZE=+3>tkcon: <CODE>observe</CODE> procedure</FONT></TH>
+<TD align=right>
+<A href="http://tkcon.sourceforge.net/">
+<IMG src="http://sourceforge.net/sflogo.php?group_id=11462&type=1" width="88"
+height="31" border="0" alt="SourceForge Logo"></A>
+</TD>
</TR>
</TABLE>
+<!-- end header info -->
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+</TD></TR><TR><TD>
+<!-- start main navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#CCCCCC width=100%>
<TR>
-<TD><B><A HREF="start.html">Getting Started</A></B></TD>
-<TD><B><A HREF="bindings.html">Special Bindings</A></B></TD>
-<TD><B><A HREF="procs.html">Procedures</A></B></TD>
+<TH CLASS="hi"><A HREF="index.html" CLASS="hi">Documentation</A></TH>
+<TH><A HREF="purpose.html">Purpose & Features</A></TH>
+<TH><A HREF="limits.html">Limitations</A></TH>
+<TH><A HREF="todo.html">To Do</A></TH>
+<TH><A HREF="license.terms">License</A></TH>
+</TR><TR>
+<TH COLSPAN=2><A HREF="plugin.html">Online Demo</A>
+(requires <A HREF="http://tcl.activestate.com/software/plugin/">Tk plugin</A>)</TH>
+<TH COLSPAN=3><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></TH>
</TR>
+</TABLE>
+<!-- end main navigation table -->
+</TD></TR><TR><TD>
+<!-- start secondary navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#BBBBBB width=100%>
<TR>
-<TD><B><A HREF="dump.html"><CODE>dump</CODE></A></B></TD>
-<TD><B><A HREF="tkcon.html"><CODE>tkcon</CODE></A></B></TD>
-<TD><B><A HREF="idebug.html"><CODE>idebug</CODE></A></B></TD>
-<TD BGCOLOR=#CCFF99><B><A HREF="observe.html"><CODE>observe</CODE></A></B></TD>
+<TH><A HREF="start.html">Getting Started</A></TH>
+<TH><A HREF="bindings.html">Special Bindings</A></TH>
+<TH><A HREF="procs.html">Procedures</A></TH>
+<TH><A HREF="demopic.gif">Screenshot</A></TH>
+</TR>
+<TR>
+<TH><A HREF="dump.html"><CODE>dump</CODE></A></TH>
+<TH><A HREF="tkcon.html"><CODE>tkcon</CODE></A></TH>
+<TH><A HREF="idebug.html"><CODE>idebug</CODE></A></TH>
+<TH CLASS="hi2"><A HREF="observe.html" CLASS="hi2"><CODE>observe</CODE></A></TH>
</TR>
</TABLE>
-
+<!-- end secondary navigation table -->
+</TD></TR><TR><TD BGCOLOR=#FFFFFF>
+<DIV CLASS="indent">
<P>
This command provides runtime debugging output for variables and commands
without the need to edit your code. For variables, the underlying mechanism
<DL>
-<DT> <CODE>observe command</CODE> <I>cmdname ?maxlevel?</I>
+<DT> <CODE>observe <b>command</b></CODE> <I>cmdname ?maxlevel?</I>
<DD> This will create a wrapper command which prints out (using
<code>dump</code>) the call stack to the console. <i>maxlevel</i>
represents the maximum number of levels of the call stack which will be
printed (defaults to 4).
-<DT> <CODE>observe cdelete</CODE> <I>cmdname</I>
+<DT> <CODE>observe <b>cdelete</b></CODE> <I>cmdname</I>
<DD> Removes the wrapper around an observed command.
-<DT> <CODE>observe cinfo</CODE> <I>cmdname</I>
+<DT> <CODE>observe <b>cinfo</b></CODE> <I>cmdname</I>
<DD> Prints out useless info.
-<DT> <CODE>observe variable</CODE> <I>varname operation ?args?</I>
+<DT> <CODE>observe <b>variable</b></CODE> <I>varname operation ?args?</I>
<DD> Currently a wrapper around trace that uses <code>dump</code> to
print out the value of the named variable whenever the specified operation
on that variable occurs (must be read, write or unset).
-<DT> <CODE>observe vdelete</CODE> <I>varname operation</I>
+<DT> <CODE>observe <b>vdelete</b></CODE> <I>varname operation</I>
<DD> Deletes the trace wrapper around the named variable.
-<DT> <CODE>observe vinfo</CODE> <I>varname</I>
+<DT> <CODE>observe <b>vinfo</b></CODE> <I>varname</I>
<DD> Prints out trace info about the named variable.
</DL>
+</DIV>
+</TD></TR></TABLE>
<HR NOSHADE SIZE=1>
<ADDRESS><FONT SIZE=2>©
<HTML>
<HEAD>
-<TITLE>TkCon: Tcl Plugin Stripped Demo</TITLE>
+<TITLE>tkcon: Tcl Plugin Stripped Demo</TITLE>
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="./style.css">
</HEAD>
<BODY>
-<H1>TkCon: Tcl Plugin Stripped Demo</H1>
-<HR>
-<A HREF="../">TkCon Distribution</A>
- <P>
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=0 BGCOLOR=#000000><TR><TD>
+<!-- start header info -->
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=#FFFFFF>
+<TR>
+<TD><FONT SIZE=+3><B>tkcon Documentation</B> (May 2001)</FONT></TD>
+<TD align=right>
+<A href="http://tkcon.sourceforge.net/">
+<IMG src="http://sourceforge.net/sflogo.php?group_id=11462&type=1" width="88"
+height="31" border="0" alt="SourceForge Logo"></A>
+</TD>
+</TR>
+</TABLE>
+<!-- end header info -->
-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
+</TD></TR><TR><TD>
+<!-- start main navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#CCCCCC width=100%>
+<TR>
+<TH><A HREF="index.html">Documentation</A></TH>
+<TH><A HREF="purpose.html">Purpose & Features</A></TH>
+<TH><A HREF="limits.html">Limitations</A></TH>
+<TH><A HREF="todo.html">To Do</A></TH>
+<TH><A HREF="license.terms">License</A></TH>
+</TR><TR>
+<TH COLSPAN=2 CLASS="hi"><A HREF="plugin.html" CLASS="hi">Online Demo</A>
+(requires <A HREF="http://tcl.activestate.com/software/plugin/">Tk plugin</A>)</TH>
+<TH COLSPAN=3><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></TH>
+</TR>
+</TABLE>
+<!-- end main navigation table -->
+
+</TD></TR><TR><TD BGCOLOR=#FFFFFF>
+<DIV CLASS="indent">
+<P>
+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).
<P>
-<embed src="http://cvs.sourceforge.net/cgi-bin/cvsweb.cgi/~checkout~/tkcon/tkcon.tcl?rev=1.20&content-type=application/x-tcl&cvsroot=tkcon" width=600 height=350>
+<embed src="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/~checkout~/tkcon/tkcon/tkcon.tcl?rev=1.28&content-type=application/x-tcl" width=630 height=350>
</P>
Have a look at some of the features: (culled from the
-<A HREF="./">TkCon documentation</A>)
+<A HREF="./">tkcon documentation</A>)
<UL>
<LI> <B>Variable / Path / Procedure Name Expansion.</B> Type in
<CODE>set tc</CODE> at the prompt. Hit <I><Control-Shift-V></I>.
<I><Control-x></I>/<I><Control-c></I>/<I><Control-v></I>.
</UL>
+</DIV>
+</TD></TR></TABLE>
-<HR>
-
-<ADDRESS>
-Contact <A HREF="mailto:jeff.hobbs@acm.org">jeff.hobbs@acm.org</A>
-with questions or updated info.
-</ADDRESS>
+<HR NOSHADE SIZE=1>
+<ADDRESS><FONT SIZE=2>©
+<A HREF="mailto:jeff.hobbs@acm.org">Jeffrey Hobbs</A></FONT></ADDRESS>
</BODY>
</HTML>
<HTML>
<HEAD>
-<TITLE>TkCon: Procedures</TITLE>
+<TITLE>tkcon: Procedures</TITLE>
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="./style.css">
</HEAD>
<BODY BGCOLOR=#FFFFFF>
-<H1>TkCon: Procedures</H1>
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=0 BGCOLOR=#000000><TR><TD>
+<!-- start header info -->
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=#FFFFFF>
<TR>
-<TD BGCOLOR=#FFFF33><B><A HREF="index.html">TkCon Docs</A></B></TD>
-<TD><B><A HREF="purpose.html">Purpose & Features</A></B></TD>
-<TD><B><A HREF="limits.html">Limitations</A></B></TD>
-<TD><B><A HREF="todo.html">To Do</A></B></TD>
-</TR>
-<TD><B><A HREF="changes.txt">Changes</A></B></TD>
-<TD><B><A HREF="license.terms">License Terms</A></B></TD>
-<TD COLSPAN=2><B><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></B></TD>
+<TH><FONT SIZE=+3>tkcon: Procedures</FONT></TH>
+<TD align=right>
+<A href="http://tkcon.sourceforge.net/">
+<IMG src="http://sourceforge.net/sflogo.php?group_id=11462&type=1" width="88"
+height="31" border="0" alt="SourceForge Logo"></A>
+</TD>
</TR>
</TABLE>
+<!-- end header info -->
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+</TD></TR><TR><TD>
+<!-- start main navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#CCCCCC width=100%>
<TR>
-<TD><B><A HREF="start.html">Getting Started</A></B></TD>
-<TD><B><A HREF="bindings.html">Special Bindings</A></B></TD>
-<TD BGCOLOR=#CCFF99><B><A HREF="procs.html">Procedures</A></B></TD>
+<TH CLASS="hi"><A HREF="index.html" CLASS="hi">Documentation</A></TH>
+<TH><A HREF="purpose.html">Purpose & Features</A></TH>
+<TH><A HREF="limits.html">Limitations</A></TH>
+<TH><A HREF="todo.html">To Do</A></TH>
+<TH><A HREF="license.terms">License</A></TH>
+</TR><TR>
+<TH COLSPAN=2><A HREF="plugin.html">Online Demo</A>
+(requires <A HREF="http://tcl.activestate.com/software/plugin/">Tk plugin</A>)</TH>
+<TH COLSPAN=3><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></TH>
</TR>
+</TABLE>
+<!-- end main navigation table -->
+</TD></TR><TR><TD>
+<!-- start secondary navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#BBBBBB width=100%>
<TR>
-<TD><B><A HREF="dump.html"><CODE>dump</CODE></A></B></TD>
-<TD><B><A HREF="tkcon.html"><CODE>tkcon</CODE></A></B></TD>
-<TD><B><A HREF="idebug.html"><CODE>idebug</CODE></A></B></TD>
-<TD><B><A HREF="observe.html"><CODE>observe</CODE></A></B></TD>
+<TH><A HREF="start.html">Getting Started</A></TH>
+<TH><A HREF="bindings.html">Special Bindings</A></TH>
+<TH CLASS="hi2"><A HREF="procs.html" CLASS="hi2">Procedures</A></TH>
+<TH><A HREF="demopic.gif">Screenshot</A></TH>
+</TR>
+<TR>
+<TH><A HREF="dump.html"><CODE>dump</CODE></A></TH>
+<TH><A HREF="tkcon.html"><CODE>tkcon</CODE></A></TH>
+<TH><A HREF="idebug.html"><CODE>idebug</CODE></A></TH>
+<TH><A HREF="observe.html"><CODE>observe</CODE></A></TH>
</TR>
</TABLE>
-
+<!-- end secondary navigation table -->
+</TD></TR><TR><TD BGCOLOR=#FFFFFF>
+<DIV CLASS="indent">
<P>
There are several new procedures introduced in TkCon to improve
productivity and/or account for lost functionality in the Tcl environment
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).
+</DIV>
+</TD></TR></TABLE>
<HR NOSHADE SIZE=1>
<ADDRESS><FONT SIZE=2>©
<HTML>
<HEAD>
-<TITLE>TkCon: Purpose & Features</TITLE>
+<TITLE>tkcon: Purpose & Features</TITLE>
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="./style.css">
</HEAD>
<BODY BGCOLOR=#FFFFFF>
-<H1>TkCon: Purpose & Features</H1>
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=0 BGCOLOR=#000000><TR><TD>
+<!-- start header info -->
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=#FFFFFF>
<TR>
-<TD><B><A HREF="index.html">TkCon Docs</A></B></TD>
-<TD BGCOLOR=#FFFF33><B><A HREF="purpose.html">Purpose & Features</A></B></TD>
-<TD><B><A HREF="limits.html">Limitations</A></B></TD>
-<TD><B><A HREF="todo.html">To Do</A></B></TD>
+<TD><FONT SIZE=+3><B>tkcon: Purpose & Features</B></FONT></TD>
+<TD align=right>
+<A href="http://tkcon.sourceforge.net/">
+<IMG src="http://sourceforge.net/sflogo.php?group_id=11462&type=1" width="88"
+height="31" border="0" alt="SourceForge Logo"></A>
+</TD>
</TR>
-<TD><B><A HREF="changes.txt">Changes</A></B></TD>
-<TD><B><A HREF="license.terms">License Terms</A></B></TD>
-<TD COLSPAN=2><B><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></B></TD>
+</TABLE>
+<!-- end header info -->
+
+</TD></TR><TR><TD>
+<!-- start main navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#CCCCCC width=100%>
+<TR>
+<TH><A HREF="index.html">Documentation</A></TH>
+<TH CLASS="hi"><A HREF="purpose.html" CLASS="hi">Purpose & Features</A></TH>
+<TH><A HREF="limits.html">Limitations</A></TH>
+<TH><A HREF="todo.html">To Do</A></TH>
+<TH><A HREF="license.terms">License</A></TH>
+</TR><TR>
+<TH COLSPAN=2><A HREF="plugin.html">Online Demo</A>
+(requires <A HREF="http://tcl.activestate.com/software/plugin/">Tk plugin</A>)</TH>
+<TH COLSPAN=3><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></TH>
</TR>
</TABLE>
+<!-- end main navigation table -->
+
+</TD></TR><TR><TD BGCOLOR=#FFFFFF>
+<DIV CLASS="indent">
<H3>Purpose:</H3>
-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
-<i>many</i> more features than the standard console. TkCon works on all
+<i>many</i> 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
tuning).
<P>
See <A HREF="limits.html">Limitations</A> for a good idea of what
-TkCon <B>can't</B> do for you.
+tkcon <B>can't</B> do for you.
<H3>Features:</H3>
Just in case you don't run across them while playing, here are some of the
-extras in TkCon:
+extras in tkcon:
<UL>
<LI> Command history
<LI> Path (Unix style) / Proc / Variable name expansion
<LI> Cut / Copy / Paste between windows
<LI> Communication between consoles and other Tk interpreters (including
non-tcl ones)
+<LI> Hot Errors (click on error result to see stack trace)
<LI> Works on all Tk platforms
</UL>
Read the <A HREF="index.html">documentation</A> for how to take advantage
of these features.
+</DIV>
+</TD></TR></TABLE>
<HR NOSHADE SIZE=1>
<ADDRESS><FONT SIZE=2>©
<HTML>
<HEAD>
-<TITLE>TkCon: Getting Started</TITLE>
+<TITLE>tkcon: Getting Started</TITLE>
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="./style.css">
</HEAD>
<BODY BGCOLOR=#FFFFFF>
-<H1>TkCon: Getting Started</H1>
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=0 BGCOLOR=#000000><TR><TD>
+<!-- start header info -->
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=#FFFFFF>
<TR>
-<TD BGCOLOR=#FFFF33><B><A HREF="index.html">TkCon Docs</A></B></TD>
-<TD><B><A HREF="purpose.html">Purpose & Features</A></B></TD>
-<TD><B><A HREF="limits.html">Limitations</A></B></TD>
-<TD><B><A HREF="todo.html">To Do</A></B></TD>
-</TR>
-<TD><B><A HREF="changes.txt">Changes</A></B></TD>
-<TD><B><A HREF="license.terms">License Terms</A></B></TD>
-<TD COLSPAN=2><B><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></B></TD>
+<TH><FONT SIZE=+3>tkcon: Getting Started</FONT></TH>
+<TD align=right>
+<A href="http://tkcon.sourceforge.net/">
+<IMG src="http://sourceforge.net/sflogo.php?group_id=11462&type=1" width="88"
+height="31" border="0" alt="SourceForge Logo"></A>
+</TD>
</TR>
</TABLE>
+<!-- end header info -->
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+</TD></TR><TR><TD>
+<!-- start main navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#CCCCCC width=100%>
+<TR>
+<TH CLASS="hi"><A HREF="index.html" CLASS="hi">Documentation</A></TH>
+<TH><A HREF="purpose.html">Purpose & Features</A></TH>
+<TH><A HREF="limits.html">Limitations</A></TH>
+<TH><A HREF="todo.html">To Do</A></TH>
+<TH><A HREF="license.terms">License</A></TH>
+</TR><TR>
+<TH COLSPAN=2><A HREF="plugin.html">Online Demo</A>
+(requires <A HREF="http://tcl.activestate.com/software/plugin/">Tk plugin</A>)</TH>
+<TH COLSPAN=3><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></TH>
+</TR>
+</TABLE>
+<!-- end main navigation table -->
+</TD></TR><TR><TD>
+<!-- start secondary navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#BBBBBB width=100%>
<TR>
-<TD BGCOLOR=#CCFF99><B><A HREF="start.html">Getting Started</A></B></TD>
-<TD><B><A HREF="bindings.html">Special Bindings</A></B></TD>
-<TD><B><A HREF="procs.html">Procedures</A></B></TD>
+<TH CLASS="hi2"><A HREF="start.html" CLASS="hi2">Getting Started</A></TH>
+<TH><A HREF="bindings.html">Special Bindings</A></TH>
+<TH><A HREF="procs.html">Procedures</A></TH>
+<TH><A HREF="demopic.gif">Screenshot</A></TH>
</TR>
<TR>
-<TD><B><A HREF="dump.html"><CODE>dump</CODE></A></B></TD>
-<TD><B><A HREF="tkcon.html"><CODE>tkcon</CODE></A></B></TD>
-<TD><B><A HREF="idebug.html"><CODE>idebug</CODE></A></B></TD>
-<TD><B><A HREF="observe.html"><CODE>observe</CODE></A></B></TD>
+<TH><A HREF="dump.html"><CODE>dump</CODE></A></TH>
+<TH><A HREF="tkcon.html"><CODE>tkcon</CODE></A></TH>
+<TH><A HREF="idebug.html"><CODE>idebug</CODE></A></TH>
+<TH><A HREF="observe.html"><CODE>observe</CODE></A></TH>
</TR>
</TABLE>
-
+<!-- end secondary navigation table -->
+</TD></TR><TR><TD BGCOLOR=#FFFFFF>
+<DIV CLASS="indent">
<H3>Resource File:</H3>
TkCon will search for a resource file in "<CODE>$env(HOME)/.tkconrc</CODE>"
further consoles. This is meant only for wrapping TkCon around programs
that require their own arguments.
-<DT> <CODE>-color,*</CODE> <I>color</I>
+<DT> <CODE>-color-<color></CODE> <I>color</I>
<DD> Sets the requested color type to the specified color for tkcon.
-See the <B>Variables</B> section for the various color,* types.
+See the <B>Variables</B> section for the recognized
+<i><color></i> names.
<DT> <CODE>-eval</CODE> (also <CODE>-main</CODE> or <CODE>-e</CODE>)
<DD> A tcl script to eval in each main interpreter. This is evaluated
<H3>Variables:</H3>
-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 <CODE>TKCON</CODE>. You can
-'<CODE>tkcon set TKCON</CODE>' 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 <code>::tkcon</code> namespace. The
+modifiable array variables are <CODE>::tkcon::COLOR</CODE> and
+<CODE>::tkcon::OPT</CODE>. You can call '<CODE>tkcon set
+::tkcon::COLOR</CODE>' when the program is running to check its state.
+Here is an explanation of certain variables you might change or use:
<DL>
-<DT> <CODE>color,bg</CODE>
+<DT> <CODE>::tkcon::COLOR(bg)</CODE>
<DD> The background color for tkcon text widgets.
Defaults to the operating system default (determined at startup).
-<DT> <CODE>color,blink</CODE>
+<DT> <CODE>::tkcon::COLOR(blink)</CODE>
<DD> The background color of the electric brace highlighting, if on.
Defaults to <font color=#FFFF00>yellow</font>.
-<DT> <CODE>color,cursor</CODE>
+<DT> <CODE>::tkcon::COLOR(cursor)</CODE>
<DD> The background color for the insertion cursor in tkcon.
Defaults to <font color=#000000>black</font>.
-<DT> <CODE>color,disabled</CODE>
+<DT> <CODE>::tkcon::COLOR(disabled)</CODE>
<DD> The foreground color for disabled menu items.
Defaults to <font color=#4D4D4D>dark grey</font>.
-<DT> <CODE>color,proc</CODE>
+<DT> <CODE>::tkcon::COLOR(proc)</CODE>
<DD> The foreground color of a recognized proc, if command highlighting is on.
Defaults to <font color=#008800>dark green</font>.
-<DT> <CODE>color,var</CODE>
+<DT> <CODE>::tkcon::COLOR(var)</CODE>
<DD> The background color of a recognized var, if command highlighting is on.
Defaults to <font color=#FFC0D0>pink</font>.
-<DT> <CODE>color,prompt</CODE>
+<DT> <CODE>::tkcon::COLOR(prompt)</CODE>
<DD> The foreground color of the prompt as output in the console.
Defaults to <font color=#8F4433>brown</font>.
-<DT> <CODE>color,stdin</CODE>
+<DT> <CODE>::tkcon::COLOR(stdin)</CODE>
<DD> The foreground color of the stdin for the console.
Defaults to <font color=#000000>black</font>.
-<DT> <CODE>color,stdout</CODE>
+<DT> <CODE>::tkcon::COLOR(stdout)</CODE>
<DD> The foreground color of the stdout as output in the console.
Defaults to <font color=#0000FF>blue</font>.
-<DT> <CODE>color,stderr</CODE>
+<DT> <CODE>::tkcon::COLOR(stderr)</CODE>
<DD> The foreground color of stderr as output in the console.
Defaults to <font color=#FF0000>red</font>.
<P>
-<DT> <CODE>autoload</CODE>
+<DT> <CODE>::tkcon::OPT(autoload)</CODE>
<DD> Packages to automatically load into the slave interpreter (ie - 'Tk').
This is a list. Defaults to {} (none).
-<DT> <CODE>blinktime</CODE>
+<DT> <CODE>::tkcon::OPT(blinktime)</CODE>
<DD> The amount of time (in millisecs) that braced sections should
<I>blink</I> for. Defaults to 500 (.5 secs), must be at least 100.
-<DT> <CODE>blinkrange</CODE>
+<DT> <CODE>::tkcon::OPT(blinkrange)</CODE>
<DD> 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).
-<DT> <CODE>buffer</CODE>
+<DT> <CODE>::tkcon::OPT(buffer)</CODE>
<DD> The size of the console scroll buffer (in lines).
Defaults to 512.
-<DT> <CODE>calcmode</CODE>
+<DT> <CODE>::tkcon::OPT(calcmode)</CODE>
<DD> Whether to allow <CODE>expr</CODE> commands to be run at the command
line without prefixing them with <CODE>expr</CODE> (just a convenience).
-<DT> <CODE>cols</CODE>
+<DT> <CODE>::tkcon::OPT(cols)</CODE>
<DD> Number of columns for the console to start out with. Defaults to 80.
-<DT> <CODE>dead</CODE>
+<DT> <CODE>::tkcon::OPT(dead)</CODE>
<DD> What to do with dead connected interpreters. If <CODE>dead</CODE>
is <i>leave</i>, TkCon automatically exits the dead interpreter. If
<CODE>dead</CODE> is <i>ignore</i> then it remains attached waiting for
the interpreter to reappear. Otherwise TkCon will prompt you.
-<DT> <CODE>font</CODE>
+<DT> <CODE>::tkcon::OPT(exec)</CODE>
+<DD> This corresponds to the <CODE>-exec</CODE> option above
+
+<DT> <CODE>::tkcon::OPT(font)</CODE>
<DD> Font to use for tkcon text widgets (also specified with -font).
Defaults to the system default, or a fixed width equivalent.
-<DT> <CODE>history</CODE>
+<DT> <CODE>::tkcon::OPT(history)</CODE>
<DD> The size of the history list to keep. Defaults to 48.
-<DT> <CODE>hoterrors</CODE>
+<DT> <CODE>::tkcon::OPT(hoterrors)</CODE>
<DD> 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.
-<DT> <CODE>library</CODE>
+<DT> <CODE>::tkcon::OPT(library)</CODE>
<DD> The path to any tcl library directories (these are appended to the
auto_path when the after the resource file is loaded in).
-<DT> <CODE>lightbrace</CODE>
+<DT> <CODE>::tkcon::OPT(lightbrace)</CODE>
<DD> Whether to use the brace highlighting feature or not
(respectively 1 or 0, defaults to 1).
-<DT> <CODE>lightcmd</CODE>
+<DT> <CODE>::tkcon::OPT(lightcmd)</CODE>
<DD> Whether to use the command highlighting feature or not
(respectively 1 or 0, defaults to 1).
-<DT> <CODE>maineval</CODE>
+<DT> <CODE>::tkcon::OPT(maineval)</CODE>
<DD> A tcl script to execute in the main interpreter after the slave
interpreter is created and the user interface is initialized.
-<DT> <CODE>nontcl</CODE>
+<DT> <CODE>::tkcon::OPT(maxmenu)</CODE>
+<DD> 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.
+
+<DT> <CODE>::tkcon::OPT(nontcl)</CODE>
<DD> 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 <A HREF="nontcl.html">notes for non-Tcl
based Tk interpreters</A>.
-<DT> <CODE>prompt1</CODE>
+<DT> <CODE>::tkcon::OPT(prompt1)</CODE>
<DD> Like tcl_prompt1, except it doesn't require you use '<CODE>puts</CODE>'.
No equivalent for tcl_prompt2 is available (it's unnecessary IMHO).
<BR>Defaults to {([file tail [pwd]]) [history nextid] % }.
-<DT> <CODE>rcfile</CODE>
-<DD> Name of the resource file. <CODE>$env(HOME)</CODE> is prepended to
-this. Defaults to <CODE>.tkconrc</CODE> on Unix and <CODE>tkcon.cfg</CODE>
-otherwise.
-
-<DT> <CODE>rows</CODE>
+<DT> <CODE>::tkcon::OPT(rows)</CODE>
<DD> Number of rows for the console to start out with. Defaults to 20.
-<DT> <CODE>scollypos</CODE>
+<DT> <CODE>::tkcon::OPT(scollypos)</CODE>
<DD> Y scrollbar position. Valid values are <CODE>left</CODE> or
<CODE>right</CODE>. Defaults to <CODE>left</CODE>.
-<DT> <CODE>showmenu</CODE>
+<DT> <CODE>::tkcon::OPT(showmenu)</CODE>
<DD> Show the menubar on startup (1 or 0, defaults to 1).
-<DT> <CODE>showmultiple</CODE>
+<DT> <CODE>::tkcon::OPT(showmultiple)</CODE>
<DD> Show multiple matches for path/proc/var name expansion
(1 or 0, defaults to 1).
-<DT> <CODE>slaveeval</CODE>
+<DT> <CODE>::tkcon::OPT(slaveeval)</CODE>
<DD> 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:
lappend auto_path .
}</PRE>
-<DT> <CODE>slaveexit</CODE>
+<DT> <CODE>::tkcon::OPT(slaveexit)</CODE>
<DD> Allows the prevention of <CODE>exit</CODE> in slaves from exitting
the entire application. If it is equal to <CODE>exit</CODE>, exit will
exit as usual, otherwise it will just close down that interpreter (and
any children). Defaults to <VAR>close</VAR>.
-<DT> <CODE>subhistory</CODE>
+<DT> <CODE>::tkcon::OPT(subhistory)</CODE>
<DD> 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
<P>
An <b>example TkCon resource file</b> might look like:
-
-<PRE>######################################################
+
+<PRE style="color: #883333">######################################################
## 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
######################################################</PRE>
<p>
+</DIV>
+</TD></TR></TABLE>
<HR NOSHADE SIZE=1>
<ADDRESS><FONT SIZE=2>©
--- /dev/null
+<style type="text/css">
+
+/* default formatting
+ *
+ * we should be able to combine these as body,td,... but IE 5 isn't
+ * isn't standard compliant... (sigh)
+ */
+body {
+ font-family: Arial, Helvetica, sans-serif;
+ font-size: 10pt;
+}
+td {
+ font-family: Arial, Helvetica, sans-serif;
+ font-size: 10pt;
+}
+th {
+ font-family: Arial, Helvetica, sans-serif;
+ font-size: 10pt;
+ font-style: bold;
+ text-align: left;
+}
+p {
+ font-family: Arial, Helvetica, sans-serif;
+ font-size: 10pt;
+}
+ul {
+ font-family: Arial, Helvetica, sans-serif;
+ font-size: 10pt;
+}
+a { text-decoration: none }
+.hi {
+ font-weight: bold;
+ color: #B82619;
+ background: #FFFFCC;
+ text-decoration: none;
+}
+.hi2 {
+ font-weight: bold;
+ color: #B82619;
+ background: #CCFFCC;
+ text-decoration: none;
+}
+.indent { margin: 3px; }
+
+/* general styles */
+.heading {
+ font-family: Arial, Helvetica, sans-serif;
+ font-size: 14pt;
+ font-weight: bold;
+ color: #B82619;
+}
+.subheading {
+ font-family: Arial, Helvetica, sans-serif;
+ font-size: 10pt;
+ font-weight: bold;
+ color: #B82619;
+}
+
+.err {
+ font-weight: bold;
+ color: #B82619;
+}
+.smallText{
+ font-size: 10px;
+}
+.notsosmallText {
+ font-size: 11px;
+}
+
+/* unordered list without bullets */
+ul.sans {
+ list-style-type: none;
+ list-style-postition: inside;
+}
+
+</style>
<HTML>
<HEAD>
-<TITLE>TkCon: tkcon procedure</TITLE>
+<TITLE>tkcon: tkcon procedure</TITLE>
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="./style.css">
</HEAD>
<BODY BGCOLOR=#FFFFFF>
-<H1>TkCon: <CODE>tkcon</CODE> procedure</H1>
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=0 BGCOLOR=#000000><TR><TD>
+<!-- start header info -->
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=#FFFFFF>
<TR>
-<TD BGCOLOR=#FFFF33><B><A HREF="index.html">TkCon Docs</A></B></TD>
-<TD><B><A HREF="purpose.html">Purpose & Features</A></B></TD>
-<TD><B><A HREF="limits.html">Limitations</A></B></TD>
-<TD><B><A HREF="todo.html">To Do</A></B></TD>
-</TR>
-<TD><B><A HREF="changes.txt">Changes</A></B></TD>
-<TD><B><A HREF="license.terms">License Terms</A></B></TD>
-<TD COLSPAN=2><B><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></B></TD>
+<TH><FONT SIZE=+3>tkcon: <CODE>tkcon</CODE> procedure</FONT></TH>
+<TD align=right>
+<A href="http://tkcon.sourceforge.net/">
+<IMG src="http://sourceforge.net/sflogo.php?group_id=11462&type=1" width="88"
+height="31" border="0" alt="SourceForge Logo"></A>
+</TD>
</TR>
</TABLE>
+<!-- end header info -->
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+</TD></TR><TR><TD>
+<!-- start main navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#CCCCCC width=100%>
<TR>
-<TD><B><A HREF="start.html">Getting Started</A></B></TD>
-<TD><B><A HREF="bindings.html">Special Bindings</A></B></TD>
-<TD><B><A HREF="procs.html">Procedures</A></B></TD>
+<TH CLASS="hi"><A HREF="index.html" CLASS="hi">Documentation</A></TH>
+<TH><A HREF="purpose.html">Purpose & Features</A></TH>
+<TH><A HREF="limits.html">Limitations</A></TH>
+<TH><A HREF="todo.html">To Do</A></TH>
+<TH><A HREF="license.terms">License</A></TH>
+</TR><TR>
+<TH COLSPAN=2><A HREF="plugin.html">Online Demo</A>
+(requires <A HREF="http://tcl.activestate.com/software/plugin/">Tk plugin</A>)</TH>
+<TH COLSPAN=3><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></TH>
</TR>
+</TABLE>
+<!-- end main navigation table -->
+</TD></TR><TR><TD>
+<!-- start secondary navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#BBBBBB width=100%>
<TR>
-<TD><B><A HREF="dump.html"><CODE>dump</CODE></A></B></TD>
-<TD BGCOLOR=#CCFF99><B><A HREF="tkcon.html"><CODE>tkcon</CODE></A></B></TD>
-<TD><B><A HREF="idebug.html"><CODE>idebug</CODE></A></B></TD>
-<TD><B><A HREF="observe.html"><CODE>observe</CODE></A></B></TD>
+<TH><A HREF="start.html">Getting Started</A></TH>
+<TH><A HREF="bindings.html">Special Bindings</A></TH>
+<TH><A HREF="procs.html">Procedures</A></TH>
+<TH><A HREF="demopic.gif">Screenshot</A></TH>
+</TR>
+<TR>
+<TH><A HREF="dump.html"><CODE>dump</CODE></A></TH>
+<TH CLASS="hi2"><A HREF="tkcon.html" CLASS="hi2"><CODE>tkcon</CODE></A></TH>
+<TH><A HREF="idebug.html"><CODE>idebug</CODE></A></TH>
+<TH><A HREF="observe.html"><CODE>observe</CODE></A></TH>
</TR>
</TABLE>
-
+<!-- end secondary navigation table -->
+</TD></TR><TR><TD BGCOLOR=#FFFFFF>
+<DIV CLASS="indent">
<P>
This provides lots of useful control over a console:
<DL>
-<DT> <CODE>tkcon attach</CODE> <I>interpreter</I>
+<DT> <CODE>tkcon <b>attach</b></CODE> <I>interpreter</I>
<DD> Attaches TkCon to the named interpreter. The name must be that
returned by <CODE>[tk appname]</CODE> or a valid path to a slave
interpreter. It's best to use this via the <CODE>Console->Attach
Console</CODE> menu.
-<DT> <CODE>tkcon buffer</CODE> ?<I>size</I>?
+<DT> <CODE>tkcon <b>buffer</b></CODE> ?<I>size</I>?
<DD> 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).
-<DT> <CODE>tkcon bgerror</CODE> ?<I>msg errorInfo</I>?
+<DT> <CODE>tkcon <b>bgerror</b></CODE> ?<I>msg errorInfo</I>?
<DD> Does bgerror stuff in the TkCon master interpreter.
-<DT> <CODE>tkcon close</CODE> or <CODE>tkcon destroy</CODE>
+<DT> <CODE>tkcon <b>close</b></CODE> or <CODE>tkcon <b>destroy</b></CODE>
<DD> Destroys this TkCon widget.
-<DT> <CODE>tkcon console</CODE> <I>args</I>
+<DT> <CODE>tkcon <b>console</b></CODE> <I>args</I>
<DD> Passes the args to the TkCon text widget (the console).
-<DT> <CODE>tkcon error</CODE>
+<DT> <CODE>tkcon <b>error</b></CODE>
<DD> Pops up a dialog that gives the user a full trace of the last error
received in the TkCon console.
-<DT> <CODE>tkcon find</CODE> <I>string ?-case TCL_BOOLEAN
+<DT> <CODE>tkcon <b>find</b></CODE> <I>string ?-case TCL_BOOLEAN
-regexp TCL_BOOLEAN?</I>
<DD> Highlights all instances of <I>string</I> in the console. If the string
is empty, it clears any previous highlighting.
-<DT> <CODE>tkcon font</CODE> ?<I>fontname</I>?
+<DT> <CODE>tkcon <b>font</b></CODE> ?<I>fontname</I>?
<DD> Sets or returns the font used by tkcon text widgets.
-<DT> <CODE>tkcon gets</CODE> ?<I>varname</I>?
+<DT> <CODE>tkcon <b>gets</b></CODE> ?<I>varname</I>?
<DD> Behaves like the traditional Tcl <code>gets</code>, but uses the
TkCon console instead of <code>stdin</code>.
-<DT> <CODE>tkcon hide</CODE>
+<DT> <CODE>tkcon <b>hide</b></CODE>
<DD> Withdraw the TkCon display from the screen (make sure you have
a way to get it back).
-<DT> <CODE>tkcon history</CODE> ?<i>-newline</i>?
+<DT> <CODE>tkcon <b>history</b></CODE> ?<i>-newline</i>?
<DD> Displays the TkCon history in sourceable form. If <i>-newline</i> is
specified, it separates each command by an extra newline.
-<DT> <CODE>tkcon iconify</CODE>
+<DT> <CODE>tkcon <b>iconify</b></CODE>
<DD> Iconifies the TkCon display.
-<DT> <CODE>tkcon load</CODE> <I>filename</I>
+<DT> <CODE>tkcon <b>load</b></CODE> <I>filename</I>
<DD> Sources named file into the slave interpreter. If no filename is
given, it will attempt to call <CODE>tk_getOpenFile</CODE> to pop up the
file select box.
-<DT> <CODE>tkcon main</CODE> ?<I>arg arg ...</I>?
+<DT> <CODE>tkcon <b>main</b></CODE> ?<I>arg arg ...</I>?
<DD> Passes the args to the main TkCon interpreter to be evaluated and
returns the result.
-<DT> <CODE>tkcon master</CODE> <I>args</I>
+<DT> <CODE>tkcon <b>master</b></CODE> <I>args</I>
<DD> Passes the args to the master interpreter to be evaluated and
returns the result.
-<DT> <CODE>tkcon new</CODE>
+<DT> <CODE>tkcon <b>new</b></CODE>
<DD> Creates a new TkCon widget.
-<DT> <CODE>tkcon save</CODE> ?<I>filename</I> ?<I>type</I>??
+<DT> <CODE>tkcon <b>save</b></CODE> ?<I>filename</I> ?<I>type</I>??
<DD> Saves the console buffer to the given filename. If no filename is
given, it will attempt to call <CODE>tk_getSaveFile</CODE> 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.
-<DT> <CODE>tkcon set</CODE> <I>var ?value?</I>
+<DT> <CODE>tkcon <b>set</b></CODE> <I>var ?value?</I>
<DD> Queries or sets a master interpreter variable.
-<DT> <CODE>tkcon append</CODE> <I>var ?value?</I>
+<DT> <CODE>tkcon <b>append</b></CODE> <I>var ?value?</I>
<DD> Like set, but uses <CODE>append</CODE> on the variable.
-<DT> <CODE>tkcon lappend</CODE> <I>var ?value?</I>
+<DT> <CODE>tkcon <b>lappend</b></CODE> <I>var ?value?</I>
<DD> Like set, but uses <CODE>lappend</CODE> on the variable.
-<DT> <CODE>tkcon show</CODE> or <CODE>tkcon deiconify</CODE>
+<DT> <CODE>tkcon <b>show</b></CODE> or <CODE>tkcon deiconify</CODE>
<DD> Redisplays TkCon on the screen.
-<DT> <CODE>tkcon slave</CODE> ?<I>slavename ?arg arg ...?</I>?
+<DT> <CODE>tkcon <b>slave</b></CODE> ?<I>slavename ?arg arg ...?</I>?
<DD> 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 <CODE>[tk appname]</CODE>
of that interpreter.
-<DT> <CODE>tkcon title</CODE> ?<I>title</I>?
+<DT> <CODE>tkcon <b>title</b></CODE> ?<I>title</I>?
<DD> Sets or returns the title for TkCon.
-<DT> <CODE>tkcon version</CODE>
+<DT> <CODE>tkcon <b>version</b></CODE>
<DD> Returns of version of TkCon.
</DL>
+</DIV>
+</TD></TR></TABLE>
<HR NOSHADE SIZE=1>
<ADDRESS><FONT SIZE=2>©
<HTML>
<HEAD>
-<TITLE>TkCon: To Do Ideas</TITLE>
+<TITLE>tkcon: To Do Ideas</TITLE>
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="./style.css">
</HEAD>
<BODY BGCOLOR=#FFFFFF>
-<H1>TkCon: To Do Ideas</H1>
-<TABLE COLS=4 BORDER=0 CELLPADDING=1 CELLSPACING=3 BGCOLOR=#CCCCCC>
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=0 BGCOLOR=#000000><TR><TD>
+<!-- start header info -->
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=#FFFFFF>
<TR>
-<TD><B><A HREF="index.html">TkCon Docs</A></B></TD>
-<TD><B><A HREF="purpose.html">Purpose & Features</A></B></TD>
-<TD><B><A HREF="limits.html">Limitations</A></B></TD>
-<TD BGCOLOR=#FFFF33><B><A HREF="todo.html">To Do</A></B></TD>
+<TH><FONT SIZE=+3>tkcon: To Do Ideas</FONT></TH>
+<TD align=right>
+<A href="http://tkcon.sourceforge.net/">
+<IMG src="http://sourceforge.net/sflogo.php?group_id=11462&type=1" width="88"
+height="31" border="0" alt="SourceForge Logo"></A>
+</TD>
</TR>
-<TD><B><A HREF="changes.txt">Changes</A></B></TD>
-<TD><B><A HREF="license.terms">License Terms</A></B></TD>
-<TD COLSPAN=2><B><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></B></TD>
+</TABLE>
+<!-- end header info -->
+
+</TD></TR><TR><TD>
+<!-- start main navigation table -->
+<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2 BGCOLOR=#CCCCCC width=100%>
+<TR>
+<TH><A HREF="index.html">Documentation</A></TH>
+<TH><A HREF="purpose.html">Purpose & Features</A></TH>
+<TH><A HREF="limits.html">Limitations</A></TH>
+<TH CLASS="hi"><A HREF="todo.html" CLASS="hi">To Do</A></TH>
+<TH><A HREF="license.terms">License</A></TH>
+</TR><TR>
+<TH COLSPAN=2><A HREF="plugin.html">Online Demo</A>
+(requires <A HREF="http://tcl.activestate.com/software/plugin/">Tk plugin</A>)</TH>
+<TH COLSPAN=3><A HREF="nontcl.html">Using TkCon with other Tk Languages</A></TH>
</TR>
</TABLE>
+<!-- end main navigation table -->
+</TD></TR><TR><TD BGCOLOR=#FFFFFF>
+<DIV CLASS="indent">
<H3>Future Ideas</H3>
<UL>
<LI> You tell me...
</UL>
+</DIV>
+</TD></TR></TABLE>
+
<HR NOSHADE SIZE=1>
<ADDRESS><FONT SIZE=2>©
<A HREF="mailto:jeff.hobbs@acm.org">Jeffrey Hobbs</A></FONT></ADDRESS>
<HTML>
<HEAD>
<TITLE>Enhanced Tk Console: tkcon</TITLE>
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="docs/style.css">
</HEAD>
<BODY BGCOLOR=#FFFFFF>
-<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0>
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=0 BGCOLOR=#000000><TR><TD>
+<!-- start header info -->
+<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=#FFFFFF>
<TR>
-<TD><H1>Enhanced Tk Console: tkcon</H1></TD>
+<TD><FONT SIZE=+3><B>Enhanced Tk Console: tkcon</B></FONT></TD>
<TD align=right>
-<A href="http://sourceforge.net/projects/tkcon/">
+<A href="http://tkcon.sourceforge.net/">
<IMG src="http://sourceforge.net/sflogo.php?group_id=11462&type=1" width="88"
height="31" border="0" alt="SourceForge Logo"></A>
</TD>
</TR>
</TABLE>
+<!-- end header info -->
-<TABLE WIDTH=100% BORDER=0 CELLSPACING=2 CELLPADDING=3 BGCOLOR=#DDDDDD>
-<TR>
-
-<TD> <A HREF="docs/index.html">tkcon Documentation</A> </TD>
-<TD> <A HREF="docs/license.terms">License (bourbon ware)</A> </TD>
+</TD></TR><TR><TD>
-</TR><TR>
+<TABLE WIDTH=100% BORDER=1 CELLSPACING=2 CELLPADDING=2 BGCOLOR=#DDDDDD>
+<TR>
-<TD> <A HREF="docs/demopic.gif">Screenshot</A> </TD>
-<TD> <A HREF="docs/plugin.html">Online Demo!</A> (requires
-<A HREF="http://dev.scriptics.com/software/plugin/">Tk plugin</A>) </TD>
+<TH><A HREF="docs/index.html">Documentation</A></TH>
+<TH><A HREF="docs/demopic.gif">Screenshot</A></TH>
+<TH><A HREF="docs/plugin.html">Online Demo!</A> (requires
+<A HREF="http://tcl.activestate.com/software/plugin/">Tk plugin</A>)</TH>
+<TH><A HREF="docs/license.terms">License</A> </TH>
</TR><TR>
-<TD COLSPAN=2>
+<TD COLSPAN=4>
<A HREF="ftp://tkcon.sourceforge.net/pub/tkcon/">Release Archives</A>
<P>
-<B><PRE STYLE="color: #990033;">Last full release (v1.6, April 1999):
+<B><PRE STYLE="color: #990033;">Last full release (v2.1, May 4 2001):
140159 Apr 1 11:52 tkcon.tcl
86045 Apr 1 12:50 tkcon.tar.gz</PRE></B>
</P>
<P>
You can grab the latest sources from the
-<A HREF="http://cvs.sourceforge.net/cgi-bin/cvsweb.cgi/tkcon/?cvsroot=tkcon"><B>tkcon CVS repository</B></A>
+<A HREF="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/tkcon/tkcon/"><B>tkcon CVS repository</B></A>
(currently v2.1alpha).
</P>
</TD>
</TR>
</TABLE>
+</TD></TR></TABLE>
<P STYLE="font-family: arial, sans-serif">
tkcon is a replacement for the standard console that comes with Tk (on
<HR NOSHADE SIZE=1>
<ADDRESS><FONT SIZE=2>©
-<A HREF="mailto:jeff.hobbs@acm.org">Jeffrey Hobbs</A></FONT></ADDRESS>
+<A HREF="mailto:jeff@hobbs.org">Jeffrey Hobbs</A></FONT></ADDRESS>
</BODY>
</HTML>
projects / tkcon / commitdiff