SWIG (Simplified Wrapper and Interface Generator)

Copyright (C) 1998-2000 : The University of Chicago
Copyright (C) 1995-1998 : University of Utah and the Regents
                          of the University of California

$Header$

Tagline: SWIG is a compiler that integrates C, C++, and Objective-C
         with scripting languages including Perl, Python, and Tcl.

This distribution represents work in progress towards building a new
SWIG release.  The guilty parties working on this are:

  -  Dave Beazley (beazley@cs.uchicago.edu)             (SWIG core)
  -  Dustin Mitchell (djmitche@cs.uchicago.edu)         (SWIG core)
  -  Ian Cooke (iancooke@cs.uchicago.edu)               (SWIG core)
  -  Bryan King (bwking@midway.uchicago.edu)            (SWIG core)
  -  Hasan Baran Kovuk (hbkovuk@midway.uchicago.edu)    (SWIG core)
  -  Loic Dachary (loic@ceic.com)                       (Perl5)
  -  Harco de Hilster (Harco.de.Hilster@ATComputing.nl) (Java)

*** Disclaimer : The Source directory is a nightmare right now. Please
pardon the dust.

General overview:
=================
The primary goal of future development is to make SWIG more modular,
extensible, and easier to maintain.  To this end, the source code has
been consolidated and reorganized with the Source directory.  Within
this directory, there are a number of different components:

      SWIG1.1       - These two directories contain the C++ code
      Modules1.1      corresponding to the SWIG1.1.x series of 
                      releases.  This code is still in use but is
                      slowly being deprecated.

*** Important note: ALL future SWIG development is taking place
in ANSI C.  Please avoid C++ if at all possible. -- Dave ***

      DOH           - Object framework for the ANSI C core.
      Core          - New SWIG core (ANSI C)
      Preprocessor  - SWIG preprocessor module
      Dustin        - Some Python stuff Dustin is working on.
      SWILL         - An embedded web-server library
      Swim          - The SWIG monitor project.

Documentation for these components is weak or non-existent at this
time. However, this should only matter if you are actually hacking
on SWIG itself. Please bear with us.

Installation
============
To build and install SWIG, simply type the following:

     % ./configure
     % make
     % make install
     
If you checked the code out via CVS, you will have to run autoconf
before typing 'configure.'  SWIG requires the use of autoconf-2.13 or
higher. In addition, a full build of SWIG requires the use bison or yacc.
If you plan to make modifications or contributions to SWIG, you
should also plan on installing automake-1.4 or higher on your machine.

Participate!
============
We are looking for people who want to join the effort of getting this
next release off the ground.  Please send me email for details.

-- Dave (beazley@cs.uchicago.edu)