
INTRODUCTORY WAFFLE:

Many of the changes to DiamondBase since version 0.2 have involved streamlining
the installation process.  We would therefore be very interested to hear about
any problems you have installing the program.  We have even gone to fairly
extensive lengths to eliminate warnings from most popular compilers, so we 
would be interested in hearing about any of these.  You can mail the output of
the make process to us directly if you like and we will look at it.

IF YOU HAVE ANY PROBLEMS: 

 (a) Before step 3: mail us using one of
		kevinl@fangorn.cs.monash.edu.au
		darrenp@dibbler.cs.monash.edu.au
		davison@fangorn.cs.monash.edu.au

 (b) Before step 4.
		make -f Makefile.in bug_report

 (c) During compilation or installation.
		make bug_report

  ------------------------------------------------------------
Having said all that, DiamondBase now uses the GNU configure system for 
instllation.  All going according to plan, you should be able to follow
these steps to install:

WHAT YOU REALLY WANT TO KNOW :

 Step 1. Uncompress and untar the distribution.
		 zcat diamond-0.3.tar.Z | tar xf - 

 Step 2. Change into the directory you have just created
		 cd diamond

		 Note that if you decide to rename this directory for any
		 reason, you should create a softlink *within* the directory
		 to itself, so the include files can be found. eg:
		    cd new_diamond_name
			ln -s . diamond

 Step 3. Configure diamondbase, specifying an optional install prefix
		 if you don't want to use /usr/local

		 ./configure --prefix=/users/daz 

		 This would install things in /users/daz/{bin,lib,include} etc
		 The configure script should output details of what it is looking
		 for.  ./configure --help shows all the options, although some
		 features are not used for this configure script.  Note that
		 configure looks for a c++ compiler, and will use g++ (called c++)
		 if it finds it, before cfront.  If you do not wish this, set the
		 CXX environment variable in your shell to your preferred compiler
		 *before* running configure.

 Step 4. make

 Step 5. If you want to use the multi-user capabilities of diamondbase, you
		 need to explicitly build them here.  They make use of inter process
		 communication facilities in UNIX, and they are likely to be less
		 portable than the rest of the package.  It does no harm to try to
		 build them, and we'd be interested to hear about platforms on which
		 this part does not build.

		 make multi

 Step 6. If make experienced any problems, you can make bug_report to tell 
		 us about it.  In particular, you should be able to show us the
		 output from your compilation using:

		 make |& make bug_report

		 Don't you just love unix. Beats spending 30 minutes long distance
		 to the "leading software vendor" to tell them you have a broken
		 pane of glass that you paid too much for.

 Step 7. All going well, you can now install the program:

		 make install

 Step 8. View/Print the documentation and then go and use it happily
		 ever after.

 Thankyou for trying DiamondBase.
