SWIG Documentation   1/17/97

Disclaimer : The SWIG Users manual is currently under rennovation and
not yet finished.  Nor is it fully proofread.   Post no bills, everything
you read may be false (although almost all of it is true), etc...

The SWIG manual has been completely reorganized and is now organized by
target language.   Here are the files :

SWIGDoc.ps  (78 pages)    - Documentation for SWIG in general.   How to
                            run it, C/C++ parsing, special directives,
                            automatic documentation generation, plus 
                            a little philosophy and motivations.

Perl5Doc.ps (38 pages)    - Description and examples of the Perl5 module.
                            Describes shadow classes, typemaps and other
                            new features.

PythonDoc.ps (50 pages)   - Describes more than you ever wanted to know
                            about the SWIG Python module.

TclDoc.ps (19 pages)	  - Very weak documentation on Tcl module because I'm
                            currently working on it.   Describes the new
                            object oriented Interface and has a typemap
                            example.    This will eventually be comparable to
                            the other sections when I get it finished.

Still to do :

	- Perl4 (short)
	- Guile3 (short)
	- Extending SWIG
	- An index

Printing everything written so far will require about 185 pages.  If you are
only using one target language, you can probably get away with only printing
that section and going from there.

If you like the documentation, please let me know. Likewise, if it can be
improved, suggestions are always welcome.   


