This package unpacks into a directory OBST. It contains OBST itself as well
as several OBST tools:
	OBST3-4			OBST version 3-4.2 with the following patches
				applied:
				  - patch.OBST3-4.config#1 
				  - patch.OBST3-4.g++-2.6.0#1
				  - patch.OBST3-4.linux-shlibs#1
	OBST-tutorial-1.3	OBST tutorial version 1.3.5 with the following
				patch applied:
				  - patch.tclOBST-1.2.linux-shlib#1
	STF2-2			Structurer&Flattener version 2-2.3.
	tclOBST-1.2		tclOBST version 1.2.2,
				an interface for embedding OBST in tcl.
	USE-1.0			USE version 1.0.2,
				a graphical support environment for schema
				evolution.

	README			This file.
	psfiles			OBST documentation in postscript format.

	contributions		Additional OBST classes/modules that are not
				part of an `official' OBST package as those
				above;
				provided as is.
	ports			Informations about ports of OBST to platforms
				not (yet) supported by the OBST team;
				provided as is.

As of yet, there is no combined configuration/installation for the above
mentioned packages. Therefore, these packages have to be installed individually.
In doing so, the following dependencies among the packages have to be
observed:
	OBST:		---
	tutorial:	OBST
	STF:		OBST
	tclOBST:	OBST
	USE:		OBST, tclOBST, wish compiled with tclX

Except for the tutorial (see below), the installation of the packages follows
the standard pattern for GNU software, i.e.:
	<unpack>
	configure
	make
	make install

Configuration differs somewhat from the standard GNU configuration, in that
OBST packages feature the concept of configuration files (see the OBST README
on these). They hold parameters to the configuration step and allow thus a
concise documentation of any site-specific configuration steps.
We recommend to use a single such configuration file, say ~/OBST.cnf, and
store this file with the installed OBST tools, along with a log of the UNIX
commands performed during installation.
These data should greatly simplify the installation of future OBST releases.

We also recommend not to install into a catch-all directory such as '/usr/local'
since this will make it very difficult to tell which files belong to which
tool.  In such a case, we recommend instead to install e.g. in
'/usr/local/obst' and then merge all the installed files into e.g.
'/usr/local/bin' via symbolic links:
	cd /usr/local/bin
	ln -s ../obst/bin/* .
A simple 'ls -l' will then identify all files belonging to OBST.

Hence, you should always specify an installation directory via the '--prefix'
option of the configuration script.


The installation for the above mentioned tutorial differs since this package
is intended to be installed in-place, i.e. where you unpacked it. See the
README of the tutorial for the simple commands which will copy the tutorial
to another location.
The tutorial should not be installed at the identical location as OBST, say
/tool/obst. Instead we recommend to use a dedicated (sub)directory, e.g.
/tool/obst/tutorial.

Have fun with OBST,
	the OBST team.
