mathlink-2.0.0.7: INSTALL

Installation Notes
------------------

1. Make sure that the mathlink.h header file and the ML32i3 (for 32-bit 
systems) or ML64i3 (for 64-bit systems) library are in places that can be 
found by GHC.

These should reside in a folder called:

SystemFiles/Links/MathLink/DeveloperKit/<your-platform>/CompilerAdditions

in your Mathematica installation.

For my 64-bit Linux platform, I do the following:

> cd /usr/local/include
> sudo ln -s /path/to/CompilerAdditions/mathlink.h mathlink.h
> cd /usr/local/lib
> sudo ln -s /path/to/CompilerAdditions/libML64i3.a libML64i3.a
> sudo ln -s /path/to/CompilerAdditions/libML64i3.so libML64i3.so
> sudo ldconfig

The analogous process, I would think, should work on all Unix-alikes.

Any Mac or Windows (or Sparc, or...) users out there, send me a blurb
about what you did to get things right, and I'll include it here.


2. Follow the usual rules for installation:

> runhaskell Setup.lhs configure
> runhaskell Setup.lhs build
> [sudo] runhaskell Setup.lhs install


Troubleshooting
---------------

If you get compile or link errors (that can't be explained by not 
having yet gotten step 1 above correct), take a look in Setup.lhs and
doublecheck that the definition for 'bits' and 'extraLibs' is appropriate
for your platform. As of the 2.0.0.7 installation, at least, these have
only been verified on Linux platforms, so if you are on another platform,
definitely take a look here.

If you did need to make some tweaks for your platform, let me know what it
took, so that I can incorporate it into the setup.

If I get a decent user base, I might even go through the effort of 
having the installation guess where the CompilerAdditions directory is to
eliminate having to do the first part manually. So ping me if you use this 
library at all. That way I can gauge if/when it might be worth the effort 
to do this.


Thank You...
------------

...to Eugene Kirpichov for helping me track down some bugs and 
insufficiencies in the distributions of the earliest 2.0 releases.