
This is INSTALL for release 1.3 of shapeTools

It describes how to build and install the shape toolkit on your
computer. Please read the file "LICENSE" before installing and using
the shape toolkit on your machine.


The build/installation procedure
================================

The first time you call "make" in this directory (the root directory
of the shapeTools source tree), make invokes a configuration script
asking you a few questions about the environment where shapeTools is
to be built and installed. You will be asked for:

- the operation system of your machine.
	See the following section for a list of supported operating
	system platforms.
- the locations, where executables and manuals shall be installed.
	Make sure that there are subdirectories man1, man7 and man8 at
	the location where the manuals shall be copied to

Subsequent calls of "make" will not run the configuration script
again automatically. Type

	make config	to run the script again and change the
			configuration of the build/install procedure

	make		to build shapeTools
	make install	to install the manuals and executables
	make clean	to clean up


Supported Operating System Platforms
====================================

Our current development platform is Sun4/SunOS 4.1.1. We ported to and
tested the toolkit to a certain number of other machines. This is the
complete list of supported operating system platforms:

	s-aix      -- AIX (tested on IBM RS6000 with AIX 3.1)
	s-bsd_4_3  -- BSD 4.3 (tested on DEC microVax II with BSD 4.3)
		      see section "Hints and Troubleshooting" below
	s-hpux     -- HP/UX (tested on HP 9000 with HP/UX 7.0)
	s-irix	   -- IRIX (tested on Silicon Graphics with IRIX 3.3.1)
		      does not work on IRIX 3.2.1 !
	s-mach	   -- mach (tested on NextStation)
	s-sunos_4  -- SunOS (tested on SUN 4 with SunOs 4.1.2)
	s-svr_3    -- System V Release 3 (tested on Interactive UNIX 2.2)
	s-ultrix_4 -- Ultrix (tested on DECStation 3100 with Ultrix 4.0)

For installing the toolkit on machines with other operating systems
see the file PORTING in this directory.


Hints and Troubleshooting
=========================

When modifying the Makefile manually, make sure to keep at least one
whitespace between equal sign and value in macro definitions. The
configuration script expects this.

On pure BSD systems /bin/sh is not capable to execute scripts
containing shell functions. To use these scripts you have to install
another shell (e.g. BASH). Then change the first line of the script
from "#!/bin/sh" so that the appropriate shell is called.
Currently this applies only to src/vc/vdiff/vdiff.

If you have any problems, drop a mail to: shape@cs.tu-berlin.de

Have fun !
