This document assumes you are using the source version of hatman. If you are using one of the binary distributions available you should follow the instructions for the relevant install program (eg: rpm).
If you have WWW access, check out the web page (see The Hatman web page for more details. Otherwise go straight to ftp:
You will need a few libraries to compile and run hatman. Remember, some distributions separate their files into runtime and developer packages. To compile you need both installed. Alternatively you can download the source. If it doesn't work, try upgrading to the latest versions of all libraries.
Untarring the archive shouild put hatman in a directory something along the
lines of hatman-x.y.z. Change to that directory.
cd hatman-x.y.z
Hatman is now an autoconf program, which means that it is (or will be) easy to compile on different computers. Run the configure script included:
./configure
This may take a few minutes, outputing the information it determines along the way. When it is finished you should be able to compile hatman:
make
Assuming the compile finishes succesfuly you should be able to play hatman from the current directory:
hatman/hatman -dlib
If that doesn't work, something is up. Note that if you are using svgalib, and sometimes with GGI, you will need to run this as root to get the correct permissions.
You can then install hatman (the location can be changed with options to the configure script). This will normally need to be done as root:
su
make install-strip
This also strips the binaries, ie: gets rid of all the debugging gubbins which seriously increase it's size.
Remember that if you needed to test hatman as root then you will need to run it as root. To allow normal users to do this set the suid flag, substituting wherever you installed hatman:
chmod +s /path/to/hatman
If something goes wrong it is likely to be one of two things:
The most common will be people who need to upgrade gcc. The new gcc 2.8 vastly improved c++ things like templates and hatman makes use of the new syntax etc... If you get errors about template declerations please upgrade gcc.
The other problem is likely to be people running an old version of ggi. Around the start of february 99 a feature was added - ggiFlushRegion. Whilst it seems to make little difference at the moment, this is used by hatman, so if you want to use ggi you will need to upgrade to a fairly recent version.
If your problem is different, try and fix it yourself. If you are really stuck, then e-mail the mailing list with an full description of what is wrong, and preferably some logs of you trying to compile. Some information about your system would be nice too. If you do manage to fix it, please send us details anyway, so we can make any appropriate changes, and advise other people with the same difficulties. The contact address should be the mailing list.