To compile and use SWIG, you will need the following on your machine:

        A C++ compiler  (ie. g++)
        An ANSI C compiler (ie. gcc)
        yacc or bison

To compile and install SWIG, type the following :

        ./configure
        make
        make install

There are a number of configuration options that you can
give to 'configure' :

        --prefix=/usr/local     

          Set the installation prefix.  SWIG installs into
          /usr/local by default.

        --exec_prefix=/usr/local

          Set the prefix used to install platform specific
          files (binaries and libraries).  Use this if the
          location is different than that given with --prefix.

        --with-lang={TCL,PERL5,PYTHON,PERL4,GUILE3}

          This lets you choose the default SWIG target language.
          By default, SWIG chooses TCL, but you can select
          another as shown :

                ./configure --with-lang=PYTHON

        --with-doc={ASCII,LaTeX,HTML,NODOC}

          This lets you choose the default SWIG documentation
          method.  By default, SWIG chooses ASCII.

        --without-yacc
 
          Try to compile without using yacc/bison.  Only use
          this if compilation fails.

To test the SWIG parser after compilation, type 'make test'.  This
will print out lots of stuff and may take awhile.  However, if it
works you will get a message at the end.  If the tests core dump or
die an unexpected death, please send me e-mail!

NOTE : The test process will print out alot of warning messages and
even some error messages.  This is part of the test to make sure the
SWIG parser is working correctly.  If the test is successful, you
should see a notice near the end saying so.  If the tests core dumps
or stops, then there is a problem.

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

This is the first autoconf script that has been used with SWIG so there
may be some glitches :

1.  Get errors compiling scanner.cxx or parser.cxx.  

    Try
         ./configure --without-yacc
 
    and recompile.   This will copy the parser.cxx files created
    under Solaris.   Not guaranteed to work, but better than nothing.

2.  Unable to locate yacc or bison.

    Try

	./configure --without-yacc

3.  SWIG doesn't seem to locate certain packages.

    SWIG does *not* need Tcl, Perl, Python, or Guile to compile.  
    SWIG tries to locate various packages in order to build the
    file 'Makefile.template' which is used to build all of the
    examples in the Examples subdirectory.   If certain packages
    aren't found, it simply means that you will have to edit
    the file 'Makefile.template' by hand, or that certain examples
    won't compile.   Otherwise, missing packages have no
    impact whosoever on the compilation or installation of SWIG.

This is the first configure script I've written.  If you experience
any problems with it, please let me know.
    
