terminatorX INSTALL:
Copyright (C) 1999 by Alexander Knig <alkoit00@fht-esslingen.de>

Quickstart:
-----------

	If you want enhanced audio-file support or optimization don't
	"quickstart" but read the rest of this file.

	If you just cant wait any longer try:
	> ./configure
	> make install

Step 1: Configure terminatorX.
------------------------------

	If you want your compiler to optimize the binary, you need to set your
	environment variable CFLAGS to your needs BEFORE you run ./configure.

	for example:
	if use bash: > export CFLAGS="-O2"
	with tcsh:   > setenv CFLAGS "-O2"

	I use CFLAGS="-O7 -mpentium" btw. You'll need to have a "pentium-aware"
	compiler to use that though (egcs-pgcc).

	The configure Options:

		--enable-soxinput=yes

		[You don't have to enable this if you use mpg123 input anyway,
		see below]		
		If enabled terminatorX will use sox to open audio files. This
		way you want have to convert your .wav, .au, .iff, ... files
		for terminatorX. You can simply load them via the usual file
		dialogs. 
		BUT: you need to have sox installed. 
		
		--enable-mpg123input=yes
		
		This enables terminatorX to load mp3-files. Attention: Yes, LOAD
		(decoded) mp3-files. Just as with sox the data is converted
		to PCM audio data (16 Bit / 44.1 kHz / mono) so you will need
		quite some free memory (the "usual mp3 song": ~20 MB) to do
		this. As the data is streamed (terminatorX doesn't know how
		much data will be available) you'll actually need the double
		memory while loading (it's freed afterwards). Just to calm you
		down: on my 98MB-machine loading mp3's is just fine, no swap-
		ing - it just takes some time ;)
		
		Due to design issues this option automatically enables sox input
		as well.
		SO: you need to have sox AND mpg123 installed.
		
		--enable-closedev=no
		
		The old "KEEP_DEV_OPEN" flag. Still does the same thing: Once
		the audiodevice is opened it won't be closed until you exit
		terminatorX. Good for devices that click when opened.

		Just as an example my configure line is (works with bash only):
		> CFLAGS="-O7 -mpentium" ./configure --enable-mpg123input=yes 

Step 2: Build the binary.
-------------------------

	This one's easy:
	> make
	
Step 3: Install the binary:
---------------------------

	Just as easy:
	> make install
	
	You need root privileges though. If you don't have them simply copy
	the terminatorX-binary (in src/terminatorX) to a directory of your
	choice and run terminatorX form there.	
