swig/Examples
Vladimir Kalinin b63c4839fe Nested classes support
Closes #89
Squash merge branch 'master' of https://github.com/wkalinin/swig into wkalinin-nested

By Vladimir Kalinin
* 'master' of https://github.com/wkalinin/swig:
  CPlusPlusOut mode for Octave
  nested class illustration
  fixed "Abstract" flag for nested classes added an example enabled anonymous nested structs runtime test
  porting
  warnings disabled
  porting fixes
  java runtime tests ported
  nested class closing bracket offset fixed
  removed double nested template (not supported by %template parsing)
  template_nested test extended
  parent field made public
  property access fixed
  replaced tabs with spaces
  warning W-reorder
  deprecated warnings removed, derived_nested runtime test added
  optimized string indenting
  Nested classes indenting
  nested classes docs
  fixed the order in which flattened inner classes are added after the outer
  Private nested classes were getting into the type table.
  Java getProxyName() fix for nested classes fixes the case when nested classes is forward declared
  Fix for a case when a nested class inherits from the same base as the outer. (Base class constructor declaration is found first in this case)
  merge fix
  nested C struct first immediate declaration incorrectly renamed sample fixed
  tests updated to reflect nested classes support
  Java nested classes support (1)
  flattening should remove the link to the outer class
  access mode correctly set/restored for nested classes
  nested templates should be skipped while flattening (template nodes themselves, not expanded versions) also non-public nested classes should be ignored
  If nested classes are not supported, default behaviour is flattening, not ignoring flag "nested" is preserved, so, the nested classes can be ignored by user
  nested workaround test updated
  template instantiated within a class is marked as nested for ignoring purposes
  %ignore not applied to the nested classed, because "nested" flag is set too late
  typedef name takes precedence over the real name (reason?)
  unnamed structs should be processed for all the languages
  nested C struct instances are wrapped as "immutable"
  tree building
  typedef declaration for unnamed C structures fixed
  nested classes "flattening"
  fixed %ignoring nested classes
  renamed "nested" attribute to "nested:outer" added "nested" flag, to be used with $ignore (it is not removed while flattening) added nestedClassesSupported() function to the Language interface
  renamed "nested" attribute to "nested:outer" added "nested" flag, to be used with $ignore (it is not removed while flattening) added nestedClassesSupported() function to the Language interface
  tree iteration fix
  dirclassname variable names unified memory issue fixed
  merge error
  ignore unnamed structs for C++
  unnamed nested C structs naming & unnesting
  class added to classes hash under typedef name
  private nested classes skipped
  test updated due to nested templates support
  anonymous structs with inheritance fixed nested_class test to allow anonymous structs w/o declarator
  tests updated: nested workaround removed from namespace_class.i propagated nested template declaration to the C++ file
  injected members scope
  nested tempplates fixes, nested structures in "C" mode parsing added utility function "appendSibling" (like "appendChild")
  nested unnamed structures parsing fixes, access mode restored on nested class end, tdname is properly patched with outer class name prefix
  memory management fixes
  nested templates (1)
  Nested unnamed structs
  Nested class support (1)
  Nested class support (1)
2013-11-29 07:02:34 +00:00
..
android Fix typos 2013-09-25 17:29:33 +12:00
chicken Chicken - make check-examples run like other examples - not all run very well though! 2013-04-20 02:28:48 +01:00
contract fix extern declarations 2005-06-28 21:14:24 +00:00
csharp Nested classes support 2013-11-29 07:02:34 +00:00
d Fix gcc -Waddress warning in variables examples 2013-10-18 06:53:02 +01:00
go Fix gcc -Waddress warning in variables examples 2013-10-18 06:53:02 +01:00
guile Guile port example fix for Guile 2.0 2013-05-23 23:24:19 +01:00
java Nested classes support 2013-11-29 07:02:34 +00:00
lua Fix gcc -Waddress warning in variables examples 2013-10-18 06:53:02 +01:00
modula3 Modula3 makefiles tweaks for consistency with other languages - they still don't work though 2013-04-19 22:47:28 +01:00
mzscheme Mzscheme - fix for running examples during 'make check-examples' - they don't run very well though\! 2013-04-20 02:28:48 +01:00
ocaml Ocaml example makefiles tweaks for consistency with other languages. Attempt to add runtime tests to 'make check' - untested. 2013-04-19 22:47:28 +01:00
octave Fix gcc -Waddress warning in variables examples 2013-10-18 06:53:02 +01:00
perl5 Fix gcc -Waddress warning in variables examples 2013-10-18 06:53:02 +01:00
php Fix gcc -Waddress warning in variables examples 2013-10-18 06:53:02 +01:00
pike Pike - a few updates to get Pike 7.8 running most of the examples 2013-04-20 02:28:48 +01:00
python Fix gcc -Waddress warning in variables examples 2013-10-18 06:53:02 +01:00
r R examples makefile tidyup 2013-04-19 22:47:26 +01:00
ruby Fix gcc -Waddress warning in variables examples 2013-10-18 06:53:02 +01:00
s-exp remove final vestiges of gifplot example 2010-02-28 00:16:39 +00:00
tcl Fix gcc -Waddress warning in variables examples 2013-10-18 06:53:02 +01:00
test-suite Nested classes support 2013-11-29 07:02:34 +00:00
xml XML example makefiles tweaks for consistency with other languages 2013-04-19 22:47:29 +01:00
index.html remove final vestiges of gifplot example 2010-02-28 00:16:39 +00:00
Makefile.in Minor cleanup prior to merging to master 2013-10-11 21:48:45 +01:00
README remove final vestiges of gifplot example 2010-02-28 00:16:39 +00:00

SWIG Examples

The "perl5", "python", "tcl", "guile", "java", "mzscheme", "ruby", and
"chicken" directories 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.

The Examples directory is currently quite incomplete because it
is being reorganized.  A more complete set of examples can be found
in the SWIG1.1p5 distribution (most of which should still work with
SWIG1.3).

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