DUMB-XMMS - Plug-in to enable XMMS to use DUMB for IT/XM/S3M/MOD files
Copyright (C) 2002-2003  Ben Davis
Incorporates code from the wav plug-in,
Copyright (C) 1998-2000  Peter Alm, Mikael Alm, Olle Hallnas, Thomas Nilsson and 4Front Technologies

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

                                     ---

First, get DUMB from http://dumb.sf.net/ . The following commands should
compile and install it:

   make
   su -c 'make install'

You will be prompted as to whether you want Allegro support; you can safely
say no for this plug-in. See DUMB's docs for further information.

Once DUMB is installed, change to this directory and run:

   make

The plug-in will be built. When it has finished, you can install it system-
wide by running:

   su -c 'make install'

Or, if you only want to install into your home directory, for yourself, run:

   make install-home

Run "make clean" to remove intermediate files. Run "make veryclean" to remove
intermediate files and the plug-in (won't uninstall). If you ever need to
uninstall the plug-in, use "su -c 'make uninstall'" or "make uninstall-home".

Thanks to Funklord ( http://www.xlntfunk.com/ ) for figuring out how to
compile the code and doing the first draft of the Makefile.

                                     ---

This plug-in currently recognises files by their extension, which must be
.it, .xm, .s3m or .mod. However, it will try all loaders on any files it
recognises as its own, so files that have been renamed to have the wrong
extension (grr) will not foil it.

There are no dialogue boxes of any kind. Sorry.

The plug-in crashes XMMS ever so occasionally when stopping a piece of music.
I don't know why this is. It seems to happen after the plug-in's stop()
function returns. If you feel like debugging for me, I shan't complain :)

                                     ---

Ben Davis - entheh@users.sf.net
