$Id: s.COMPILE 1.1 01/03/02 23:03:14-00:00 neumann $ 
********************************************************
XOTcl Compilation Guide (Unix)
********************************************************

Note, that there is a src/COMPILE.win for Windows compilation.
Read this, if you plan to build XOTcl under Windows. 

Before you can start, you have to fetch the full sources. These
are
     xotcl-XXXXX.tar.gz

and they available from:

  http://www.xotcl.org


The following steps have to be performed in order to 
build XOTcl:

  1) untar XOTcl in a directory of your choice by using one of:

        gunzip < xotcl-XXXXX.tar.gz | tar -xvf -

     or on some systems:
  
        tar xvfz xotcl-XXXXX.tar.gz
     

  2) run configure by issuing in the root dir:

        ./configure

     on some platforms (e.g. under Windows Environment with 
     CygWin) you have to type in "sh configure" explicitly. 

     Per default configure searches for several packages. You
     can avoid searching/override the settings with 
     the follwoing switches:

     --prefix=DIR                 place where lib/packages are 
                                  to be installed (default: /usr/local)
     --exec-prefix=DIR            place where xotclsh/xowish 
                                  are to be installed (default: /usr/local)
     --with-gdbm=INCDIR,LIBDIR    include dir and lib dir of GNU gdbm (if you
                                  want to build TclGdbm)
     --without-gdbm               disables GDBM compilation
     --with-tcl=INCDIR,LIBDIR     include dir and lib dir of Tcl
     --with-tk=INCDIR,LIBDIR      include dir and lib dir of Tk

     NOTE: the directory information are for the src/Makefile!
           (if you adress them relatively, you must start with ../../) 

     Example:
     
     ./configure --prefix=/usr --exec-prefix=/usr --with-tcl=../../tcl8.0.5/generic,../../tcl8.0.5/unix

     then shells are installed in /usr/bin and libs are installed in /usr/lib 
     and /usr/lib/xotcl. Tcl 8.0.5 from ../tcl8.0.5 is used.

  3) now you can make the XOTcl shell and the package index/libs with

        make

  4) install with:

        make install


  If you only want to build/install xotcl/xowish without packages you can switch to
  the src directory and do there:

        ./configure
        make
        make install

  You can test XOTcl by switching to the src directory and by running:
 
        make test


Good Luck! 

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

  uwe.zdun@uni-essen.de
  gustaf.neumann@uni-essen.de

