  Hello folks !


This is libmikmod, version 3.1.7, a portable sound library for MacOS.
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 Macintosh development system, so I can't test or debug the 
Macintosh 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 Macintosh 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 the Macintosh, then you're lost in the
  sources. Go up one directory, and read the main README file.

So, you're on one of those esthetically-challenged Apple boxes ? Or on a
sober but nice classic beige box ? With a near-buttonless mouse ?

libmikmod can be built using Metrowerks Codewarrior (Version Pro 3 being used
to create the project file) and Apple MPW (only tested with CW compilers).

Read the file INSTALL in this directory for compilation instructions.
The projects will generate code for 68k as well as PowerPC processors.

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

For more information on this port, please contact Anders Bjoerklund
(email: afb@algonet.se, web: http://www.algonet.se/~afb)


>> 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
