CHANGES.current - third_party/swig - Git at Google

 Below are the changes for the current release.
 See the CHANGES file for changes in older releases.
 See the RELEASENOTES file for a summary of changes in each release.

 Version 3.0.0 (in progress)
 ============================

 2014-02-16: hfalcic
             [Python] Patch #133 - fix crashes/exceptions in exception handling in Python 3.3

 2014-02-15: wsfulton
             [Java] Add support for the cdata library.

 2014-02-06: gjanssens
             [Guile] Patch #133. Make scm to string conversion work with non-ascii strings.
             Guile 2 has a completely rewritten string implementation. SWIG made some assumptions
             that are no longer valid as to the internals of guile's string representation.

 2014-01-30: wsfulton
             [C#] Add new swigtype_inout.i library containing SWIGTYPE *& OUTPUT typemaps.

             Example usage wrapping:

               void f(XXX *& x) { x = new XXX(111); }

             would be:

               XXX x = null;
               f(out x);
               // use x
               x.Dispose(); // manually clear memory or otherwise leave out and leave it to the garbage collector

 2014-01-21: ianlancetaylor
 	    [Go] Add %go_import directive.

 2014-01-21: ianlancetaylor
 	    [Go] Add support for Go 1.3, not yet released.

 2014-01-20: wsfulton
             Director exceptions (Swig::DirectorException) now derive from std::exception
             and hence provide the what() method. In Python and Ruby, this replaces the now
             deprecated DirectorException::getMessage() method.
 2014-01-14: diorcety
             Patch #112 - Fix symbol resolution involving scopes that have multiple levels
             of typedefs - fixes some template resolutions as well as some typemap searches.

 2014-01-11: wsfulton
             Fix and document the naturalvar feature override behaviour - the naturalvar
             feature attached to a variable name has precedence over the naturalvar
             feature attached to the variable's type. The overriding was not working
             when turning the feature off on the variable's name.

             Fix so that any use of the naturalvar feature will override the global
             setting. Previously when set globally by -naturalvar or %module(naturalvar=1),
             use of the naturalvar feature was not always honoured.

 2014-01-06: ianlancetaylor
 	    [Go] Fix bug that broke using directors from a thread not
 	    created by Go.

 2013-12-24: ptomulik
             [Python] SF Bug #1297

             Resolve several issues related to python imports.
             For example, it's now possible to import modules having the same module
             names, but belonging in different packages.

             From the user's viewpoint, this patch gives a little bit more control on
             import statements generated by SWIG. The user may choose to use relative
             or absolute imports.

             Some details:
               - we (still) generate import statements in the form 'import a.b.c' which
                 corresponds to absolute imports in python3 and (the only available)
                 ambiguous one in python2.
               - added -relativeimport option to use explicit relative import syntax
                 (python3),

             The "Python Packages" section in the documentation discusses how to work
             with importing packages including the new -relativeimport command line option.

 2013-12-23: vadz
             [Octave, Perl, Python, R, Ruby, Tcl] Change the length of strings created from fixed-size char
             buffers in C code.

             This is a potential backwards compatibility break: a "char buf[5]" containing "ho\0la" was
             returned as a string of length 5 before, but is returned as a string of length 2 now. Also,
             it was possible to assign a (non-NUL-terminated) string "hello" to such a buffer before but
             now this fails and only "helo" can fit.

             Apply "char FIXSIZE[ANY]" typemaps to explicitly choose the old behaviour.

             *** POTENTIAL INCOMPATIBILITY  ***

 2013-12-23: talby
             [Perl] Add support for directors.

 2013-12-18: ianlancetaylor
 	    [Go] Don't require that Go environment variables be set
 	    when running examples or testsuite when using Go 1 or
 	    later.

 2013-12-17: ianlancetaylor
 	    [Go] Remove -longsize option (for backward compatibility,
 	    ignore it if seen).

 2013-12-17: ianlancetaylor
 	    [Go] Add -go-pkgpath option.

 2013-12-16: ianlancetaylor
 	    [Go] Update for Go 1.2 release.  Add support for linking
 	    SWIG code directly into executable, rather than using a
 	    shared library.

 2013-12-13: ianlancetaylor
 	    [Go] Add SWIG source file name as comments in generated
 	    files.  This can be used by Go documentation tools.

 2013-12-12: jleveque
 	    [Lua] Fix typo (wchar instead of wchar_t) which made wchar.i
 	    for Lua useless.

 2013-12-12: vmiklos
 	    [PHP] PHP's peculiar call-time pass-by-reference feature was
 	    deprecated in PHP 5.3 and removed in PHP 5.4, so update the REF
 	    typemaps in phppointers.i to specify pass-by-reference in the
 	    function definition.  Examples/php/pointer has been updated
 	    accordingly.

 2013-12-12: olly
 	    [PHP] The usage of $input in PHP directorout typemaps has been
 	    changed to be consistent with other languages.  The typemaps
 	    provided by SWIG have been updated accordingly, but if you
 	    have written your own directorout typemaps, you'll need to
 	    update $input to &$input (or make equivalent changes).

             *** POTENTIAL INCOMPATIBILITY  ***

 2013-11-27: vadz
             [C#, Java, Python] Add std_auto_ptr.i defining typemaps for returning std::auto_ptr<>.

 2013-11-09: wsfulton
             [C#] Apply patch #79 from Brant Kyser
               - Remove using directives from the generated C# code and fully qualify the use of all .NET
                 framework types in order to minimize potential name collisions from input files defining
                 types, namespace, etc with the same name as .NET framework members.
               - Globally qualify the use of .NET framework types in the System namespace
               - Remove .NET 1.1 support, .NET 2 is the minimum for the C# module

             This is a potential backwards compatibility break if code has been added relying on these using
             statements that used to be generated:

               using System;
               using System.Runtime.InteropServices;

             The quick fix to add these back in is to add the -DSWIG2_CSHARP command line option when
             executing SWIG. See CSharp.html documentation for more info.

             *** POTENTIAL INCOMPATIBILITY  ***

 2013-11-05: wsfulton
             [Java] Fix some corner cases for the $packagepath/$javaclassname special variable substitution.

 2013-11-05: wsfulton
             [Java] Apply patch #91 from Marvin Greenberg - Add director:except feature for improved
             exception handling in director methods for Java.

 2013-10-15: vadz
             Allow using \l, \L, \u, \U and \E in the substitution part of %(regex:/pattern/subst/)
             inside %rename to change the case of the text being replaced.


 2013-10-12: wsfulton
             [CFFI] Apply #96 - superclass not lispify

 2013-10-12: wsfulton
             Merge in C++11 support from the gsoc2009-matevz branch where Matevz Jekovec first
             started the C++0x additions. Documentation of the C++11 features supported is in a
             new Chapter of the documentation, "SWIG and C++11" in Doc/Manual/CPlusPlus11.html.

 2013-10-04: wsfulton
             Fix %naturalvar not having any affect on templated classes instantiated with an
             enum as the template parameter type. Problem reported by Vadim Zeitlin.

 2013-09-20: wsfulton
             [Java] Fix a memory leak for the java char **STRING_ARRAY typemaps.
	Below are the changes for the current release.
	See the CHANGES file for changes in older releases.
	See the RELEASENOTES file for a summary of changes in each release.

	Version 3.0.0 (in progress)
	============================

	2014-02-16: hfalcic
	[Python] Patch #133 - fix crashes/exceptions in exception handling in Python 3.3

	2014-02-15: wsfulton
	[Java] Add support for the cdata library.

	2014-02-06: gjanssens
	[Guile] Patch #133. Make scm to string conversion work with non-ascii strings.
	Guile 2 has a completely rewritten string implementation. SWIG made some assumptions
	that are no longer valid as to the internals of guile's string representation.

	2014-01-30: wsfulton
	[C#] Add new swigtype_inout.i library containing SWIGTYPE *& OUTPUT typemaps.

	Example usage wrapping:

	void f(XXX *& x) { x = new XXX(111); }

	would be:

	XXX x = null;
	f(out x);
	// use x
	x.Dispose(); // manually clear memory or otherwise leave out and leave it to the garbage collector

	2014-01-21: ianlancetaylor
	[Go] Add %go_import directive.

	2014-01-21: ianlancetaylor
	[Go] Add support for Go 1.3, not yet released.

	2014-01-20: wsfulton
	Director exceptions (Swig::DirectorException) now derive from std::exception
	and hence provide the what() method. In Python and Ruby, this replaces the now
	deprecated DirectorException::getMessage() method.
	2014-01-14: diorcety
	Patch #112 - Fix symbol resolution involving scopes that have multiple levels
	of typedefs - fixes some template resolutions as well as some typemap searches.

	2014-01-11: wsfulton
	Fix and document the naturalvar feature override behaviour - the naturalvar
	feature attached to a variable name has precedence over the naturalvar
	feature attached to the variable's type. The overriding was not working
	when turning the feature off on the variable's name.

	Fix so that any use of the naturalvar feature will override the global
	setting. Previously when set globally by -naturalvar or %module(naturalvar=1),
	use of the naturalvar feature was not always honoured.

	2014-01-06: ianlancetaylor
	[Go] Fix bug that broke using directors from a thread not
	created by Go.

	2013-12-24: ptomulik
	[Python] SF Bug #1297

	Resolve several issues related to python imports.
	For example, it's now possible to import modules having the same module
	names, but belonging in different packages.

	From the user's viewpoint, this patch gives a little bit more control on
	import statements generated by SWIG. The user may choose to use relative
	or absolute imports.

	Some details:
	- we (still) generate import statements in the form 'import a.b.c' which
	corresponds to absolute imports in python3 and (the only available)
	ambiguous one in python2.
	- added -relativeimport option to use explicit relative import syntax
	(python3),

	The "Python Packages" section in the documentation discusses how to work
	with importing packages including the new -relativeimport command line option.

	2013-12-23: vadz
	[Octave, Perl, Python, R, Ruby, Tcl] Change the length of strings created from fixed-size char
	buffers in C code.

	This is a potential backwards compatibility break: a "char buf[5]" containing "ho\0la" was
	returned as a string of length 5 before, but is returned as a string of length 2 now. Also,
	it was possible to assign a (non-NUL-terminated) string "hello" to such a buffer before but
	now this fails and only "helo" can fit.

	Apply "char FIXSIZE[ANY]" typemaps to explicitly choose the old behaviour.

	* POTENTIAL INCOMPATIBILITY *

	2013-12-23: talby
	[Perl] Add support for directors.

	2013-12-18: ianlancetaylor
	[Go] Don't require that Go environment variables be set
	when running examples or testsuite when using Go 1 or
	later.

	2013-12-17: ianlancetaylor
	[Go] Remove -longsize option (for backward compatibility,
	ignore it if seen).

	2013-12-17: ianlancetaylor
	[Go] Add -go-pkgpath option.

	2013-12-16: ianlancetaylor
	[Go] Update for Go 1.2 release. Add support for linking
	SWIG code directly into executable, rather than using a
	shared library.

	2013-12-13: ianlancetaylor
	[Go] Add SWIG source file name as comments in generated
	files. This can be used by Go documentation tools.

	2013-12-12: jleveque
	[Lua] Fix typo (wchar instead of wchar_t) which made wchar.i
	for Lua useless.

	2013-12-12: vmiklos
	[PHP] PHP's peculiar call-time pass-by-reference feature was
	deprecated in PHP 5.3 and removed in PHP 5.4, so update the REF
	typemaps in phppointers.i to specify pass-by-reference in the
	function definition. Examples/php/pointer has been updated
	accordingly.

	2013-12-12: olly
	[PHP] The usage of $input in PHP directorout typemaps has been
	changed to be consistent with other languages. The typemaps
	provided by SWIG have been updated accordingly, but if you
	have written your own directorout typemaps, you'll need to
	update $input to &$input (or make equivalent changes).

	* POTENTIAL INCOMPATIBILITY *

	2013-11-27: vadz
	[C#, Java, Python] Add std_auto_ptr.i defining typemaps for returning std::auto_ptr<>.

	2013-11-09: wsfulton
	[C#] Apply patch #79 from Brant Kyser
	- Remove using directives from the generated C# code and fully qualify the use of all .NET
	framework types in order to minimize potential name collisions from input files defining
	types, namespace, etc with the same name as .NET framework members.
	- Globally qualify the use of .NET framework types in the System namespace
	- Remove .NET 1.1 support, .NET 2 is the minimum for the C# module

	This is a potential backwards compatibility break if code has been added relying on these using
	statements that used to be generated:

	using System;
	using System.Runtime.InteropServices;

	The quick fix to add these back in is to add the -DSWIG2_CSHARP command line option when
	executing SWIG. See CSharp.html documentation for more info.

	* POTENTIAL INCOMPATIBILITY *

	2013-11-05: wsfulton
	[Java] Fix some corner cases for the $packagepath/$javaclassname special variable substitution.

	2013-11-05: wsfulton
	[Java] Apply patch #91 from Marvin Greenberg - Add director:except feature for improved
	exception handling in director methods for Java.

	2013-10-15: vadz
	Allow using \l, \L, \u, \U and \E in the substitution part of %(regex:/pattern/subst/)
	inside %rename to change the case of the text being replaced.


	2013-10-12: wsfulton
	[CFFI] Apply #96 - superclass not lispify

	2013-10-12: wsfulton
	Merge in C++11 support from the gsoc2009-matevz branch where Matevz Jekovec first
	started the C++0x additions. Documentation of the C++11 features supported is in a
	new Chapter of the documentation, "SWIG and C++11" in Doc/Manual/CPlusPlus11.html.

	2013-10-04: wsfulton
	Fix %naturalvar not having any affect on templated classes instantiated with an
	enum as the template parameter type. Problem reported by Vadim Zeitlin.

	2013-09-20: wsfulton
	[Java] Fix a memory leak for the java char **STRING_ARRAY typemaps.