1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
SWIG (Simplified Wrapper and Interface Generator)
$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)
- Thien-Thi Nguyen (ttn@glug.org) (Guile)
*** IMPORTANT NOTICE -- READ THIS NOW! ***
If you downloaded this as a prepackaged release such as SWIG1.3a1, be
advised that this distribution represents a snapshot of the most
stable part of the SWIG CVS repository. Currently, SWIG is undergoing
a large redevelopment effort. The SWIG1.3 series of releases should
be viewed as a transitional version leading to the eventual release
of SWIG2.0.
Please report any errors and submit patches (if possible)! We only
have access to a limited variety of hardware (Linux, Solaris, and
Windows) so every contribution helps.
What's New?
===========
Here are the most notable changes (so far):
- SWIG now has a full C preprocessor.
- Code generation for the Tcl and Python modules has been
substantially improved both in terms of size and runtime
efficiency (Perl5 is coming along too).
- Java module is now included.
- A lot of minor bug fixes and cleanup.
Here are a few missing features
- The SWIG1.1 documentation system is gone and hasn't been
replaced yet. This is on the long-term to-do list.
- The Tcl7.x and Perl4 modules are deprecated and no longer
included.
- A wide variety of old SWIG command-line options and
obscure features are gone.
Installation
============
To build and install SWIG, simply type the following:
% ./configure
% make
% make install
In addition, if you need to build the runtime libraries, type
the following before doing the 'make install' step above.
% make runtime
If you don't know what the runtime libraries are, don't worry
about this step.
The Examples directory contains a few examples of using SWIG.
Notes:
(1) If you checked the code out via CVS, you will have to run autoconf
before typing 'configure.' In addition, a full build of SWIG requires
the use of bison.
(2) If you are using Windows, the easiest way to install and build
SWIG is to use the Cygwin package (http://sourceware.cygnus.com/cygwin/).
Documentation
=============
No documentation is currently included in this release. However, most
of the documentation for SWIG1.1 still applies. This can be obtained
on http://www.swig.org.
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)
Developer Information
=====================
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.
Swig - New SWIG core (ANSI C)
Preprocessor - SWIG preprocessor module
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.
|