### libMikMod GP32 version
### ---
### Altered from mikplay source by aj0
### for Mr.Mirkos SDK replacement, and
### updated to mikmod 3.2.0
### ---
### PEA (www.gp32.co.nz) March 2005
### ---
### Thanks to:
###   Mr.Mirko, Drag, Squidge, gp32x.com

### ---
### General
### ---

This is pretty much a hack, as most of my skills lie with other
programming languages and GUI compilers, but it seems to work
ok! I compile on a windowsXP environment using devkitARM (sorry,
don't know which version).

THIS IS NOT A COMPLETE ARCHIVE! Shock horror!  I removed many
files (such as config scripts and makefiles, and also code for 
other systems like OSX and Mac) that I deemed to be useless for
the GP32. If you need these (e.g. to compile on a different system)
then please look for the original code on the net.

### ---
### Compiling
### ---

### BEFORE COMPILE
  Before compiling, open 'compile.bat' in a text editor, and edit
  the paths to 'make', 'rm' and 'cp'. If these programs are already
  on your search path, then get rid of the file paths and just use
  the command directly.  The first line calls make, the second
  cleans working files (same as 'make clean') and the third copies
  the final compiled library to the Mr.Mirko 'lib' folder.
  
  You will also need to alter paths in the libmikmod 'makefile'
  because they are explicitly set. The paths that you will need to
  modify are near the top and are mostly the include paths. I define
  them in this order:
  1) Path to Mr.Mirko SDK include files
  2) Path to include files in this GP32 folder
  3) Path to original mikmod includes
  This causes the compiler to search for the includes in that order
  so that the rewritten GP32 files take precendence.
  

### TO COMPILE
All I do to compile libmikmod is run the 'compile.bat' file. It
automatically calls 'make' on 'makefile' and copies the generated
libmikmod.a to the lib folder.  The directory structure I use is:

c:\gp32_mrmirko\ <-- GCC etc installed here. Should really be
                     called 'c:\gp32_devkit\' or something like that.
c:\gp32_mrmirko\gp32_SDK\ <-- Mr. Mirko SDK installed here
c:\gp32_mrmirko\gp32_SDK\lib.src\ <-- Mr.Mirko sdk source
c:\gp32_mrmirko\gp32_SDK\lib\     <-- Mr.Mirko (and other) compiled libs
c:\gp32_mrmirko\gp32_SDK\source.libmikmod-3.2.0-beta2 <-- libmikmod :)


### ---
### What has changed
### ---

All the files that have changed (I hope) are in the gp32 subfolder. If
you use the makefil inside the GP32 subfolder to compile the lib, it
will use the altered code for the GP32. If you use the original makefiles,
the GP32 code should be ignored.

Most of the stuff in the subfolder has originally been copied from the
files by aj0, and the rewritten to use Mr.Mirkos SDK. If you alter this
code - at least leave in the io caching that aj0 wrote because it speeds
up loading the mod by more than 20 times!  I made the mistake of removing
it :)
