Hello folks !


This is libmikmod, version 3.1.6, a portable sound library for Windows.
This version is mainly a bugfixed 3.1.5 version...
Check out the file 'NEWS' for more information.

WARNING
-------

Contrary to the other supported platforms, I don't own or have decent access
to a working Windows development system, so I can't test or debug the Windows
parts of the code myself, and I don't have any plan to change this situation
in the near future.
So, although I can't guarantee the same quality of the Windows code compared
to the Unix or OS/2 code, I'd like to get feedback regarding this code.
Technical questions will be redirected to knowledgeable people.


BUILDING LIBMIKMOD
------------------

Currently, libmikmod can be build under Windows only with the Microsoft compiler
(but I suppose that the Watcom compiler could be used as well).
You'll need the DirectX SDK (if not included with the compiler) to compile the
DirectSound driver.

Oh, I almost forgot : you need long filenames to compile libmikmod, but that
should not be a problem nowadays.

You might want to edit the file 'Makefile.tmpl' in the 'win32' directory to
suit your particular compiler setup. Then, in the 'win32' directory, run

  nmake -f Makefile.tmpl

to compile.

and you'll get your libmikmod library in the current directory.
If the build fails, I'd like to hear from you to correct the problem.

To make you library ready to use, copy the file '..\include\mikmod.h' to your
compiler include directory, and '..\libmikmod\mikmod.lib` to your compiler
library directory.


THANKS
------

I would like to thank everyone who contributed to libmikmod. Their names
are in the AUTHORS file. Thanks a lot !


LICENSE
-------

The libmikmod sound library is covered by the GNU Library General Public
License, which you can find in COPYING.LIB.


CONTACT INFO
------------

Please send all your libmikmod related e-mail to me, at :
  miodrag@multimania.com

libmikmod home page is located at :
  http://www.multimania.com/miodrag/mikmod

Latest releases of libmikmod can be found on the official homepage, as
well as on 
  ftp://metalab.unc.edu/pub/Linux/apps/sound/libs
and all metalab (formerly known as sunsite) mirrors.

I hope you'll enjoy using this version of libmikmod as well as I enjoyed
debugging and improving it.

-- Miodrag ("Miod") Vallat, 03/24/1999
   miodrag@multimania.com
