TclCL Change Log

# TclCL: Change History

### TclCL-1.20 Released Sat Oct 29 2011

### tclcl-1.19 Released Sat Mar 10 2007

- Refresh packages, Sun OS compilation patch

### tclcl-1.18 Released Sat Sep 24 2006

- Refresh packages

### TclCL-1.17 Released Sun Oct 2 15:00:00 PDT 2005

- [tomh] Mon Sep 26 21:58:00 PDT 2005
Bumping up version numbers: configure.in.TclCL, configure.in.tcl, configure.in.tk

- [tomh] Sun Sep 25 22:22:00 PDT 2005
Remove configure.in.Tcl because it is in the way for HFS+ file systems. Slight mod to the Tcl include path for Fedora Core 4

- [tomh] Tue Sep 6 21:53:00 PDT 2005
Patch for Mac OS X (XCode 2.1). Contributed by Francesco Gringoli.

- [tomh] Wed Aug 31 18:51 PDT 2005
patches for Debian pre-installed Tcl/Tk, and for building with -Wall and -Werror on gcc-4.0.1 (mainly autoconf fixes). Contributed by Georg Wittenburg and Mathieu Lacage, respectively.

### RELEASE: TclCL-1.16 released Wed Jan 19 12:46:22 PST 2005

- [johnh] Fri Dec 10 08:55:52 PST 2004
tclcl.h modified to build under gcc-3.4.

- [johnh] Tue Aug 17 10:23:48 PDT 2004
autoconf now finds http.tcl automatically for better portability

- [xuanc] Tue Feb 10 21:07:17 PST 2004
Change the default versions in conf/configure.in.{tcl,tk,otcl,TclCL}

- [johnh] Tue Feb 10 17:32:55 PST 2004
Configure changes to support tcl-8.3.5 on Fedora.

### RELEASE: TclCL-1.15 released on Fri Jan 9 14:14:08 PST 2004

- [xuanc] Sun Oct 12 21:35:22 PST 2003
Made changes to config for support to tcl/tk8.4.5 libs

### TclCL-1.0b13[OLD]/tclcl-1.14[NEW]released Fri Feb 14 10:35:27 PST 2003

- [xuanc] Tue Jul 29 11:16:14 PDT 2003
Make tclcl portable to tcl/tk 8.4.3. Change char* to CONST84 char* (or CONST84_RETRUN char * if it is a function return) (these two macros are defined in otcl.h) Change Tcl:result to return const char * rather than char *.

- [johnh] Wed Jul 17 10:18:06 PDT 2002
Re-enabled code to avoid dumping tcl code on errors if there's a LOT of tcl code. (Disabled since Dec-00 by mistake.)

- [Tim Buchheim] Thu Jul 11 17:25:00 PDT 2002
  Fixed Tcl "source" command so filenames with spaces work.

### TclCL-1.0b12[OLD]/tclcl-1.13[NEW] released Wed Apr 10 15:02:43 PDT 2002

- [kclan] Thu Sep 6 12:50:03 PST 2001
  Remove Tcl.h from the tclcl distribution because it causes build problems on Mac OS X and is only around for backwards compatibility with 3-year old code.
- [lim] Thu Aug 2 14:57:03 PDT 2001
Changed PUBLIC and PRIVATE to INSTPROC_PUBLIC and INSTPROC_PRIVATE to avoid conflicts with Solaris header files.
- [lim] Tue Jul 10 16:19:19 PDT 2001
Fixed INSTPROC and PROC so they will compile with recent versions of gcc.

### TclCL-1.0b11[OLD]/tclcl-1.12[NEW] released on Wed May 30 10:11:06 PDT 2001

- [Padma Haldar] Tue Mar 6 12:32:23 PST 2001
  Added bind function for binding TclObjects. Files modified: tclcl.h, Tcl.cc.
- [johnh] Tue Dec 12 10:36:34 PST 2000
Updated config.guess to autoconf's current one.

