
REQUIREMENTS
=============

You need at least the following packages in order to successfully
compile and run the SoundTracker (included are commands which help you
to find out your installed version, if any):

- gcc 2.7.2.x (I use egcs-1.1.1)		gcc --version
- gtk+ 1.2.0					gtk-config --version
- audiofile library 0.1.5			audiofile-config --version

- optionally, GNOME 1.0.1			gnome-config --version
- under Linux, glibc2.1.x is recommended

GNOME will be more and more useful with the next versions, so
installing it is strongly recommended from now on. You only need the
gnome-libs distribution, it's really not hard to compile yourself.
Currently SoundTracker "only" looks better with it, but in the next
versions, new features might only be possible with the GNOME version.

This program makes extensive use of threads. This can be troublesome
if you are using a libc5 system. You can find this out by issueing the
command

	ldd `which xterm` | grep libc

If the output says libc.so.6 (not 5!), you are fine and you can skip
the rest of this section. Otherwise you need to have thread-safe X
libraries: If SoundTracker keeps crashing as soon as you start it,
giving strange X I/O errors, you don't have them.

You can get a precompiled version from
http://www.tu-harburg.de/~semk2104/soundtracker/threadedxlibs.tar.bz2.
It's best not to install them over the old X libraries, but to put
them into a private directory instead and to let the shell environment
variable 'LD_LIBRARY_PATH' point to this directory before starting
SoundTracker, so they don't interfere with the other programs
installed on your computer:

in bash:

	export LD_LIBRARY_PATH=/path/to/threadedxlibs/directory

in csh/tcsh:

	setenv LD_LIBRARY_PATH /path/to/threadedxlibs/directory


INSTALLING
===========

./configure
make

If this gives errors or warnings, you are out of the game (please
report). I told you this isn't even beta software :)

On the other hand, if it worked (which is highly probable on any i386
Linux system which fulfills the requirements listed above), you can
now 'make install' (which also makes the executable setuid root in
order to gain maximum audio performance).
