| 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. |
