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

0. Look for new versions in http://xmp.home.ml.org
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).

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.

If you have a GF1-based GUS card and  OSS/Free 3.8 you may need to apply
freq_div_patch.diff  to  make modules with  more than  14 channels sound
correctly (e.g. respirator.xm).


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.
--enable-esd-driver
	Enable support for the Enlightened Sound Daemon, available at
	http://www.netcom.com/~ericmit/EsounD.html.



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) 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.



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.

- Linux on Sparc: xmp in S/Linux uses the Solaris drivers for the CS4231
  and AMD 7930 audio chips.  xmp was tested with Linux 2.0.33 running in
  a machine with  the AMD 7930 audio chip  (using 8 kHz, 8 bit mono ulaw
  output).  The (experimental) audio driver for the  AMD 7930 and CS4231
  chips is available at http://ftp.dementia.org/pub/linux/sparcaudio.

- 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

