***************** $Id: s.README 1.8 01/03/09 13:17:29-00:00 neumann $
XOTcl README File
*****************

**********************************
Compilation of Source Distribution 
*********************************
Read COMPILE for compilation guidance on UNIX or 
COMPILE.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.3 (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 programs xotclsh and xowish can be found
on the PATH of your system.  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
----------------------

You need Tcl 8.3.2 installed properly. If necessary, get Tcl
8.3 for your system from 
  web site:  http://dev.scriptics.com/software/tcltk/downloadnow83.tml
  installer: http://dev.scriptics.com/download/tcl/tcl8_3/tcl832.exe

Now check where Tcl is installed and what the name of the tclsh*.exe
is. If you installed Tcl 8.3.2, the name is tclsh83.exe. On my system
Tcl installs tclsh in c:\Programme\Tcl\bin (in English versions this
is most likely under c:\Program Files\Tcl\bin).

On my system the tcl 8.3.2 installer adds this directory automatically
to the search PATH; if this is not the case on your system, add this
directory manually to your PATH (under NT or Win2K, use: Control
Panel/System/.../Environment; MSDOS-class system use autoexec.bat to
add this directory to the PATH variable by a line like
   SET PATH=c:\Progra~1\Tcl\bin;%PATH%
) and reboot.

Now you should be able now to start the Tcl shell by typing "tclsh83". You
will see the % prompt. To exit the shell, type "exit".

The xotcl*.zip file contains the XOTcl distribution.  Unzip the
contents of the XOTcl zip file on c: to a directory "xotcl."  Open a
DOS box window and change to the XOTcl directory, like:

  c:
  cd \xotcl 

Next, you have to invoke the installer:

   tclsh83 installWin.tcl

The installer tries to install xotcl in the default directory
"\Program~1\Tcl", which should at least work on English and German
platforms (in English Windows distributions the program directory is
called "Program Files", in German versions, it is called "Programme").

If you want to install XOTcl at a different you can specify the target
directory as an argument of the installer:

  tclsh83 installWin.tcl /Programme/Tcl

Now you should be able to start the XOTcl shell by typing "xotclsh";
leave the shell by typing "exit". If xotclsh is not found on your
system, check the setting of PATH (see above).

Finally check, whether the xotcl packages can be located on your
system.  Invoke from the DOS window the XOTcl shell and try to load a
package; type e.g.

  xotclsh
  package require xotcl::trace

If "package require" returns an error, the search heuristics 
do not work for your configuration, and you will have to set the
TCLLIBPATH variable to "C:/PROGRA~1/TCL/lib/xotcl" (under NT or Win2K, 
use: Control Panel/System/.../Environment; MSDOS-class system use 
autoexec.bat to set this environment and reboot).

Please note the slashes, do not use backslashes here!

You can test your installation with:

XOTcl Tests:
  xotclsh src/lib/testx.xotcl
  xotclsh src/lib/testo.xotcl
  xotclsh src/lib/speedtest.xotcl

ACTIWEB Test:
  cd packages
  xotclsh make.xotcl -test

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 addresses:

  uwe.zdun@xotcl.org
  gustaf.neumann@xotcl.org

