***************** $Id: README,v 1.5 2000/11/30 18:27:07 neumann Exp $
XOTcl README File
*****************

*******************************
Source Distribution Compilation
*******************************
Read INSTALL for compilation guidance on UNIX or 
INSTALL.win for Windows.


************************************
Installation of Binary Distributions
************************************

For all binary distributions firstly Tcl and Tk must be installed
properly.  All binary distributions require Tcl/Tk 8.0.5 (included in
most Linux distributions), which you can find from:

  http://dev.scriptics.com


Linux Binary Distribution
-------------------------

Per default the linux version install to usr/local and xotcl
directories. If you want to install to these directions, just
  cd /
  tar xvfz xotcl-XXX.tar.gz
otherwise:
  mkdir temp-xotcl
  cd temp-xotcl
  tar xvfz xotcl-XXX.tar.gz
and then copy the file in temp-xotcl/usr/local to your installation
destination and temp-dir/xotcl where you want to have the examples
and documentation.

Make sure that the installed xotclsh/xowish is on your PATH (it can be
found per default in /usr/local/bin on Unix Systems and in the tclsh
installation directory on windows system).  And on Unix
LD_LIBRARY_PATH should be set to the directory where libxotcl can
be found (/usr/local/lib) per default.

If the packages can not be found, try to set the TCLLIBPATH. On
Unix Systems:

csh:  setenv TCLLIBPATH "/usr/local/lib/xotcl/ $(TCLLIBPATH)"
bash: export TCLLIBPATH="/usr/local/lib/xotcl/ $(TCLLIBPATH)"

Windows Binary Release
----------------------

The zip file contains the program files and the examples/apps in the
dir "/xotcl". You need Tcl 8.0 or higher installed properly.  Unzip
the contents of the zip file and you will obtain a directory on the
toplevel called "xotcl". Open a DOS window and change to the directory
via:

  cd xotcl 

Now check where Tcl is installed and how the name of the tclsh***.exe
is. Open a DOS window. You have to invoke the installer with the Tcl
installation directory as argument, e.g. on my platform this is:

  tclsh8.3.exe installWin.tcl /Programme/Tcl

If you ommit the argument, like:

   tclsh80 installWin.tcl

the default "c:\Program~1\Tcl" directory is chosen, which should at
least work on English and German platforms, because on English Windows
distributions this is called "Program Files", in German it is called
"Programme".  If this is fine with you, just leave the default
unchanged, and the files will be installed in the Tcl directory under
the program-directory. (e.g. "Program Files", "Programme", ...).

Then you have to set the PATH to "c:\Program~1\Tcl\bin" and set the
TCLLIBPATH environment variable to where the xotcl/lib dir and the
packages are, like

  set TCLLIBPATH="/Program~1/Tcl/lib/xotcl"

now the packages are configured.

More Infos
----------

More information can be found at:

  http://www.xotcl.org

Please report bugs and problems to the authors under one of these
email adresses:

  uwe.zdun@uni-essen.de
  gustaf.neumann@wu-wien.ac.at

