
******************************************************************************

                   XIT -- The X User Interface Toolkit
            
           Instructions for Retrieving, Compiling and Loading

      Copyright (c) 1992: Research Group DRUID, Universitaet Stuttgart

******************************************************************************


The following assumes you run Unix and can FTP from
ifi.informatik.uni-stuttgart.de (129.69.211.1).  


Requirements:
==============

The XIT software runs on an Allegro CL platform (current version
4.1). Alternatively, Lucid CL can be used (current version 4.0.2).
However, we have figured out some minor problems with their native
CLOS implementation.

For further details you may contact DRUID directly.

XIT is based on CLX and CLUE. The current versions are CLX R4.5 and
CLUE 7.20. Note that a patched version of CLUE 7.20 is contained in
the clue directory of the XIT distribution. 


FTP:
====

You will need to FTP the software and compile it yourself. No binaries
are supplied. The XIT software and documentation sources take about 4
megabytes of disk space. Therefore, you first need to find a machine
with enough room on the disk, and then create a directory called xit
wherever you want the system to be:
	% mkdir xit
(If you already have a copy of XIT, you might want to move the old contents
of the xit directory somewhere, in case you need to go back.  Otherwise,
delete all the contents of the xit directory.)

Then, cd to the xit directory.
	% cd xit
Now, ftp to 129.69.211.1.  When asked to log in, 
use "ftp", and your name as the password.
   % ftp 129.69.211.1
   
Then change to the xit directory and use binary transfer mode:
	ftp> cd /pub/xit
	ftp> bin

The XIT files have all been combined into a compressed TAR format file for
your convenience. This file will create the appropriate sub-directories  
automatically:
	ftp> get xit.tar.Z

Now you can quit FTP:
	ftp> quit

Now, you will need to uncompress the tar file:
	% uncompress xit.tar.Z

Now, the tar file, you will need to "untar" it, to get all the original
files:
	% tar -xvf xit.tar

This will create subdirectories will all the sources in them.  At this point
you can delete the original tar files, which will free up a lot of disk space:
	% rm xit.tar


The makefiles and defsystem files contain pathnames for all the parts of XIT.
You will now need to edit the files Makefile.* and defsystem.lisp in
the following directories:

   xit/
   xit/xam
   xit/xact

Appropriate entries in the files will direct you how to do this.  

Lisp requires very large address spaces.  We have found on many Unix
systems, that you need to expand the area that it is willing to give
to a process.  The following commands work in many systems.  Type
these commands to the C shell (csh).  You might want to also put these
commands into your .login file.
	% unlimit datasize
	% unlimit stacksize

Now, you will need to compile the XIT sources to make your own binaries.
This is achieved by running the corresponding makefile(s). Please note
that the binaries (5.5MB) and the Lisp image itself (11.7MB) make up another 17
megabytes of disk space.

Further instructions for how to use XIT can be found in the XIT manual.

Thanks again for your interest in XIT, and we hope that it works
well for you. 

   The DRUIDs

