Required tools for installation
unzip utility which may be down loaded from
http://www.cdrom.com/pub/infozip

List of zipped files of XBIT 4.0 package

xbit76_40.zip   Windows DLL for Tcl76p2/Tk4.2 
xbit80_40.zip   Windows DLL for Tcl8.0/Tk8.0  
xbit81_40.zip   Windows DLL for Tcl8.1/Tk8.1  
xbit82_40.zip   Windows DLL for Tcl8.2/Tk8.2  
xbit83_40.zip   Windows DLL for Tcl8.3/Tk8.3  
xbit84_40.zip   Windows DLL for Tcl8.4/Tk8.4  

xbitlib_40.zip  script libraries
xbitdoc_40.zip  documentation and bitmaps used in XBIT

imagery0.zip    image data for XBit demo program
imagery1.zip    image data for XBit demo program
imagery2.zip	image data for XBit demo program

Installation and run

1) create an xbit-home-directory
2) unzip the zipped files in the xbit-home-directory
3) run XBIT:
   wish xbitinit.tcl

The XBit demo program requires imagery0.zip, imagery1.zip and
imagery2.zip files down loaded and unzipped at the home directory
of XBIT.
  
Usage of XBIT

Tcl global variable: XBIT needs a Tcl global variable gimgHome
to be set to the home directory of the XBIT.

XBIT Entries: A DLL of XBIT has two entries: Console_Init and
Xbit_Init. 

If XBIT is loaded from Console_Init, e.g., 

        load xbit80.dll Console

the built-in XBIT Console will replace the standard wish shell,
An XBit Console supports Tcl standard I/O channels by providing
stdin, stdout, and stderr. The script

        set input [gets stdin]

will accept an XBit Console's input line typed in from the
keyboard.

When running XBIT from the command line, i.e.,

        wish84 xbitinit.tcl     or
        wish83 xbitinit.tcl     or
        wish82 xbitinit.tcl     or
        wish81 xbitinit.tcl     or
        wish80 xbitinit.tcl     or
        wish42 xbitinit.tcl

the Tcl scripts of xbitinit.tcl will automatically set the gimgHome
to the path of the xbit-home-directory, and invoke the load command
to link the right DLL file of XBIT from the entry of Console_Init.
Under the menu Program of a XBIT console, there is an entry of
"Install XBit Package with Console" for XBIT package installation. 
It installs XBIT using the script file "xbitpkg.tcl", which loads 
the XBIT DLL from the home directory of XBIT, and calls the function 
Xbit_Init. Another entry of installation is "Install XBit with Console",
which will install XBit and enhance the original Tk console via 
stdio channels supported by XBit.

Without installation, one may load xbit manually using Tcl load
command, e.g.,

        load xbit80.dll Xbit

Before loading an XBit dll, one may set env(xbitConsole) to either
"yes" or "no", which will flag the loaded XBit dll to either enhance
or not enhance the original Wish console.

