git.saurik.com Git - wxWidgets.git/blame_incremental

... / ...

Commit	Line	Data
	1	SWIG 1.3 Patches
	2	================
	3
	4	This directory holds a set of patches for the CVS version of SWIG that
	5	are required if you wish to use SWIG for wxPython development, or for
	6	building your own extension modules that need to interface with
	7	wxPython. These have been submitted to SWIG's SourceForge patch
	8	tracker, so hopefully they will get incorporated into the main SWIG
	9	source tree soon.
	10
	11	wxPython currently uses the 20-Feb-2004 version of SWIG. You can get
	12	that version from their CVS using these commands::
	13
	14
	15	cvs -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/swig login
	16	<press ENTER for empty password>
	17
	18	cvs -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/swig \
	19	checkout -D 20-FEB-2004 SWIG
	20
	21
	22	------------------------------------------------------------------------
	23
	24
	25	swig.python-docstring.patch Adds "autodoc" and "docstring" features.
	26	See SF Patch #883402
	27
	28	Also changes the "addtofunc" feature to
	29	"pythonappend" and also adds a
	30	"pythonprepend" feature that prepends
	31	pythoncode to the begining of a
	32	SWIG-generated proxy function or method.
	33
	34	Add support for two new options to the
	35	%module directive. The first allows you
	36	to specify a docstring for the proxy
	37	module, you use it like this::
	38
	39	%module(docstring="blah") modulename
	40
	41	And then when generating the
	42	modulename.py file SWIG will make a
	43	docstring using the value given.
	44
	45	The second %module option allows you to
	46	specify the name of the package that the
	47	module will live in. This is useful when
	48	the .i file is %imported by other .i
	49	files. If they are to live in separate
	50	packages then the importer can't do local
	51	imports of the importee. If both modules
	52	have the same package name then nothing
	53	is generated differently than the current
	54	SWIG functionality. If they are
	55	different then the package name of the
	56	importee is prepended to the import
	57	statement and the base class declarations
	58	in the importer. For example::
	59
	60	%module(pacakge="wx") _core
	61
	62	Multiple %module options can be specfied,
	63	separated by commmas.
	64
	65
	66	swig.xmlout.patch Fixes a couple problems in the XML output
	67	of SWIG: an extra "/>" was removed and
	68	newlines in attribute values were changed
	69	to the #10; entity reference so they will
	70	be preserved by parsers.
	71
	72	Also, added options for dumping or
	73	writing to a file the XML of the parse
	74	tree after other language modules have
	75	been run (previously you could only do
	76	the XML output instead of a regular
	77	language module.)
	78	See SF Patch #864689
	79
	80
	81
	82	------------------------------------------------------------------------
	83	These patches have already been checked in to SWIG's CVS and are in
	84	the 1.3.20 release.
	85	------------------------------------------------------------------------
	86
	87	swig.SplitLines.patch Adds a new SplitLines function to the DOH
	88	library. See SF Patch #829317.
	89	Checked in 10/31/2003
	90
	91	swig.xml.patch Adds an option that drastically reduces
	92	the size of the XML output of SWIG, which
	93	increases the performance of the
	94	build_renamers script used in the wxPython
	95	build. See SF Patch #829319.
	96	Checked in 10/31/2003
	97
	98	swig.python.patch Lots of changes for SWIG's Python module,
	99	especially in how the proxy code is
	100	generated. See swig.python.patch.txt for
	101	more details, also SF Patch #829325.
	102	Checked in 10/31/2003
	103
	104	------------------------------------------------------------------------