swig/Examples
Olly Betts 4ac3c87a29 Sort out predefined SWIG-specific macros
Ensure that SWIG_VERSION is defined both at SWIG-time and in the
generated C/C++ wrapper code (it was only defined in the wrapper
for some target languages previously).

SWIGGO and SWIGJAVASCRIPT are now defined in the generated wrappers
to match behaviour for all other target languages.

Stop defining SWIGVERSION in the wrapper.  This only happened as a
side-effect of how SWIG_VERSION was defined but was never documented and
is redundant.

The new testcase also checks that SWIG is defined at SWIG-time but not
in the generated wrapper, and that exactly one of a list of
target-language specific macros is defined.

Fixes #1050
2022-10-05 12:40:15 +13:00
..
android
csharp
d
go Cosmetic stray semi-colon removal after %typemap using quotes 2022-08-31 19:40:13 +01:00
guile Remove redundant NULL checks before free()/delete (#2184) 2022-01-29 22:03:48 +13:00
java Java 9 deprecation warning fixes for test-suite and examples 2019-02-21 13:47:39 -08:00
javascript Javascript v8 object to string exceptions improvement 2022-09-19 09:09:29 +01:00
lua Improve #include guard macros 2022-07-19 09:35:46 +12:00
mzscheme Remove use of std::bind2nd which is removed in C++17 2019-06-27 07:40:49 +01:00
ocaml [S-EXP] Remove code for Common Lisp S-Exp 2021-05-16 08:42:39 +12:00
octave Reenable and fix octave horzcat operator test 2022-09-18 19:40:37 +02:00
perl5 Cosmetic stray semi-colon removal after %typemap using quotes 2022-08-31 19:40:13 +01:00
php [PHP] Remove useless shadowed variable in example 2022-02-03 23:04:58 +13:00
python Fix a few documentation typos 2022-09-29 18:17:32 +13:00
r
ruby Improve #include guard macros 2022-07-19 09:35:46 +12:00
scilab Alphabetise testing of examples 2020-08-13 20:07:10 +01:00
tcl Cosmetic stray semi-colon removal after %typemap using quotes 2022-08-31 19:40:13 +01:00
test-suite Sort out predefined SWIG-specific macros 2022-10-05 12:40:15 +13:00
xml [xml] Move to "Experimental" target language status 2022-07-08 16:34:19 +12:00
index.html
Makefile.in JSC version display tweaks 2022-08-04 07:14:30 +01:00
README

SWIG Examples

The subdirectories of "Examples" named after SWIG's language backends
contain a number of simple examples that are primarily used for testing.

The file 'index.html' is the top of a hyperlinked document that
contains information about all of the examples along with various
notes related to each example.

Note: All of the examples rely upon the Makefile in this directory.
You may need to edit it to reflect the configuration of your machine
in case the configure script guesses incorrect settings.


*** Special note concerning C++ ***

The configure script is currently unable to handle all of the possible
options for producing dynamically loadable C++ extensions.  Here are
the rules of thumb for making C++ work:

 -  Try using the C++ as the linker for the shared library.  For example:

         g++ -shared $(OBJS) -o module.so

 -  If that doesn't work, you may need to explicitly link against some
    kind of C++ runtime library.  For example:

         ld -G $(OBJS) -L/opt/SUNWspro/lib -lCrun -o module.so

    This can be set by modifying the setting of CPP_DLLIBS in the
    Makefile.


*** Special note for SWIG Maintainers ***

When you add an example, consider arranging for the example to be also
useful as part of the SWIG testing framework.  To do this, include in
the example makefile a target "check" ("check: all" is sufficient for a
first pass), and add an invocation to ../Makefile.in under target
"check-examples" (or whatever is appropriate).  Later, we can add or
expand the actions under target "check" to do more in-depth testing.