Hello folks !


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


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

Currently, libmikmod can be build under OS/2 only with the emx compiler
or the Watcom compiler. Borland C lacks a 64-bit integer type and can't be
used.  You'll need the MMPM/2 toolkit (included in all the Warp toolkits) to
compile the MMPM/2 driver. The Warp 4 toolkit is required if you want to build
the DART driver, too.

Oh, I almost forgot : you need long filenames to compile libmikmod, so you'll
have to compile it on an HPFS drive, or an ext2fs drive, or a network drive
where you can use decent-size filenames.

In this directory, run

  configure

You will then be asked some questions.
First, you'll have to choose your compiler. 

If you choose emx, you can either build a static library, or a DLL with an
import library.

Then, you will be asked if you want to build a debug version ; this
option is mainly intended for the libmikmod developers, so you should
answer "N" here.

The next step is the driver selection. You'll be asked if you want the
MMPM/2 and DART drivers. Since DART is not available on OS/2 older than
Warp 4, the MMPM/2 driver is recommended for pre-Warp 4 systems.
Otherwise, the DART driver is preferable, but you can include both to
be sure your libmikmod library will work on every 32 bit version of OS/2.

After the configuration has finished and the Makefiles are created, just
run

  make

and you'll get your libmikmod library in the libmikmod 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. If you built a DLL, put the DLL (..\libmikmod\mikmod.dll)
in a directory which appears in your LIBPATH.


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
