GrInvIn Distribution 1.0.3
==========================
This module is part of the GrInvIn application - http://www.grinvin.org

This is a bugfix release of GrInvIn Distribution.

1. License
----------
The GrInvIn application is Copyright 2005-2007 Universiteit Gent and is
licensed under the terms of the GNU General Public License - see the
files LICENSE.txt and COPYRIGHT.txt for details.

(These files can be found in the META-INF directory of the source
distribution - see below.)

2. Distribution
---------------
grinvin-1.0.3-src.tar.gz:

The GrInvIn Distribution contains build files and related
configuration files to allow assembly of all grinvin modules into a
workable binary.

IMPORTANT NOTE: currently GrInvIn Distribution can only be used on a
UNIX system. It has been tested on Max OS X and on Ubuntu Linux.

The system builds installable grinvin binaries for the following
platforms:

- Linux    (grinvin-1.0.3-linux.tar.gz)
- Windows  (grinvin-1.0.3-installer.exe) 
- Mac OS X (grinvin-1.0.3-osx.tar.gz)

The Linux and Windows binaries can be built on both Linux and Mac OS
X. The Mac OS X binary can only be built on Mac OS X.

3. Dependencies
---------------
The build system itself needs 
- Apache ant, version >= 1.6.5 - http://ant.apache.org/
- Ant contributions, version >= 1.0b2 - http://sourceforge.net/projects/ant-contrib/
- Jar Bundler, version >= 1.8.1 - http://sourceforge.net/projects/jarbundler
- Launch4j, version >= 3.0.0-pre2 -  http://launch4j.sourceforge.net/
- Nsis, version >= 2.0.6 - http://nsis.sourceforge.net/

To build the system, you will need the following GrInvIn modules
- GrInvIn Core, version >= 1.0.3       [ required ]
- GrInvIn Factories, version >= 1.0    [ recommended ]
- GrInvIn Invariants, version >= 1.0.1 [ recommended ]
- GrInvIn Help, version >= 1.0         [ recommended ]
- GrInvIn Graphs, version >= 1.0       [ optional ]

and the following external libraries (needed by these modules)
- SWIRL, version >= 1.0.12 - http://swirl-lib.sourceforge.net
- JMathTeX, version >= 0.7pre - http://jmathtex.sourceforge.net
- JDOM, version >= 1.0 - http://jdom.org
- Java Help, version >= 2.0 - http://java.sun.com/products/javahelp/
- Batik, version >= 1.6 - http://xmlgraphics.apache.org/batik/
- GUI commands, version >= 1.1.42, NOT >= 2.0 - http://gui-commands.dev.java.net/

More information can be found in the release notes of the respective modules.

4. How to build the system
--------------------------

* Build the various GrInvIn submodules (GrInvIn Core first), or download
their binary versions. Store the corresponding (binary) jars into a
common directory, say /tmp/grinvin-libs

* In the nonjava directory, copy the file 'Makefiles.incl.tmpl' to
'Makefile.incl' and adjust to your local situation.

* In the main directory, copy the file 'build.properties.tmpl' to
'build.properties' and adjust to your local situation. 

* In particular, this file needs a reference (libdefs.properties) to
another properties file which contains classpath information on all
external libraries.  This file must contain definitions for the
following properties:

libs.JDOM.classpath=
libs.GUI-commands.classpath=
libs.SWIRL.classpath=
libs.JavaHelp.classpath=
libs.JMathTeX.classpath=
libs.Batik.classpath=

Each property defines a colon-separated list of JARs, defining the
classpath for the corresponding external libary. All jars will
eventually be copied to the final binary distribution.

* Run 'ant' in the main directory.

* The binary distributions will be built in the directory 'dist'.
