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

1. ./configure
2. make
3. make install
4. Copy etc/xmp.conf to $HOME/.xmprc or $HOME/.xmp/xmp.conf and customize

Running ./configure --help will list the available configuration options.
As for xmp 2.0.4, drivers can be built as dynamically linkable objects --
this was implemented to help deb and rpm packaging and requires a dynamic
linking loader (libdl).  This will also generate a shared libxmp.so to be
used by xmp, xxmp and the XMMS plugin.

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
the following patch  to  make modules with  more than  14 channels sound
correctly (e.g. respirator.xm):

--8<---
diff -rud sound.orig/gus_wave.c sound/gus_wave.c
--- sound.orig/gus_wave.c	Wed Feb 26 07:35:16 1997
+++ sound/gus_wave.c	Tue May 13 14:15:41 1997
@@ -133,7 +133,6 @@
 
 static int      freq_div_table[] =
 {
-  44100,
   44100,			/* 14 */
   41160,			/* 15 */
   38587,			/* 16 */
--8<---


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

- OSS or ALSA 0.5 in Linux or native sound driver in Solaris, IRIX, *BSD,
  AIX or HP-UX.

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


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

- Parameter -Dnosync may be needed by OSS/Free:3.8s2++-971130 and Gravis
  Ultrasound card.

- 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 ftp://ftp.dementia.org/pub/linux/sparcaudio.