### TclCL-1.0b10[OLD]/tclcl-1.11[NEW] released on Mon Oct 16 21:01:42 PDT 2000

- [haoboy] Fri Oct 6 11:16:17 PDT 2000
  Add global qualifier to abort() inside TclObject::abort().

- [johnh] Wed Aug 16 21:03:03 PDT 2000
  Tcl::eval(const char*) added (so that ns-2 works with tcltk-8.3).

- [johnh] Tue Aug 8 22:35:02 PDT 2000
  Changes to build with tcltk-8.3 (requires --with-tcl-ver=8.3 on configure line).

- [johnh] Mon Jun 12 15:54:31 PDT 2000
  Errors evaling tcl code now don't dump ALL the code if there's a lot of it (like all the ns code!).

### TclCL-1.0b9[OLD]/tclcl-1.10[NEW] Released on Tue Jan 18 16:19:44 PST 2000

- [haoboy] Fri Apr 14 17:55:41 PDT 2000 Added check in TclObject::create_framevar() so that it will do nothing if the variable already exists in the frame. When the variable does not exist, the 'set var 0' won't change the variable value in C++ because the InstVar link isn't there yet. However, if it's already there (e.g., we have two instvars of the same variable in the same frame), this 'set var 0' will change the C++ variable value, which is not expected. This check disables this incorrect behavior.
- [haoboy] Fri Mar 24 11:41:48 PST 2000 Virtual method abort() as a generic interface to avoid all the 'sprintf(stderr, ...); abort()' stuff.
- [johnh] Tue Jan 4 14:18:32 PST 2000
  Support for delay-bound trace vars added (requiring some reworking of the existing delay-bind APIs).
- [johnh] Fri Nov 19 15:27:44 PST 1999
  NOWRK ifdefs (which conditionalized removing wrk_) are now gone.
- [johnh] Fri Nov 19 15:13:53 PST 1999
  Portability fixes: snprintf decl moved to tclcl-config.h, u_int's removed. (u_int isn't portable... spell it out.)
- [johnh] Wed Oct 27 16:14:36 PDT 1999
  1. get rid of wrk_ in InstVar. This shouldn't affect anyone since it was only used internally. (Saves 32B per bound variable.)

  2. get rid of ios{Width,Precision,Mask} in TracedVar. By default the streams stuff isn't compiled in and no one was using this. (Saves 4B per TracedVar.)

  3. converts tracedvars to use snprintf internally. This is an INCOMPATIBLE change: if you used to call tv->value(foo), you now need to call tv->value(foo, sizeof(foo)).

- [YP] Fri May 28 12:19:23 PDT 1999
  Added support for making some instvars "untouchable": if the variable is set/read a warning message is shown and the execution abort()s. Needed to enforce the use of new names after renaming (see the macro _RENAMED).
- [johnh] Tue Apr 6 09:49:01 PDT 1999
  Better recognition (hopefully) of windows compilers that can't handle long strings in tcl2c++.cc.

### TclCL-1.0b8[OLD]/tclcl-1.9[NEW] Released on Mon Feb 22 17:17:05 PST 1999

- [haoboy] Tue Feb 23 12:04:51 PST 1999
  Fixed bug for tcl2c++.c under SunOS, where ungetc() doesn't function at all for a pipe stream.
- [haoboy] Mon Feb 22 17:14:20 PST 1999
  Added 64-bit integer support (for Solaris, Linux and FreeBSD).
- [YC] Tue Nov 17 10:37:13 PST 1998
  - Added code to the "import from web" mechanism to test whether the cached copies are still up-to-date or not
- [johnh] Mon Nov 16 23:15:08 PST 1998
  Ranlib autoconf support fixed.

### TclCL-1.0b7[OLD]/tclcl-1.8[NEW] Released on Wed Oct 21 18:31:16 PDT 1998

- [johnh] Tue Aug 4 09:15:55 PDT 1998
  Declare snprintf in Tcl.cc (to suppress warnings), enforce length checking in our implementation.
