Welcome to GMOD, a music module player for Linux and the Gravis Ultrasound card.

The following module formats are supported:
	4/6/8 channel MOD
	8 channel 669
	MultiTracker (MTM)
	ScreamTracker III (S3M)
	UltraTracker (ULT)

Requirements:
	Linux kernel configured with GUS sequencer drivers.  The drivers must 
		be version 2.4 or greater.  Version 2.5 or greater is
		recommended.
	And, of course, a GUS card. :-)

You may use either the binary version (stripped, optimized for 486, 4.5.26
shared libs, linear volume support enabled, ncurses support enabled), or you
may compile the sources yourself by using the included Makefile.

*** DO NOT COMPILE THIS VERSION OF GMOD USING THE VOXKIT VERSION 2.90 ***
*** soundcard.h HEADER FILE.  IT WILL NOT WORK CORRECTLY!             ***
*** (Note: Version 2.90-2 and later of the drivers appear to work OK) ***

If you are using version 2.90 + of the VoxKit drivers, copy the soundcard.h
file from version 2.5 into the gmod directory.  Edit the makefile and
define USE_LOCAL.

*** THE KERNEL MUST BE MODIFIED IN ORDER FOR MAIN VOLUME CONTROL TO WORK ***
*** PROPERLY IF LINEAR VOLUME SUPPORT IS USED.                           ***

If the kernel is not modified, linear volume (in version 2.5+ of the VoxKit
drivers) will still work, but main volume control (using the '-v' option of
gmod, and possibly by S3M modules) will not.  To enable linear volume, edit
the Makefile and define LINEAR_VOLUME.  To modify the kernel, go into the
/usr/src/linux/drivers/sound driver AFTER doing a make config, and add the
following line to local.h:
#define GUS_USE_CHN_MAIN_VOLUME
and re-compile.  The line will need to be added whenever the kernel is
re-configured.

Defining USE_NCURSES in the Makefile will cause gmod to use ncurses for
keyboard input.  This allows use of the arrow keys, page up, and page down.

For more information, refer to the man page (gmod.1) and ChangeLog.

Please send any comments, suggestions, etc. regarding this version to me,
Andrew J. Robinson (robinson@cnj.digex.net).
