# $RCSfile$ $Revision$ $Author$ $Date$

Release 0.13.0 Sun Apr 27 19:06:00 EDT 2003
===========================================================================
Other files you might want to look at are README, CHANGES, and BUGS.

===========================================================================
For those who hate to read stuff:

	0) make sure GTK and wxGTK are installed and operational
	1) unpack (if you're reading this you've already done this)
	2) edit src/lib/make.env to taste
	3) run make and make shared in src/
	4) copy src/resource/.mtu to your home directory (edit?)
	5) enjoy!

No, it probably won't be that simple.  Following are a few notes that
may help if you have any difficulties.  These notes are applicable to 
both the main and other packages, with the later using 'make -fMakefile.other'
instead of make.  

--------------------------------------------------------------------------
	0) make sure GTK and wxGTK are installed and operational
First and formost, make sure GTK and wxGTK are installed and working.
As I write this, I'm using GTK v1.2.10 and wxGTK v2.4.0.  I have an
environment with wxGTK 2.2.9, but no longer build against it (having
both 2.2.9 and 2.4.0).  The best test to verify that these libs are 
installed is to run a couple of the samples bundled with wxGTK.  Start 
with minimal, and move on to fractal or forty.  If any of these don't 
work, it's unlikely any of MTU's GUI will.

--------------------------------------------------------------------------
	1) unpack (if you're reading this you've already done this)
My test and build environments have traveller hanging off of either
/usr or ~/ and the resource files live in my home directory.  These
may not be to your liking, but what little documentation there is will 
make reference to these directories.  Using some other location should 
not be a problem (once the neccassary files are edited).  I have tryed 
to trim the leading traveller path from the distribution, but that 
resulted in diasater.  

If you're reading this, then you have most likely succeeding in this 
step.  Congratulations.  

When you got this tarball, you should have also picked up a universe 
(my recommadation is to at least pick up ct.tgz).  You will need to
extract the universe file(s) into data/mtu.  Once you have the each of
your data files in place, you will then need to cd into the each 
universe directory and run ../../../src/utility/install.sh 
This adds the universe to the directory structure.

Alternately, there is a program (gal2mtu) which will use much of the
data files from Galactic.

You should now be ready to build mtu.

--------------------------------------------------------------------------
	2) edit src/lib/make.env to taste
You will need to point WXBASEDIR to the directory where wxGTK is 
installed.  Also $(TRAVDIR)/bin and $(TRAVDIR)/lib may need to be
created (this won't show up until the next step).  Also, wx/setup.h
seems to end up in strange places.  If you get compile errors saying
this file cannot be found, run 'ln ../../lib/wx/include/gtk-2.2/wx/setup.h'
from /usr/local/include/wx .   Also, if this symptom turns up, it 
seems the symbolic link for libwx_gtk.so needs to be created in
/usr/local/lib .  I've only run into this stuff at the 11th hour,
and don't have a correct solution yet.

--------------------------------------------------------------------------
	3) run make and make shared in src/
Yes, there will be compilier warnings from 'make shared'.  These turn 
out to be due to over aggressive optimization, and can be ignored.

--------------------------------------------------------------------------
	4) copy src/resource/.mtu to your home directory (edit?)
The ExeDir, DataDir, and BitmapX entries should point to where you have
installed things.  (There is also HelpDir, but that isn't implemented 
yet).

--------------------------------------------------------------------------
	5) enjoy!
You don't need instructions for this, do you?

