  Hello folks !


This is libmikmod, version 3.1.7, a portable sound library for Windows.
This version is mainly a bugfixed 3.1.6 version... with some new features,
though.
Check out the file 'NEWS' for more information.


>> WARNING
----------

Contrary to most of 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
---------------------

- If you're not building libmikmod for Windows, then you're lost in the sources.
  Go up one directory, and read the main README file.

So, you're on an angry fruit salad Windows system, aren't you ? With those so
cute icons and an overflowed system tray ?

Currently, libmikmod can be build under Windows only with the Microsoft compiler
(but I suppose that the Watcom compiler and Metrowerks Codewarrior could be
used as well).
You'll need the DirectX SDK (if not included with the compiler) to compile the
DirectSound driver ; the standard Win32 SDK is enough for the winmm 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 your library ready to use, copy the file '..\include\mikmod.h' to your
compiler include directory, and '..\libmikmod\mikmod.lib` to your compiler
library directory.

HTML documentation of the library, for programmers, is located in the doc
directory.


>> THANKS
---------

I would like to thank everyone who contributed to libmikmod. Their names
are in the AUTHORS file for the significative contributions, but some other
names can be found in the NEWS file. Thanks a lot ! Keeping libmikmod alive
wouldn't be much fun without you.


>> LICENSE
----------

The libmikmod sound library is covered by the GNU Library General Public
License as published by the Free Software Fundation (you'll find it in the
file COPYING.LIB) ; either version 2 of the licence, or (at your option)
any later version.

The GNU Lesser General Public License, version 2.1, in file COPYING.LESSER, can
be considered as a later version of the LGPL, and is strongly recommended for
people who will embed libmikmod in their application as a shared library.


>> CONTACT AND DOWNLOAD INFO
----------------------------

* email :
  Please send all your libmikmod related e-mail to me, at :
  miodrag@mikmod.darkorb.net

* chat :
  People wanting to have a ``live talk'' with me can reach me on IRC (IRCnet
  and sometimes Undernet) under the nick 'effetaipa'.

* web :
  libmikmod home page is located at :
    http://mikmod.darkorb.net
  The European mirror is at:
    http://www.multimania.com/miodrag/mikmod

* ftp :
  Latest releases of libmikmod can be found:
  - on the official ftp site
    ftp://mikmod.darkorb.net
  - on metalab (formerly known as sunsite) and its mirrors
    ftp://metalab.unc.edu/pub/Linux/apps/sound/libs
  - on hobbes, in source and OS/2 binary forms
    ftp://hobbes.nmsu.edu/pub/os2/mmedia


>> LAST NOTES
-------------

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

-- Miodrag ("Miod") Vallat, 06/28/1999
   miodrag@mikmod.darkorb.net
