Introduction
============

Okay.. welcome to another turbo-release from MikMak. This is the assembler-
linkable version of the mikmod 2.03 sound-library. Lotz of people have been
asking me for a ASM or PASCAL linkable version of mikmod so I decided to
convert the library for ASM use. You'll notice that there's no SB support in
this version, due to lack of time.. I'll wait and see what kind of reactions
I get on this version before I start working on the SB driver.


Things _I_ had to do to make MikMod/ASM
=======================================

 - Switch from (FILE *) oriented I/O to dos file-handles.

 - Replace _every_ C library call to use my own routines (see MMIO.C)

 - Add some buffering to the sample-converting routines.. DOS reads & writes
   aren't buffered so it took 5 minutes to load CLAUSTR2.XM

 - Make a very lame fasttracker 2 demo song to use for MIKASM.EXE


Things you have to do when using MikMod/ASM
===========================================

- This version only includes the .UNI loader.. use MIKCVT.EXE to convert
  your .XM .MOD .S3M .STM .MTM .ULT etc. modules so MikMod/ASM can play them.

- Always include MIKMOD.INC into your asm file

- MikMod/ASM uses the standard DOS memory allocation interrupts, so your
  .EXE has to free some of it's heap memory before you can load a module.
  (see MIKASM.ASM)

- Do _NOT_ forget to add 'C' to your calls to the mikmod library:

        call _VT_SetBPM C,handle,125
                       ^^^
- MikMod's C routines can and will destroy every register except ES,DS,SI,DI

- C routines return values using the following registers:

        BYTE return value : AL
        WORD return value : AX
        DWORD return value: DX:AX


Shareware or PD ?
=================
                  
As of version 1.90 and higher (which some people received) MikMod is 
SHAREWARE. Now don't format your harddisk.. This only means that you have to 
give me a small teensy-weensy one-time $25 US registration fee if you want to 
use MikMod COMMERCIALLY. Basically the rule is: IF YOU'RE ASKING MONEY FOR 
THE PRODUCT YOU'RE USING MIKMOD WITH, YOU HAVE TO REGISTER. See REGISTER.FRM 
for more details on how to register.

- Registering MikMod is for binaries only. You're not allowed to distribute 
the MikMod sources or parts of it in _any_ form. If you do want to distribute
the sources on a commercial basis, you'll need special permission of the 
author (Jean-Paul Mikkers).

- Registering MikMod gives you the right to sell an unlimited number of 
copies of the product you're using it for.. pretty flexible huh?

- Registering MikMod 2.03 means that you're registering all versions of 
mikmod between 2.03 and any updates until version 2.99. This allows for 
bugfixes and updates without the need to register again.

- A MikMod registration cannot be transferred from one person to another, or 
from one person to a company, or from one company to another company.

- Any contributors to MikMod (bug-fixes, new loaders, new drivers) will get 
automatic registration for ALL MikMod versions. I'll decide if your 
contribution is good enough for registration.

- If you're a very poor shareware author and you want to use MikMod, send 
some email with your story :). I'm always willing to negotiate a lower price, 
or some form of alternative payment (like sample CD's, or software or Cindy 
Crawford videos =).

- Capacala members can pay the $25 US with an amount of condoms of the same 
price (unused please, without holes =)

- It's not illegal to register MikMod even when you don't use it commercially 
=P

So you see, I'm not doing this to get rich.. but it would be nice if I could 
buy a couple of CD's from the registration money, or at least get the money I 
spent on buying my SB16.


Example sources
===============

This version of MikMod includes only one sample source:

        MIKASM: Demonstrates the use of MikMod/ASM from a .ASM file.
                use MAKEDEMO.BAT to rebuild it.


How to contact me
=================

Please send your questions, registration forms, comments, bugreports,
bugfixes, loaders, drivers, soundcards etc. to:


        Email: 
               mikmak@via.nl    (preferred)
               or
               mikmak@stack.urc.tue.nl
        
        
        Snail-mail:
               
               Jean-Paul Mikkers
               Godartstr. 16
               5932AX Tegelen,
               The Netherlands

        Phone:  
               +31 (0)77-732736
                
Greets
======

My *hugs* go to:

		Every1 of HaRDCoDE '95
		Snowman
		Prime / Inertia
		OC - Virtual Visions
		'DSIK' Pelusa
		Phantom / Sonic
		Krystall / Aztec
		Khyron / KLF
		Big Jim / Valhalla
		Lizardking / Triton
		Puz / The Natives
		Mike Leibow / E-Tek
		Capacala
		Ryan Cramer
		Perisoft
		Piposoft
		Vardimon Lily
		Mike Tedder
		Jaap van Hengstum
		Brian Campbell
		DickyDick
		Outbit
		Hyperion
		Void
		Snorkel 'HeavyOnez'
		Terence Martin
		Donovan Stanley
		Ian Scott
		Noel LLopsis
		Toni Suominen
		Luke Sather
		Scott Bolt
		Jouni Miettunen
		Ian Merrithew
		Akintunde Omitowoju
		Jaekyung Song
		Morten Eriksen / Twilight Zone Software
		Lasse Faabeng / BGS Development
		Guenter / FT5 construction (heh, I made watcom support.. happy now?)
		Every1 at #coders & #trax


Legal Stuff
===========

This software is SHAREWARE.

Disclaimer:

The author (Jean-Paul Mikkers) specifically disclaims all warranties,
expressed or implied, including but not limited to implied warranties of
merchantability and fitness for a particular purpose with respect to defects
in the software and documentation.

In no event shall the author be liable for any loss of profit or damage,
including but not limited to special, incidental, or consequential damages.

All product names, trademarks and registered trademarks contained in this
document are the property of their respective holders.

