The TkMegaWidget extension

Copyright (c) 1993 by Sven Delmas
All rights reserved.
See the file COPYRIGHT for the copyright notes.

Changes:
--------
	- Some minor bug fixes.


What is TkMegaWidget ?
----------------------
This small extension to Tk allows the creation of widgets
that are combined by other widgets. It is possible to
attach options and minor commands to this new widget. The
advantage of TkMegaWidget is that the parsing and evaluation
are done in C, which makes the implementation much faster.

It is also possible to use a private interpreter attached to
the megawidget or groups of megawidgets. These private
interpreters can load encrypted files, and can also use a
private widget tree. 


Building a patched wish:
------------------------
	- Please first take a look into the "Portability"
	  section at the bottom. The installation may
	  require a special handling for your system.

        - Unpack the TkMegaWidget distribution, and change
	  into the TkMegaWidget directory.

	- If you have not installed the DES library
	  published by Eric Young yet and want to use the
	  DES encryption, you should go into the libdes
	  subdirectory now and build and install the DES
	  library.

        - Type "./configure" in this directory. This runs a
          configuration script created by GNU autoconf,
          which configures TkMegaWidget for your system and
          creates a Makefile.

        - You should check the generated Makefile and adapt
          it to your needs. TCL_DIR and TK_DIR have to point
          at the directories containing the built libraries
          and headers. It is also possible to select
          additional packages to be included into the wish.

        - If you have built the Tk library with TkPixmap
          support, you have to un comment the corresponding
          statements in the Makefile.

        - Type "make" to build the Tk3.3 wish. You will get
	  an executable named "wish".

        - To build dynamically loadable libraries, un comment
          the corresponding variable in the Makefile and
          type "make dynload". This will build a file named
          "libtkMegaWidget.so". Install this file to a
          directory where your dynamic loading command can
          find it. As this dynamic loading for Tcl is
          currently under development and as it is machine
          dependent, this may not work for your machine.

        - Type "make install" will install the executable,
          the docs and the library files. To only install
          the extension files "make install-extensions" can
          be used.

	- To encrypt or decrypt files, you can use the small
          program called tkencrypt. 

	- The demo.TkMegaWidget directory contains a few
          small examples and test programs for the
          megawidget. 


Portability:
------------
Linux:
	- I made some small changes to the libdes code, to make
	  it portable to Linux.


Availability:
-------------
The TkMegaWidget distribution file is named
TkMegaWidget3.6?.tar.gz or TkMegaWidget3.6?.tar.Z.
The ? represents the current version.
TkMegaWidget is available via anonymous ftp at:
	harbor.ecn.purdue.edu:	pub/tcl/extensions/
	ftp.ibp.fr:		pub/tcl/contrib/extensions/
	nic.funet.fi:		pub/languages/tcl/extensions/
        syd.dit.csiro.au:       pub/tk/contrib/extensions/
	ftp.cs.tu-berlin.de:	pub/tcl/contrib/extensions/

To get a copy of it, just type the following:

	ftp ftp.cs.tu-berlin.de
        bin
	cd pub/tcl/extensions
	get TkMegaWidget3.6?.tar.gz

To get a copy via ftpmail, just send the following mail to:

      	mail-server@cs.tu-berlin.de

To get a help message, send the following body:

	send HELP
	end

To retrieve TkMegaWidget, send the following body:

	send pub/tcl/contrib/extensions/TkMegaWidget3.6?.tar.gz
	end


Feedback (Author):
-----------------
Sven Delmas
TU Berlin, Germany
garfield@cs.tu-berlin.de