Haven (Scalable Vector Graphics for Haskell).

Release Notes, March 1, 2002
----------------------------

Pre-requisites:

  - An installation of Hugs98 or ghc 5.02.2.

    I have tested the release with Hugs98Dec2001 and ghc 5.02.2.

    (Linux users will have to compile hugs for use with pthreads.
     This is easily enabled with a configure switch to hugs, and is
     described in detail in the GCJNI Release Notes.)

  - The Java 2 SDK version 1.4 standard edition.  

    This is available from:
    
	http://java.sun.com/j2se/1.4/

    (This is currently at a beta release, but seems to work fine. I
    have also tested with JDK 1.3, and everything worked fine, but
    there were some minor changes to the JNI in 1.4, so your mileage may
    vary.)

  - GreenCard 2.03

    This is available from:

      http://www.haskell.org/greencard

    (I have also tested with GreenCard 2.01, but I strongly recommend
    2.03, as the installation and build process has improved
    considerably.)

 - GCJNI

   This is a GreenCard'ed version of the Java Native Interface, 
   available from:

      http://www.haskell.org/gcjni

Getting Started:
----------------

1.  Download GCJNI, and follow the installation instructions
    provided in the release notes, including setting of environment
    variables.

2.  Edit the file ./config-<platform>-local.mk to reflect how things
    are set up on your machine.

3.  Type 'make'.

4.  If all went well, type (as root on Linux) 'make install'.

5.  Set up environment variables for use with Haven:

      i) Add $(prefix)/lib/java/haven.jar to your CLASSPATH

      ii) (Hugs Users only):  You need to add
            $(prefix)/lib/hugs/haven to your Hugs search path.
          I recommend doing this by setting the HUGSFLAGS
          environment variable to something like:
          (Linux): -P"[...]:/usr/local/lib/hugs/haven:[...]::"
          (Windows): -P[...];c:\haskell\lib\hugs\haven;[...];;
          In both of the above, [...] is a list of other paths.

6.  Try a quick test:
   
    ghc users:
      $ cd tests
      $ ./havenTest slide
    
    hugs users:
      $ cd tests
      $ runhugs -98 +o havenTestMain.hs slide

    If all goes well, a window should appear on your screen 
    displaying the Haven logo, rendered by Haven.

I welcome feedback on Haven.  I have worked hard to make the install
process relatively painless (if somewhat involved).  I would be
grateful for any feedback, even if just a quick note to let me know
that you managed to get it installed and working.

Happy Haven Hacking,

     -Antony Courtney
     <antony@apocalypse.org>

$Id: RELNOTES.txt,v 1.2 2002/03/03 21:00:53 antony Exp $