- [johnh] Wed Jul 29 09:49:38 PDT 1998
  Fixed a double-free bug left over from the classinstvars code.
- [YC] Mon Jul 27 15:09:31 PDT 1998
  - "Rewrote" tcl-import.tcl to speed things up. Import from disk while a mash script is running (as opposed to expanded at make-time by mash-1/tcl-expand.tcl) now takes a third of its original time.
  - Added a simple HTTP cache to the import off the web mechanism. It is implemented as Class HTTPCache in tclcl/tcl-http.tcl
- [ACS] Fri Jul 17 12:07:09 PDT 1998
  Fixed bug introduced with classinstvars in which setting an instvar to an empty list resulted in the instvar containing a list containing an empty list instead of just an empty list.

### TclCL-1.0b6[OLD]/tclcl-1.7[NEW] Released on Tue July 7 12:20:00 PST 1998

- [johnh] Thu Jul 2 11:10:03 PDT 1998
  Changed WRK_SMALL_SIZE to 32 (from 64) to save memory.
- [johnh] Wed Jul 1 11:33:30 PDT 1998
  classinstvars support turned on by default (and the ifdef's removed).
- [johnh] Wed Jun 10 18:13:57 PDT 1998
  - No longer link the library to libTcl.
  - snprintf option added for SunOS
- [johnh] Tue Jun 9 21:17:07 PDT 1998
  Better support for delayed binding (nee classinstvars); added some length checking to buffers.

  Delayed binding is only available if you configured tclcl and otcl with the option --enable-tclcl-classinstvar. (When doing so, btw, make sure you've got everyone built the same way, or you'll get random crashes due to mismatched slots in virtual function tables.)

  Delayed binding are a way to do binding between OTcl and C++ that consume memory only when bound variables are actually in use from Tcl. (Normally bound variables consume memory throughout the lifetime of the object.) Delayed binding is therfore useful if you have an object with many instances (for example, an NsObject) whose bound variables are only occationaly used from Tcl (for example, off_cmn_).

  Here's a minimal example of delayed binding:

      class C5 : public TclObject {
      public:
      	C5();
      	virtual int delay_bind_dispatch(const char *varName, const char *localName);
      	virtual void delay_bind_init_all();
      protected:
      	int normal_;
      	int delayed_;
      };

      DEFINE_OTCL_CLASS(C5, "C5")
      {
      }

      C5::C5()
      {
      	bind("normal_", &normal_);
      }

      void
      C5::delay_bind_init_all()
      {
      	delay_bind_init_one("delayed_");
      }

      C5::delay_bind_dispatch(const char *varName, const char *localName)
      {
      	DELAY_BIND_DISPATCH(varName, localName, "delayed_", delay_bind, &delayed_);
      	return TclObject::delay_bind_dispatch(varName, localName);
      }

  From Tcl there should be no visible differences between delayed and normally bound variables.

  The penality for delayed binding is higher run-time cost. Classes with delayed binding incur a search cost proprotional to class hierarchy depth (of that class) and the number of delay-bound variables in that class hierarchy.

  (What happens with delayed binding is that you call the delay_bind_dispatch function for each instvar/set/get, this function percolates up the class hierarchy. (This is basically how command dispatch currently works.) With normal binding each instvar is put in a Tcl_Hash and accessed in O(1) time (but with higher memory requirements).

  For a simple ns run with ~1400 NsObjects (~120 nodes/links/agents) and both of NsObject's variables delay-bound run-time went up ~2% (not clear if this is outside expected error) and memory went down 10%. For larger simulations run-time cost should stay constant memory savings should rise. (If you want to your own benchmarks, my test case was ./ns tcl/ex/many_tcp.tcl -client-arrival-rate 20 -ns-random-seed 1 -mem-trace 1.)

- [johnh] Tue Jun 9 21:17:07 PDT 1998
  - Added support code for classinstvars. Currently this code is only turned on if you do --enable-tclcl-classinstvars when configuring. (Re autoconf'ed.)
  - Moved {Traced,}InstVar::import_instvar to TclObject::create_instvar
  - Shortened wrk_ to 32 bytes.
- [CR] Sun May 31 17:01:21 PDT 1998
  - In Makefile.in, a set of tcl library files are currently packaged with a set of tk library files in the embedded tcl object, et_tk. To include these tcl library files (but not the tk library files) in the smash executable (a.k.a. mash w/out tk), I would like to package them in a separate embedded tcl object, et_tcl. For now, just added et_tcl, but after get ns-developers approval, will remove tcl library files from et_tk. Btw, also added new embedded tcl files, tcl-import.tcl and tcl-http.tcl, to et_tcl.
  - Added ability for mash interpreter to import objects from the web server, as opposed to just local file-server (by specifying the TCLCL_IMPORT_DIRS environment variable).
  - Augmenting mash interpreter's "source" procedure to accept EITHER a URL or local filename
  - Augmenting the mash interpreter's "import" procedure to accept EITHER URLs or local filenames in the importTables it processes
  - Effected files: Tcl/tcl-import.tcl Tcl/Makefile.in Tcl/tcl-object.tcl Tcl/tcl-http.tcl
- [YC] Sun May 31 13:18:56 PDT 1998
  - Added new file tcl-http.tcl. This file includes a class HTTP (and an object Http) that you can use to fetch URLs from the web. This class includes a user interface that is displayed when you are waiting for responses from the web.
- [CR] Mon Apr 6 13:37:46 PDT 1998
  - Added some new features to otcldoc...
    - For objects which acquire default setting from the "-configuration" option of the Class definition, display the defaults in a section of the API page for the Object.
    - Added a section for "Proc Methods" on the API page for each Object for which procs are defined.
    - Added a page, linked from index.html, that lists all of the procs not associated with a particular Object.
    - Fixed "is_tcl_comment" proc to consider lines that start with '#', even if preceeded by whitespace, to be considered comments.
    - Since omitting classes from the class hierarchy could be misleading, now all the subclasses of a class are expanded at every place they occur, thus making the class hierarchy on index.html more accurate. To do this, simply commented out "set mark($c) 1" which was used to prevent a subclass from being outputted to index.html if it had already been outputted earlier on the page.
    - Timestamped all pages outputted.
    - Class definitions are processed w/out restricting their length to a single line.

### TclCL-1.0b5[OLD]/tclcl-1.6[NEW] Released on Tue Jan 27 10:22:59 PST 1998

- [YC] Wed Mar 4 21:36:25 PST 1998
  - Added proc.invoke to otcl. This defines a "nameless" proc on a class and immediately executes it.
- [CR] Tue Feb 17 17:12:39 PST 1998
  - In order to generate some online documentation for WidgetClasses, I added two new options to otcldoc.
    - -i is used to specify the name of the index file. Default = "index.html"
    - -c is used to specify the class being documented. Default = "Class"
  - Added a call to otcldoc using the new options to the Makefile so that doing "make doc" will now generate an additional index file by the name of "widgetindex.tcl"
- [EA] Mon Feb 9 11:57:01 PST 1998
  - Added importLocation to tcl-expand.tcl. This file should contain a list of directories, one on every line. If it is in the local directory it overrides the TCLCL_IMPORT files. This makes overriding the import search path for specific tools a little easier.
- [johnh]Fri Jan 23 13:36:08 PST 1998
  Improved the error message from SplitObject instproc warn-instvar.
- [SM] Fri Jan 2 14:01:45 PST 1998
  - Enhanced the import command to look for modules and the importTable in the colon-separated path list specified by the TCLCL_IMPORT environment variable. If TCLCL_IMPORT is not set, then "." is assumed. This allows us to easily generate scripts outside of the mash build environment --- all you need is a mash interpreter, the tcl source tree (with importTable), and a pointer into it. Note: this is not how the package is distributed but rather how we use to generate scripts.
- [SM] Fri Jan 2 00:16:32 PST 1998
  - Removed options_ hack that was causing aborts with ns and tcl7.6.
  - Removed Import enable proc since we now require import mechanism across all mash scripts (though scripts that use "Import enable" won't flag an error because this just declares an object now).
- [YC] Wed Dec 31 17:47:56 PST 1997
  - Added two new methods to the Object class: proc.public and proc.private. These are the public and private variants of "proc".
  - Added macros PUBLIC, PRIVATE, PROC_PUBLIC and PROC_PRIVATE to tclcl-mappings.h. The first two are the public and private variants of INSTPROC, while the last two are replacements for PROC.
- [YC] Fri Dec 26 18:09:04 PST 1997
  - Added history.tcl and word.tcl to embedded-tk (only for Tcl8.0)
- [TLT] Wed Dec 24 20:18:48 GMT-8:00 1997
  - changed tcl-object.tcl: removed dependency to "cat" command since it does not work in win32; updated Import to work for classes that span multiple files
- [EA] Tue Dec 23 01:05:11 PST 1997
  - Alphabetized index in otcldoc and added OTcl/C++ designation.
- [YC] Mon Dec 22 15:22:42 PST 1997
  - fixed bug in the macro definition for PROC which caused it to not work when there were multiple methods with the same name.
  - fixed the error message that is generated when the constructor for an OTcl object fails, so as to display the actual error rather than a stock "class Foo: constructor failed" message.
- [SM] Mon Dec 22 02:45:27 PST 1997
  - Added support for a simple, java-like import command to tclcl and merged it with vic and all of vic's modules. By default, import directives are ignored so as to not break existing apps. "import" behaves like the tcl source command except it includes the file only once (even when used multiple times) and the OTcl class name is specified instead of the actual file. To facilitate this, import assumes the existence of a file called importTable that contains the mappings (... maybe this should be built on demand). mash-1/mkImportTable creates this table from a list of tcl input files (should move this to tclcl).
- [EA] Mon Dec 22 01:22:05 PST 1997
  - In otcldoc: identified C++, OTcl, and Split classes and documented all the files that the class is defined in.
- [SM] Wed Dec 17 20:10:01 PST 1997
  - Made a bunch of changes to otcldoc to handle C++ method and class documentation. This is less automatic than the OTcl counterpart because it's harder to scan the input file. Thus, we sort of give up and rely upon structured comments. The model is to indicate a class or method def with the tag "" prepended to the equivalent syntax (within a C comment). Then the comment block following this line becomes the html desription. E.g.,

        	/*
        	 *  Class Foo -superclass Bar
        	 * Foo is the base class for all foo-like objects blah blah.
        	 *
        	 *  Foo public run {}
        	 * The run method causes a foo object to start running.
        	 */

  - Factored out Elan's cross-reference hook into a separate proc.
- [EA] Mon Dec 15 23:04:11 PST 1997
  - Added class cross referencing to otcldoc.
- [SM] Mon Dec 15 19:03:49 PST 1997
  - Added a script for transforming OTcl class definitions and structured comments into html documentation. The script, inspired by javadoc, is called otcldoc and resides in the top-level directory. It's still pretty rough and buggy, but shows promise.
- [SM] Mon Dec 15 16:58:32 PST 1997
  - Added change to inherit options_ instance variable, if it exists, from parent from within new.
  - This allows us to easily use inheritence to distribute a configuration database across a hierarchicy of object instances.
- [SM] Sat Dec 13 15:27:25 PST 1997
  - Re-ran autoconf to reflect recent change to configure.in.tcl (so .. is searched before /usr)
  - Added Object::public and Object::private methods as stand-ins for instproc.
- [TLT] Tue Nov 25 00:05:16 GMT-8:00 1997
  - added few more convenient functions to Class Tcl.
- [TLT] Sat Nov 15 17:17:54 PST 1997
  - fixed error output in `SplitObject instproc unknown` so that `errorInfo` will now show the full stack trace when `$self cmd $args` i.e. `TclObject::command` returns an error.
  - add bgerror proc that calls tkerror. bgerror is supposed to replace tkerror in tcl 8.
  - win32: changed makefile.win to use the right flags to link with dll versions of the VC runtime (msvrt.dll).
- [TLT] Mon Oct 6 15:41:10 PDT 1997 Sun Nov 9 02:12:03 PST 1997
  - Add functions: evalObj(), objResult()s
  - change result() in tcl8 to return Tcl_GetStringResult(). This guarantee the right return value since interp->result may not be set right all the time.

### TclCL-1.0b4[OLD]/tclcl-1.5[NEW] Mon Oct 20 21:35:11 PDT 1997

- [TLT] Mon Oct 6 15:41:10 PDT 1997
  - minor changes to get it to compile under windows for tcl/tk 8.0
- [TLT]Sat Sep 27 03:15:27 PDT 1997
  - change Timer::msched to delete the timer handler if token_ is non-zero. This prevents extra dangling timers.
  - add EmbeddedTcl::load(interp) function for loading code into a different interpreter. Used for win32's tkConsole window.
- [YC] Mon Sep 15 14:04:01 PDT 1997
  Incorporated Steve's suggestion to modify the INSTPROC and PROC macros to take only one argument, which is the name of both the C++ and Otcl methods.

### TclCL-1.0b3[OLD]/tclcl-1.4[NEW] Sep 9, 1997

Snapshot for ns-2.0 release.

- [johnh] Tue Sep 9 08:43:36 PDT 1997
  libTclCL.a to libtclcl.a.
- [johnh] Mon Sep 8 17:44:19 PDT 1997
  General libTcl to TclCL changes. make tar, srctar make tclcl-*. Generates libTclCL.a, symlinked to libTcl.a for backwards compatibility.
- [KVa] Mon Sep 8 16:27:28 PDT 1997
  - Added SplitObjectCompare to compare two objects by handle.
    It is useful to use this routine as a command to `lsort` to sort a list of SplitObjects (neeTclObjects) in increasing order, as

                lsort -command SplitObjectCompare {list}

- [SM] Sun Aug 31 03:26:39 PDT 1997
  - Moved the call to TclObject::init from the tclcl-mappings macro into the TclClass object creator. The previous arrangement caused init to be called before TclObject::name_ was set, preventing the init method from calling the Otcl object (although it could get the name out of argv[0], the object was not in the hash table so TclObject::lookup wouldn't work for it). Since TclObject::init is now always called, I changed it to always return TCL_OK (typically the args are passed up to Object anyway).
- [SM] Sat Aug 30 12:20:11 PDT 1997
  - Still trying to get constructor argument passing write. Removed an eval because catch does effectively the same thing (i.e., expands args so that it is properly interpreted as multiple args rather than a list). This is a bit subtle and failed only when null arguments (e.g., "") where present.
- [SM] Fri Aug 29 23:57:41 PDT 1997
  - Changed reaction to the failure of the shadow object creation. Rather than raise a tcl error, the OTcl object is deleted and "new" returns an empty string. This allows the callee to react to a failed "new" call. If the problem is in the OTcl constructor rather than in the actual creation of the C++ shadow, the error is raised as before.
- [SM] Fri Aug 29 22:58:54 PDT 1997
  - Handle expceptional cases more gracefully. Return TCL_ERROR if TclClass constructor fails to create object and add code to tcl-object.tcl to gracefully catch this condition.
  - Change base class name of otcl split object from TclObject to SplitObject and add a backward compat hook for TclObject.
- [SM] Fri Aug 29 11:16:50 PDT 1997
  - Changed TclObject::unknown to invoke Tcl "error" procedure upon encountering an undefined method. Previously, this condition caused the process to exit, often making debugging difficult. Under Tk, "error" raises a pop-up that allows one to dump the call stack, which typically makes debugging much easier.
- [TLT] Wed Aug 27 15:23:03 PDT 1997
  - add compat/win32.c for displayerr function and place holder for future common additions.
  - merged in with gnguyen's new makefile.vc (with patches)
  - add embedded-console for win32 console.
  - renamed the wndclass name to the more unique TclCLWSocket, so that rsdr will work; added some error checking during initialization.
- [EA] Thu Aug 21 12:08:36 PDT 1997
  - Generated new configure scripts from new conf files.
  - Fixed Makefile.in to perform make depend correctly.
- [TLT] Thu Aug 7 13:04:21 PDT 1997
  Changes to make libTcl compile under windows and prepare for transition of the package to tclcl, pronounced Tickle-C-L. It stands for "Tcl Class". Motivation for the change: (1) hard to difference between Tcl and tcl verbally, (2) more importantly, under an OS with case-insensitive filenames like win32, "tcl.h" conflicts with "Tcl.h".
  - moved contents of Tcl.h to tclcl.h. Please make all future changes to tclcl.h. Old "Tcl.h" is retained but it only includes "tclcl.h". Eventually we should get rid of "Tcl.h" completely. All includes in the package has been updated to use "tclcl.h".
  - added compat/gettod.c for gettimeofday function in win32
  - added tclcl-config.h for conditional defines in win32
  - added makefile.vc for windows. do 'nmake -f makefile.vc' to compile to tclcl.lib under windows. (we should change libTcl.* to libtclcl.* in Makefile.in some time later).
- [YC] Tue Aug 5 09:49:56 PDT 1997
  Added macros to the Tcl library to allow automatic definitions of the mappings between TclObjects and OTcl classes
  - The OTCL_MAPPINGS macro defines the mapping between a TclObject class and a corresponding OTcl class. With this definition, the manner in which arguments are passed to the constructor for the object has changed. Instead of parsing the args in subclass_of_TclClass::create, the object is now created with an empty constructor (i.e. subclass_of_TclObject() ). Once the object has been successfully constructed, a new virtual method init(argc, argv) is invoked on that object. The argv array contains some dummy args for argv[0] and argv[1] (whatever were originally passed to some of the elements of argv for the TclClass::create method). The actual args start at argv[2]. Note that this is different from what used to happen for the create method. I made this change so that the structure of the argv array is consistent with the structure that is passed to the command(argc, argv) method. (Please note that this does *not* break any previous code that used the original TclClass's create mechanism to create TclObjects.)
  - INSTPROC defines a mapping between a C++ method and an OTcl method. This mechanism is cleaner than the original single huge command() method. It ensures that all C++ methods are visible thru "$object info instcommands", and allows "$self next" to work even for these C++ methods! Use the argument parsing functions described below to parse out the argv array into individual arguments
  - BEGIN_PARSE_ARGS(argc, argv): start parsing the arguments array
  - ARG(var): parse the next argument into the variable 'var'. Currently, the type of 'var' can be one of int, unsigned int, double, const char *, TclObject *.
  - ARG_DEFAULT(var, default): same as ARG, except you can specify a default value to use if this arg has not been specified in the cmdline
  - END_PARSE_ARGS: clean up at the end of parsing. Check for extra arguments that might have been passed in, and output an error if there are any. Even if your function does not expect any arguments, use BEGIN_PARSE_ARGS and END_PARSE_ARGS at the start of your function to ensure that you check for any spurious args that have been passed into this function
  - Example:

            class TestClass : public TclObject {
            public:
                TestClass();  /* must have this constructor */
        	virtual int init(int argc, const char * const *argv) {
        	    int myarg;

        	    BEGIN_PARSE_ARGS(argc, argv);
        	    ARG(my_arg);
        	    END_PARSE_ARGS;

        	    /* ... use 'myarg' in the initialization of this object */

        	}

        	int func1(int argc, const char * const *argv) {
        	    char *name;
        	    BEGIN_PARSE_ARGS(argc, argv);
        	    ARG(name);
        	    END_PARSE_ARGS;

        	    // ...
        	}

        	int func2(int argc, const char * const *argv) {
        	    BEGIN_PARSE_ARGS(argc, argv);
        	    END_PARSE_ARGS;
        	    // ....
        	}
            }

            OTCL_MAPPINGS(TestClass, "TestClass") {
                INSTPROC(func1, "func1");
        	INSTPROC(func2, "func2");
            }

### libTcl-1.0b2[OLD]/tclcl-1.3[NEW] Jul 25 1997

Snapshot for ns-2.0b17 release.

- [EA] Wed Jul 23 16:01:55 PDT 1997
  Fixed problem in Makefile.in which caused the embedded files to not build correctly. Regenerated configure script.
- [GN] Mon Jul 21 15:12:43 PDT 1997
  Add tracedvar.{h,cc} to implement a tracing mechanism for variables. Each "traced" variables should be initialized with its string name and a TclObject to callback when its value is changed. The callback happens through the TclObject::trace(TracedVar*) method.
- [johnh] Thu Jul 3 15:54:53 PDT 1997
  bug in InstVarBool (preventing set foo_ 1 from working if foo_ was created with bind_bool) fixed.
- [YC] Mon Jun 9 19:27:19 PDT 1997
  Moved the tkvar stuff into Tcl/tcl-object.tcl. Arranged the delete proc to invoke "$object delete_tkvar" to clean up any global tk variables that are associated with this variable

### libTcl-1.0b1[OLD]/tclcl-1.2[NEW] Tue Jun 3 15:42:41 PDT 1997

- [KVa] Tue Jun 3 11:04:11 PDT 1997
  Incorrect memory free patterns in Tcl.cc, cause the occasional leak, reported by purify. In brief, array storage allocated as ``var = new DataType[nelem]'' should be freed as ``delete[] var''.
- [EA] Thu Apr 17 21:54:00 PDT 1997
  Fixed Makefile.in so that you can do a make depend.
- [VP] Wed Apr 16 02:44:32 PDT 1997
  Added new bind routines that allow establishing a linkage between OTcl variables and functions that handle reads to and writes from the corresponding C++ variable. The functions can then be instrumented as desired, for example to log all changes in the value of the C++ variables.
- [KVa] Mon Apr 7 15:45:59 PDT 1997
  Fixed tcl2c++.c to skip over multi-line comments correctly.
  `proc tkerror` will also print its argument string when invoked.
- [SM] Thu Mar 6 00:15:55 PDT 1997
  Changed Tk_* event handling calls to Tcl_* since Tcl now handles the event loop and we don't want to inlclude tk.h if we don't have to.

### libTcl-1.0a6[OLD]/tclcl-1.1[NEW] Feb 3 1997

- [SM] Mon Jan 31 18:59:59 PDT 1997
  Fixed up rate variables so that they are not evaluated in global context. This change allows us to wrapt OTcl instance variables in a rate-variable.

### libTcl-1.0a5 Tue Dec 31 18:01:20 PST 1996

Snapshot to VINT collaborators.

- [SM] Re-arranged configure.in to use shared conf structure.

### libTcl-1.0a3[OLD]/tclcl-1.0[NEW] Sun Nov 10 11:06:46 PST 1996

Snapshot to VINT collaborators.

- [SM] Moved C++ shadow object management into TclObject proper. This allows one to now transparently override the init method of built-in C++ classes. Previously, this would cause the C++ shadow object to not be created (unless explicited wired in).
- [SM] Switched to model where TclClass-defined classes have structured names with the hierarchy delineated by slashes, e.g., a side effect of creating class A/B/C is to create classes A and A/B.
- [SM] Enhanced tcl2c++ to use stdin if no file arguments appear on the command line.
- [SM] Fixed TclObject::init-instvar to search object hierarchy for default value of each C++/OTcl instance variable (rather than just in the respective class).
- [SM] Fixed bug that caused init_instvar to be called before virtual methods were completely filled in. This caused the initial value of bandwidths and times to be misinterpreted as doubles.