
INSTALLATION NOTES FOR XMP
==========================

0. Look for patches in http://www.merdre.net/~claudio/xmp
1. ./configure
2. make
3. make install
4. Copy etc/xmprc to $HOME/.xmprc and customize

Appending etc/magic to /etc/magic will allow you to identify module files
using file(1).


The following `configure' parameters may be of some interest:

--prefix=DIR
	Directory where to install. Default is /usr/local.
--with-OSS=DIR
	Look for the Open Sound System in the specified directory.
	Default is /usr/lib/oss.



REQUIREMENTS
------------

- A supported sound device.

- GNU make.

- gcc 2.7.0 or newer (other compilers may work as long as they use packed
  (byte-aligned) data structures.

- awedrv 0.4.2 or newer is needed for AWE support.  The latest version is
  available at http://bahamut.mm.t.u-tokyo.ac.jp. Do a `cat /dev/sndstat'
  to check if the driver is installed. The AWE driver should be listed in
  the `Synth devices' section.

	Synth devices:
	0: Yamaha OPL-3
	1: AWE32-0.4.2c (RAM2048k)

- An  OPL-2 synthesizer  (Adlib compatible card)  is required to play FM
  modules.


xmp may need some system components to be fixed. Patches (if any) are in
the `patches' directory -- read the files for more information. Do _NOT_
apply the  patches if you're not having problems running xmp.



OTHER NOTES
-----------

- Linux Ultrasound Project driver: Jaroslav Kysela's GUS driver produces
  higher CPU load  than OSS playing the same module  (around 15% against
  0.5% playing Elwood's "Feats of Valor", a 22-channel XM file). You may
  have panning problems using packages older than ultra-2.70a.

- FreeBSD: recent versions of xmp have not been tested.

- Cross-compiling: to  cross-compile using gcc and  GNU binutils, define
  CROSSBIN as the bin directory for the cross-compiling tools. To cross-
  compile to NetBSD, for instance, try something like

	CROSSBIN="/opt/gcc/i486-pc-netbsd1.2/bin/" \
	configure --target=i486-pc-netbsd1.2

