X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/d14a1e28567de23c586bc80017073d0c39f8d18f..b591b7cf2bb27ff38d1dbe6f22496918a9a72a79:/wxPython/SWIG/README.txt diff --git a/wxPython/SWIG/README.txt b/wxPython/SWIG/README.txt index 1022a8994f..83bcaf7763 100644 --- a/wxPython/SWIG/README.txt +++ b/wxPython/SWIG/README.txt @@ -8,23 +8,80 @@ wxPython. These have been submitted to SWIG's SourceForge patch tracker, so hopefully they will get incorporated into the main SWIG source tree soon. +wxPython currently uses the 20-Feb-2004 version of SWIG. You can get +that version from their CVS using these commands:: + + + cvs -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/swig login + + + cvs -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/swig \ + checkout -D 20-FEB-2004 SWIG + ------------------------------------------------------------------------ -swig.python-2.patch Adds the ability to turn off the automatic - generation of __repr__ methods on a class - by class basis. Used in wxPython for - classes that have a __repr__ added in - %pythoncode directives. See SF Patch - #835471. + +swig.python-docstring.patch Adds "autodoc" and "docstring" features. + See SF Patch #883402 + + Also changes the "addtofunc" feature to + "pythonappend" and also adds a + "pythonprepend" feature that prepends + pythoncode to the begining of a + SWIG-generated proxy function or method. + + Add support for two new options to the + %module directive. The first allows you + to specify a docstring for the proxy + module, you use it like this:: + + %module(docstring="blah") modulename + + And then when generating the + modulename.py file SWIG will make a + docstring using the value given. + + The second %module option allows you to + specify the name of the package that the + module will live in. This is useful when + the .i file is %imported by other .i + files. If they are to live in separate + packages then the importer can't do local + imports of the importee. If both modules + have the same package name then nothing + is generated differently than the current + SWIG functionality. If they are + different then the package name of the + importee is prepended to the import + statement and the base class declarations + in the importer. For example:: + + %module(pacakge="wx") _core + + Multiple %module options can be specfied, + separated by commmas. +swig.xmlout.patch Fixes a couple problems in the XML output + of SWIG: an extra "/>" was removed and + newlines in attribute values were changed + to the #10; entity reference so they will + be preserved by parsers. + Also, added options for dumping or + writing to a file the XML of the parse + tree *after* other language modules have + been run (previously you could only do + the XML output *instead of* a regular + language module.) + See SF Patch #864689 ------------------------------------------------------------------------ -These patches have already been checked in to SWIG's CVS +These patches have already been checked in to SWIG's CVS and are in +the 1.3.20 release. ------------------------------------------------------------------------ swig.SplitLines.patch Adds a new SplitLines function to the DOH