$Id: COMPILE,v 1.2 2004/08/17 10:12:54 neumann Exp $ ******************************************************** XOTcl Compilation Guide (Unix) ******************************************************** Note, that there is a file "COMPILE.win" describing Windows compilation. Read this file, if you plan to build XOTcl under Windows. First, you have to get the necessary sources: - Before you can start, you have to get the full sources of XOTcl. These are packed in a tar.gz file, like xotcl-XXXXX.tar.gz, and they are available from: http://www.xotcl.org - To compile XOTcl the sources of Tcl (and optionally Tk) are needed. Tcl (and optionally Tk) must be installed properly. You get the Tcl/tk sources from: www.tcl.tk The best is to unpack and compile Tcl (and optionally Tk) in the same directory as XOTcl, so that XOTcl's configure can find it automatically. For compilation instruction see Tcl's documentation. 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 unix directory: cd xotcl* ./configure on some platforms (e.g. under Windows Environment with CygWin) you may have to type in "sh configure" explicitly. If you have Tcl, Tk, and XOTcl built in your home directory and you want to install in standard locations, a simple configure without arguments should be sufficient. 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-actiweb Build Actiweb packages as well (sdbm, expat) (per default deactivated) --with-xotclsh Build xotclsh (per default deactivated) --with-xwish Build xowish (per default deactivated) --with-gdbm=GDBM_INCLUDE_DIR,GDBM_LIB_DIR absolute path to gdbm.h and optionally the path to the gdbm library. The directory infos may be omitted --with-tcl=DIR Where to find a compiled Tcl version, i.e. where to find tclConfig.sh Note that you need a source built of Tcl (including generic/tclInt.h)! --with-tk=DIR Where to find a Tk version, i.e. where to find tkConfig.sh. An installed version is sufficient. It must be the same Tk version as the version of the used Tcl. --with-tk-include=DIR directory containing the public Tk header files --with-all Turns on all options (actiweb, gdbm, xotclsh, xowish) NOTE: the directories specified by DIR should not be addressed relatively: be sure to use only absolute path names (those starting with "/") only. NOTE: Tcl (and Tk if you build xowish) have to be installed. You require a Tcl source build (of the same version as installed) as well. Example: ./configure --prefix=/usr --exec-prefix=/usr --with-all --enable-threads 3) now you can make XOTcl and the configured packages with make which should be actually a GNU make (sometimes called gmake). There are a couple of compiler options, that can make the compiled binary faster. On a Pentium 4 PC under Linux, i would recommend to compile with make CFLAGS_DEFAULT='-O3 -mcpu=i686 -Wall -fomit-frame-pointer' 4) install with: make install If you only want to build/install xotcl/xowish without packages you can switch to xotcl-XXX 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@wu-wien.ac.at, zdun@xotcl.org gustaf.neumann@wu-wien.ac.at, neumann@xotcl.org