X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/82a074ce2b5dcc6343873e3c458685d5fe903305..450d55a035d90e211026a51eb2072d55f5a738a3:/wxPython/docs/CHANGES.html

diff --git a/wxPython/docs/CHANGES.html b/wxPython/docs/CHANGES.html
new file mode 100644
index 0000000000..381622d886
--- /dev/null
+++ b/wxPython/docs/CHANGES.html
@@ -0,0 +1,1247 @@
+<?xml version="1.0" encoding="iso-8859-1" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+<meta name="generator" content="Docutils 0.3.1: http://docutils.sourceforge.net/" />
+<title>Recent Changes for wxPython</title>
+<link rel="stylesheet" href="default.css" type="text/css" />
+</head>
+<body>
+<div class="document" id="recent-changes-for-wxpython">
+<h1 class="title">Recent Changes for wxPython</h1>
+<div class="section" id="id1">
+<h1><a name="id1">2.5.1.5</a></h1>
+<p>(See also the <a class="reference" href="MigrationGuide.html">MigrationGuide</a> file for details about some of the
+big changes that have happened in this release and how you should
+adapt your code.)</p>
+<p>The wxWindows project and library is now known as wxWidgets.  Please
+see <a class="reference" href="http://www.wxwindows.org/name.htm">http://www.wxwindows.org/name.htm</a> for more details.  This won't
+really affect wxPython all that much, other than the fact that the
+wxwindows.org domain name will be changing to wxwidgets.org, so mail
+list, CVS, and etc. addresses will be changing.  We're going to try
+and smooth the transition as much as possible, but I wanted you all to
+be aware of this change if you run into any issues.</p>
+<p>Many, many little fixes, changes and additions done as part of the move
+to wxWidgets 2.5 that I have forgotten about.</p>
+<p>Added wxMirrorDC.</p>
+<p>Added wxIconLocation</p>
+<p>Added Python wrappers and demos for the new wxVScrolledWindow,
+wxVListBox, and wxHtmlListBox classes.</p>
+<p>Added wrappers for wxBookCtrl and wxListbook.  wxNotebook now derives
+from wxBookCtrl.</p>
+<p>Added Gordon Williams' PyPlot module to the library, available as the
+wx.lib.plot module.</p>
+<p>I made a small but important change in the code that aquires the
+Python Global Interpreter Lock to try and prevent deadlocks that can
+happen when there are nested attempts to aquire the GIL.</p>
+<p>The RPMs will now install menu items on Mandrake Linux in
+Applications/Development/Tools for PyCrust, XRCed, etc.  The RPMs are
+also installing icons and <tt class="literal"><span class="pre">*.desktop</span></tt> items in the generic KDE and
+GNOME locations, but I don't know yet if they are resulting in menu
+items on non-Mandrake systems.  (It didn't automatically do it on my
+RH-9 build box but I didn't chase it very far...)  If you have ideas
+for how to improve the .spec file to work better and/or on more
+distros please send me a patch.</p>
+<p>The RPMs are now built on a fairly generic RH-9 box, and I have tested
+installing them also on my main Mandrake 9.2 box.</p>
+<p>There are some big changes in the OS X disk image.  The actual
+Installer package now <em>only</em> installs the wxMac dynlibs, wxPython
+extension modules and Python pacakges, and also the command-line tool
+scripts. The remaining items (demo, samples, and application bundles
+for the Demo, PyCrust and XRCed) are now top-level items in the disk
+image (.dmg file) that users can just drag and drop to wherever they
+want to put them.</p>
+<p>The wxWave class has been renamed to wxSound, and now has a slightly
+different API.</p>
+<p>Updated the AnalogClockWindow with many enhancements from E. A. Tacão.</p>
+<p>wxMac now has wx.ToggleButton!</p>
+<p>wx.stc.StyledTextCtrl has been updated to version 1.58 of Scintilla.</p>
+<p>To help with the wx.stc.StyledTextCtrl performance issues on wxMac
+I've added a SetUseAntiAliasing method (and GetUseAntiAliasing too)
+that will turn off the use of antialiased fonts in the wxSTC, allowing
+it to bypass the slow text measuring routines and use the fast and
+simple one instead.  By default the setting is turned off (on wxMac
+only.)  When run on OSX the Py* apps have a new item on the Options
+menu for controlling this setting if you would like to experiment with
+it.</p>
+<p>Updated wx.lib.calendar with many fixes and enhancements from Joerg
+&quot;Adi&quot; Sieker.</p>
+<p>Added wx.Display and wx.VideoMode.</p>
+<p>AppleEvents can be handled by overriding wx.App methods MacOpenFile,
+MacPrintFile, MacNewFile, and MacReopenApp.</p>
+<p>Added wx.PlatformInfo which is a tuple containing strings that
+describe the platform and build options of wxPython.  See the
+MigrationGuide for more details.</p>
+<p>Created a new extension module &quot;activex&quot; from Lindsay Mathieson's
+newest <a class="reference" href="http://members.optusnet.com.au/~blackpaw1/wxactivex.html">wxActiveX</a> class.  (The existing iewin module used an older
+version of this code, but only exposed the wxIEHtmlWin class.)  This
+new module will (in theory ;-) ) allow you to host arbitrary ActiveX
+controls in a wx.Window, <strong>without</strong> requiring the use of the win32com
+and other PyWin32 modules!  This should eliminate the cronic problems
+that have resulted from minor mismatches in how PyWin32 handles the
+GIL and tstate when making callbacks, etc.  The older iewin module
+will be left in this release as the new stuff is not fully backwards
+compatible, but you should migrate your code to the new IEHtmlWindow
+in wx.lib.iewin, so the old one can be eventually removed.
+Additionally, I've always considered that the wx.lib.activexwrapper
+module is an ugly hack that I only included in the lib because I
+couldn't figure out anything better.  Well now we have something that,
+if it isn't already, has the potential to be better.  So consider
+migrating away from using activexwrapper as well.  Please see the
+MigrationGuide for more details on using the new module.</p>
+<p>Floats are allowed again as function parameters where ints are expected.</p>
+</div>
+<div class="section" id="id2">
+<h1><a name="id2">2.4.2.4</a></h1>
+<p>Use wxSTC in the demo for displaying the soucre code of the samples.</p>
+<p>Lots of bug fixes and such from the wxWindows folks.</p>
+<p>Added wxPython.lib.newevent from Miki Tebeka.  Its usage is
+demonstrated in the Threads sample in the demo.</p>
+<p>Updates to wxMaskedEditCtrl.</p>
+<p>Added wxMaskedNumCtrl.</p>
+<p>Added Chris Barker's FloatCanvas.</p>
+</div>
+<div class="section" id="id3">
+<h1><a name="id3">2.4.1.2</a></h1>
+<p>Added wxScrolledPanel from Will Sadkin</p>
+<p>Added SetShape method to top level windows (e.g. wxFrame.)</p>
+<p>Changed wxSWIG to not generate Python code using apply, (since it will
+be deprecated in the future) wxSWIG will use <tt class="literal"><span class="pre">spam(*args,</span> <span class="pre">**kw)</span></tt> syntax
+instead.  Also changed the generated __repr__ methods to be a bit more
+informative.</p>
+<p>Made the version number information more robust and uh, informative.
+Also added asserts to check that the major.minor versions of wxPython
+and wxWindows match.</p>
+<p>Added the new wx &quot;renamer&quot; package that will dynamically import from
+the wxPython package and rename wxFooBar --&gt; FooBar.  That means that
+people can do imports without <tt class="literal"><span class="pre">&quot;import</span> <span class="pre">*&quot;</span></tt> and can use names like
+wx.Frame instead of wx.wxFrame.  This is phase 1 of a full transition
+to the new namespace.</p>
+<p>Updated Scintilla to 1.52.  I also changed it to use wxListCtrl
+instead of wxListBox for the AutoComplete window, added the ability to
+use custom bitmaps in the margin and in the AutoComplete windows, and
+worked out how to do proper clipping of child windows on wxGTK.</p>
+<p>Patrick O'Brien's PyCrust package has been renamed to Py and now
+includes several new tools.  As part of the change the location of the
+pacakge has changed as well, it is now accessible as &quot;from wxPython
+import py&quot; (or &quot;from wx import py&quot; using the new namespace.)  There
+are still some transition modules in the wxPython.lib.PyCrust package
+that will issue a warning and then import what is needed from the new
+package.  These will be removed in a future release.</p>
+<p>Added __nonzero__ method to wxTreeItemId, wxBitmap, wxImage, wxFont,
+and most other classes that have an Ok or IsOK method.  This allows
+code like &quot;if obj: ...&quot; to be the same as &quot;if obj.IsOk(): ...&quot;</p>
+<p>Toolbars on wxMac can now have controls on them.</p>
+<p>Added wxPython.lib.analogclock module based on samples that were
+passed back and forth on wxPython-users a while back.</p>
+<p>Added masked edit controls (wxPython.lib.maskededit) by Jeff Childers
+and Will Sadkin.  Updated wxTimeCtrl to use MaskedEdit.</p>
+<p>When the __class__ of a dead object is replaced with _wxPyDeadObject
+the __del__ of the original class is now called first.</p>
+<p>Added wxTreeListCtrl.  (Looks like a wxTreeCtrl embedded in a
+wxListCtrl, but actually is just giving multiple columns to a
+wxTreeCtrl.)</p>
+<p>Added wxFutureCall, a subclass of wxTimer that makes it easy to delay
+a call to any Python callable object.</p>
+<p>Added wxPy versions of wxPrintPreview, wxPreviewFrame, and
+wxPreviewControlBar so they can be derived from in Python and be able
+to override the C++ virtual methods.</p>
+<p>Simplified how the wxSizer methods are wrapped, changed the name of
+the &quot;option&quot; parameter to &quot;proportion&quot; to match the docs (&quot;option&quot; is
+still accepted for compatibility, but this will go away in a future
+release,) SetItemMinSize can now take a wxSize (or 2-tuple) parameter,
+and Spacers can be specified with a wxSize (or 2-tuple) parameter</p>
+<p>Added wxCursorFromBits.</p>
+</div>
+<div class="section" id="id4">
+<h1><a name="id4">2.4.0.7</a></h1>
+<p>Gave up on generating a warning upon the use of the old true/false or
+TRUE/FALSE values.</p>
+<p>Fixed wxGenericTreeCtrl (used on wxGTK and wxMac for wxTreeCtrl) so
+that it can successfully handle lots of nodes instead of overflowing
+when the virtual height of the widget overflowed a 16-bit value.</p>
+<p>Fixed the typemap that converts strings to wxColours to also accept
+unicode.</p>
+<p>Fixed problem where the wrong class name could sometimes be used for
+OOR.</p>
+<p>Fixed an interpreter lock problem in the __eq__ and __ne__ methods in
+wxSize and etc.</p>
+<p>Updated PyCrust to version 0.9</p>
+<p>Instead of always logging C++ assertions, added wxPYAPP_ASSERT_LOG
+flag to turn it on.  In most cases turning it into an exception (the
+default behavior) is enough.  See below in the 2.3.4.1 notes for more
+details.</p>
+</div>
+<div class="section" id="a-k-a-the-i-m-so-stupid-release">
+<h1><a name="a-k-a-the-i-m-so-stupid-release">2.4.0.6 (a.k.a. the I'm so stupid release)</a></h1>
+<p>The new deprecation class for the old true/false symbols can now be
+returned from OnInit.  And I promise to be sure I am testing what I
+think I am testing in the future...</p>
+</div>
+<div class="section" id="a-k-a-the-blame-it-on-kevin-release">
+<h1><a name="a-k-a-the-blame-it-on-kevin-release">2.4.0.5 (a.k.a. the blame it on Kevin release)</a></h1>
+<p>A few little but annoying bug fixes.</p>
+<p>Updated pycolourchooser.</p>
+<p>Updated to 0.9b of PyCrust.</p>
+</div>
+<div class="section" id="id5">
+<h1><a name="id5">2.4.0.4</a></h1>
+<p>Added missing wxRect methods</p>
+<p>Add OOR support for wxApp objects too.</p>
+<p>Added wxCursorFromImage, which works on wxMSW and wxGTK so far.</p>
+<p>All platforms now send EVT_DESTROY_WINDOW.  Be warned that at the time
+the event is sent the window is in the process of being deconstructed,
+and so calling some (most?) methods of the window itself may cause
+problems.</p>
+<p>Fixed SF Bug #689481, a method in the OGL wrappers was using the wrong
+return type.</p>
+<p>Fixed SF Bug #689958, an endless loop in printout.py.</p>
+<p>Added EVT_WINDOW_CREATE_ID and EVT_WINDOW_DESTROY_ID so these events
+can be associated with a specific window ID and more easily caught by
+the parent window.</p>
+<p>Fixed copy-paste error in wxListCtrl.GetFirstSelected.</p>
+<p>Added missing Init method (and an overloading wrapper) to wxLocale
+wrapper.</p>
+<p>Added a wxBitmap.SetMaskColour convenience method.</p>
+<p>Changed how the dynamic event tables (used for all Python wx classes,
+C++ wx classes typically use static event tables) are searched such
+that they behave from a Python perspective more like the static tables
+in C++.  Namely that if there are identical event bindings in a base
+Python class and a derived Python class that the one in the derived
+class will be found first and that if Skip is called that the one in
+the base class will still be found instead of skipping directly to the
+static stable in the C++ class.</p>
+<p>Switched to using True/False in the wxPython lib and demo instead of
+true/false or TRUE/FALSE to prepare for the new boolean type and
+constants being added to Python.  Added code to wx.py to test for the
+existence of the new constants and to create suitable values if not
+present.</p>
+<p>Added some static wxApp functions that help with integration with the
+Mac UI.  They are no-ops on other platforms so it doesn't hurt to
+always call them.  The functions are:</p>
+<blockquote>
+wxApp_GetMacDefaultEncodingIsPC
+wxApp_GetMacSupportPCMenuShortcuts
+wxApp_GetMacAboutMenuItemId
+wxApp_GetMacPreferencesMenuItemId
+wxApp_GetMacExitMenuItemId
+wxApp_GetMacHelpMenuTitleName
+wxApp_SetMacDefaultEncodingIsPC
+wxApp_SetMacSupportPCMenuShortcuts
+wxApp_SetMacAboutMenuItemId
+wxApp_SetMacPreferencesMenuItemId
+wxApp_SetMacExitMenuItemId
+wxApp_SetMacHelpMenuTitleName</blockquote>
+<p>Refactored, enhanced and added capabilities for the DrawXXXList
+functions, inspired by code from Chris Barker.</p>
+<p>The wxWindows .mo language catalog files are now installed in a
+subdirectory of the wxPython package dir on MSW since that platform
+doesn't have a standard place for them.</p>
+<p>Added missing deselect methods for wxGrid.</p>
+<p>Fixed typemaps for wxGridCellCoordsArray.</p>
+<p>Updated to the 0.9a version of PyCrust</p>
+</div>
+<div class="section" id="id6">
+<h1><a name="id6">2.4.0.2</a></h1>
+<p>Several bug fixes.</p>
+<p>Added wxIntCtrl from Will Sadkin.</p>
+<p>Added wxPyColourChooser by Michael Gilfix.</p>
+</div>
+<div class="section" id="id7">
+<h1><a name="id7">2.4.0.1</a></h1>
+<p>No major new features since 2.3.4.2, mostly bug fixes and minor
+enhancements.</p>
+<p>Added function wrappers for the common dialogs from Kevin Altis.  See
+wxPython/lib/dialogs.py for more details.</p>
+</div>
+<div class="section" id="id8">
+<h1><a name="id8">2.3.4.2</a></h1>
+<p>Various bug fixes.</p>
+</div>
+<div class="section" id="id9">
+<h1><a name="id9">2.3.4.1</a></h1>
+<p>Updated XRCed and wxTimeCtrl contribs.</p>
+<p>Show a couple new wxGrid features in the demo.</p>
+<p>Several bug fixes in wxWindows.</p>
+<p>Added wxHtmlFilter.</p>
+<p>wxASSERT and related C++ runtime diagnostics are now converted to
+Python exceptions.  When an assert happens a wxPyAssertionError
+(which derives from AssertionError) exception is created and when
+control returns back to the Python code that invoked the C++ API it
+will be raised.  The same exception restrictions are in place as
+before, namely that exceptions can't cross from one Python layer
+through C++ to another Python layer.  That simply means that if you
+want to catch wxPyAssertionError or any other exception that you need
+to do it before control returns to C++ at the end of your event
+handler or callback code.  There is some test code in demo/wxButton.py
+you can use to play with this new feature.</p>
+<p>Added some methods to wxApp (SetAssertMode and GetAssertMode) that let
+you control how C++ assertions are processed.  Valid modes are:
+wxPYAPP_ASSERT_SUPPRESS, wxPYAPP_ASSERT_EXCEPTION, and
+wxPYAPP_ASSERT_DIALOG.  Using _SUPPRESS will give you behavior like
+the old &quot;final&quot; builds and the assert will be ignored, _EXCEPTION is
+the new default described above, and _DIALOG is like the default in
+2.3.3.1 and prior &quot;hybrid&quot; builds.  You can also combine _EXCEPTION
+and _DIALOG if you wish, although I don't know why you would.</p>
+<p>You can now overload OnInitGui, OnExit and OnAssert in your classes
+derived from wxApp.</p>
+<p>Added GetSelectedCells, GetSelectionBlockTopLeft,
+GetSelectionBlockBottomRight, GetSelectedRows, GetSelectedCols nethods
+to wxGrid.</p>
+<p>Added Python == and != operators for some basic classes</p>
+<p>Fixed the Python wrappers for wxInputStream so they no longer block
+when reading from a wxProcess on wxGTK.  They now work more or less as
+they did before 2.3.3.1 but the dual meaning of eof() has been
+removed.  There is now a CanRead() method that lets you know if there
+is data waiting to be read from the pipe.</p>
+<p>Fixed method name clash in wxIEHtmlWin, renamed Refresh to RefreshPage.</p>
+<p>Added Throbber from Cliff Wells to the library and the demo.</p>
+<p>Windows installer prompts to uninstall old version first.</p>
+<p>Added wxPython.lib.evtmgr by Robb Shecter, which is an easier, more
+&quot;Pythonic&quot; and more OO method of registering handlers for wxWindows
+events using the Publish/Subscribe pattern.</p>
+<p>Added wxPython.lib.popupctl by Gerrit van Dyk which is a combobox-like
+gizmo for poping up arbitrary controls.  It is currently using
+wxDialog because of some issues with wxPopupWindow...</p>
+<p>Added wxPython.lib.gridmovers by Gerrit van Dyk which facilitates the
+dragging of columns and/or rows in a wxGrid.</p>
+<p>Added wxPython.lib.multisash by Gerrit van Dyk which is a nice
+implementation of allowing the user to split a window any number of
+times either horizontally or vertically, and to close the split off
+windows when desired.</p>
+<p>Added helpviewer tool that displays HTML books similarly to how MS
+HTMLHelp viewer does.  Changed how the wxPythonDocs tarball is built
+and added a script to launch the doc viewer.</p>
+</div>
+<div class="section" id="id10">
+<h1><a name="id10">2.3.3.1</a></h1>
+<p>Added wxSplashScreen.</p>
+<p>Added wxGenericDirCtrl.</p>
+<p>Added wxMultiChoiceDialog.</p>
+<p>The calltip window and autocomplete window in wxSTC will now use a
+wxPopupWindow if available on the platform (and functioning correctly)
+so they can extend beyond the client area of the STC if needed.</p>
+<p>Finished wrapping and providing typemaps for wxInputStream and also
+added the stream ctor and other methods for wxImage so images can now
+be loaded from any Python &quot;file-like&quot; object.</p>
+<p>Changed the img2py tool to use PNG instead of XPM for embedding image
+data in Python source code, and the generated code now uses streams to
+convert the image data to wxImage, wxBitmap, or wxIcon.</p>
+<p>Added the wxPython.lib.rcsizer module which contains RowColSizer.
+This sizer is based on code from Niki Spahiev and lets you specify a
+row and column for each item, as well as optional column or row
+spanning.  Cells with no item assigned to it are just left blank.
+Stretchable rows or columns are specified and work the same as in
+wxFlexGridSizer.</p>
+<p>Updated XRCed from Roman Rolinsky</p>
+<p>Added wxBufferedDC.</p>
+<p>Upgraded wxSTC from Scintilla 1.40 to Scintilla 1.45, and then again
+to version 1.47, and one more time to 1.48! &lt;wink&gt;</p>
+<dl>
+<dt>UNICODE!</dt>
+<dd><p class="first">wxWindows/wxPython can be compiled with unicode support enabled or
+disabled.  Previous to wxPython 2.3.3 non-unicode mode was always
+used.  Starting with 2.3.3 either mode is supported, but only if
+it is also available in wxWindows on the platform.  Currently
+wxWindows only supports unicode on MS Windows platforms, but with
+the recent release of GTK+ 2.0 it is only a matter of time until
+it can be done on wxGTK (Linux and other unixes) as well.</p>
+<p>Unicode works best on platforms in the NT branch of the Windows
+family tree (NT, win2k, XP) but it is now also possible to use the
+same unicode binaries on win95/98/ME platforms as well!  This is
+done by using a special library and DLL with the application
+called MSLU, (Microsoft Layer for Unicode).  It simply gets out of
+the way if the app is run on an NT box, otherwise if run on a
+win9x box it loads a special DLL that provides the unicode
+versions of the windows API.  So far I have not been able to get
+this to work perfectly on win9x.  Most things work fine but
+wxTaskBarIcon for example will cause a crash if used with the
+unicode build on win95.</p>
+<p class="last">So how do you use it?  It's very simple.  When unicode is enabled,
+then all functions and methods in wxPython that return a wxString
+from the C++ function will return a Python unicode object, and
+parameters to C++ functions/methods that expect a wxString can
+accept either a Python string or unicode object.  If a string
+object is passed then it will be decoded into unicode using the
+converter pointed to by wxConvCurrent, which will use the default
+system encoding.  If you need to use a string in some other
+encoding then you should convert it to unicode using the Python
+codecs first and then pass the unicode string to the wxPython
+method.</p>
+</dd>
+</dl>
+<p>Added wxListCtrlAutoWidthMixin from Erik Westra.</p>
+<p>Added wxIconBundle and wxTopLevelWindow.SetIcons.</p>
+<p>Added wxLocale and wxEncodingConverter.</p>
+<p>A little black magic...  When the C++ object (for a window or
+whatever) is deleted there is no way to force the Python shadow object
+to also be destroyed and clean up all references to it.  This leads to
+crashes if the shadow object tries to call a method with the old C++
+pointer.  The black magic I've done is to replace the __class__ in the
+Python instance object with a class that raises an exception whenever
+a method call (or other attribute access) is attempted.  This works
+for any class that is OOR aware.</p>
+<p>Added OOR support for wxGridCellRenderer, wxGridCellEditor,
+wxGridCellAttr, wxGridCellAttrProvider, wxGridTableBase and their
+derived classes.</p>
+<p>Added wxImage.GetDataBuffer which returns an in-place edit buffer of
+the image data.  (Patch #546009)</p>
+<p>Added a sample that shows how to embed wxPython in a wxWindows C++
+application.</p>
+<p>Added wxPyWindow, wxPyPanel and wxPyControl which are just like their
+wx counterparts except they allow some of the more common C++ virtual
+methods to be overridden in Python derived classes.  The methods
+supported are:</p>
+<blockquote>
+<p>DoMoveWindow
+DoSetSize
+DoSetClientSize
+DoSetVirtualSize
+DoGetSize
+DoGetClientSize
+DoGetPosition
+DoGetVirtualSize
+DoGetBestSize
+InitDialog
+TransferDataFromWindow
+TransferDataToWindow
+Validate
+AcceptsFocus
+AcceptsFocusFromKeyboard
+GetMaxSize
+AddChild
+RemoveChild</p>
+<p>If there are other methods that you think should be supported
+please let me know.</p>
+</blockquote>
+<p>Changed wxGenButton to derive from wxPyControl and overload
+DoGetBestSize and AcceptsFocus.</p>
+<p>Added wxArtProvider.</p>
+<p>Added wxCallAfter which is a helper function that registers a function
+(or any callable Python object) to be called once the next time there
+are no pending events.  This is useful for when you need to do
+something but it can't be done during the current event handler.  The
+implementation is very simple, see wxPython/wx.py.</p>
+<p>Fixed a boatload of reference leaks.</p>
+<p>Added a demo of using a sizer in a wxScrolledWindow, in effect
+creating a ScrolledPanel.</p>
+<p>Added a sample to the demo that shows how to use radio menu items, and
+other menu stuff.</p>
+<p>Added wxIEHtmlWin.  This is essentially the same as using IE with the
+ActiveXWrapper already in the library, but it is implemented all in
+C++ and therefore does not need any of the modules from win32all and
+so it is less fragile in the face of changes.</p>
+<p>Fixed the ActiveXWrapper problem.  Looks like when the win32com
+modules make a &quot;callback&quot; that they (incorrectly, IMHO) allocate a
+transient thread state structure.  Since wxPython is now saving
+tstates for it's own callbacks it ended up using garbage after
+win32com got rid of the temporary tstate...</p>
+<p>Added a generic static text control to wxPython.lib.stattext.  This is
+so things like Boa and PythonCard can have a static text that can
+respond to mouse events and etc.</p>
+<p>Changed the wxDateTime.Parse* methods to return an int that will be -1
+on failure, and the index where parsing stopped otherwise.</p>
+<p>Moved tools to be a Python package in wxPython.tools, added scripts to
+import and launch each tool.  This will let you import and use the
+tools in your own scripts or apps as needed.  On Linux and OS X the
+tool scripts are installed to {prefix}/bin so you should be able to
+easily launch them from the command line.  For example, PyCrust can be
+started with just the &quot;pycrust&quot; command.</p>
+<p>Added a sample to the demo that catches various key events and
+displays the details of the event.</p>
+<p>Added wxWizard, wxWizardPage, wxWizardPageSimple and wxPyWizardPage.</p>
+<p>Added wxXmlResourceHandler which allows you to create custom handlers
+for nonstandard class types in XRC resources.  See the demo for an
+example.</p>
+<p>Added wxPython.lib.mixins.rubberband module from Robb Shecter.</p>
+<p>Added wxTimeCtrl from Will Sadkin.</p>
+</div>
+<div class="section" id="id11">
+<h1><a name="id11">2.3.2.1</a></h1>
+<p>Changed (again) how the Python global interpreter lock is handled as
+well as the Python thread state.  This time it works on SMP machines
+without barfing and is also still compatible with Python debuggers.</p>
+<p>Added some patches from library contributors.</p>
+</div>
+<div class="section" id="id12">
+<h1><a name="id12">2.3.2</a></h1>
+<p>Added EVT_HELP, EVT_HELP_RANGE, EVT_DETAILED_HELP,
+EVT_DETAILED_HELP_RANGE, EVT_CONTEXT_MENU, wxHelpEvent,
+wxContextMenuEvent, wxContextHelp, wxContextHelpButton, wxTipWindow,
+and a demo to show them in action.</p>
+<p>Deprecated PyShell and PyShellWindow, added a snapshot of PyCrust (see
+<a class="reference" href="http://sourceforge.net/projects/pycrust/">http://sourceforge.net/projects/pycrust/</a>. )</p>
+<p>Added the new virtual list capabilities to wxListCtrl.</p>
+<p>Added a wxSTC style editor from Riaan Booysen to the sample apps.</p>
+<p>Added XRCed to the wxPython Tools directory, contributed by Roman
+Rolinsky.</p>
+<p>Added a new &quot;constructor&quot; to most of the window classes that calls the
+default C++ constructor, (the one with no parameters) and also added the
+corresponding  Create(...) method.  This allows you to do a 2-step
+creation of windows which is sometimes required for doing things such
+as setting extended style flags before the window is created, or for
+passing the object to the XRC resource system to be created from the
+resource.  The name of the new &quot;constructor&quot; is the original name of
+the class with a &quot;Pre&quot; in it.  For example, wxPreWindow, wxPreFrame,
+etc.</p>
+<p>Updated to version 1.40 of Scintilla and updated wxStyledTextCtrl
+accordingly.  While doing this update I dropped the wxLB_SORT style
+from the wxListBox created for the AutoComplete functionality.  This
+means that you will have to sort the keyword lists yourself, but you
+are free to do case sensitive or case insensitive sorts and set the
+wxSTC flag accordingly.</p>
+<p>Updated wxColumnSorterMixin to also be able to place sort icons on the
+column headers, and updated the wxListCtrl demo to show it off by
+using wxColumnSorterMixin.</p>
+<p>Added wxGenBitmapTextButton, TablePrint, etc. contribs from Lorne White.</p>
+<p>Added wxNativeFontInfo and wxFontMapper.</p>
+<p>Added pySketch to the samples.</p>
+<p>Significantly changed how the Python interpreter lock and thread state
+are managed, which should fix the problem of running on a
+multi-processor machine.</p>
+<p>Added wxPyLog so log targets can be created in Python to handle log
+messages however is wished.  See demo/Main.py for an example.</p>
+<p>Added wxFindReplaceDialog.</p>
+<p>The second phase of OOR is implemented for wxEvtHandler, wxSizer,
+wxShape and derived classes.  This means that functions and methods
+that return an object derived from wxEvtHandler that was originally
+created in Python, will return the original Python object (if it still
+exists) instead of letting SWIG wrap a new shadow object around the
+original C++ pointer.</p>
+<p>Added some optimization methods to wxDC: GetBoundingBox, DrawLineList,
+DrawPointList.</p>
+<p>Added a set of sophisticated Error Dialogs from Chris Fama.</p>
+<p>Added wxRightTextCtrl from Josu Oyanguren to wxPython.lib for aligning
+text in a wxTextCtrl to the right side.</p>
+<p>Added wxURLDataObject and an example showing drag and drop of URLs to
+and from web browsers.  It's still not 100% bullet-proof for all types
+of browsers, but it works for the majority of cases with the popular
+browsers on Windows.  On wxGTK it seems that only Netscape 4.x works,
+if anybody has any suggestions about this please bring it up on the
+wx-dev list.</p>
+<p>Added wxStopWatch.</p>
+<p>Added wxMimeTypesManager and wxFileType.</p>
+<p>Passing None for the handler parameter to one of the EVT_** functions
+will now Disconnect the event.</p>
+<p>Added wxPopupWindow and wxPopupTransientWindow.</p>
+<p>Added wxFileHistory.</p>
+<p>Added wxDynamicSashWindow, which allows you to endlessly split windows
+by dragging a little tab next to the scrollbars.  Added a demo to show
+this and also the ability of multiple wxStyledTextCtrls to share the
+same document.</p>
+<p>Added wxEditableListBox gizmo.</p>
+<p>Updated wxEditor with lots of enhancements from Steve Howell and Adam
+Feuer.</p>
+<p>Added the &quot;SplitTree gizmos&quot; which are a collection of classes that
+were designed to operate together and provide a tree control with
+additional columns for each item.  The classes are
+wxRemotelyScrolledTreeCtrl, wxTreeCompanionWindow,
+wxThinSplitterWindow, and wxSplitterScrolledWindow, some of which may
+also be useful by themselves.</p>
+<p>Added wxDllWidget from Vaclav Slavik which allows wx widgets derived
+from wxWindow to be loaded from a C++ .dll (or .so) and be used in a
+wxPython program, without the widget having to be SWIGged first.  The
+visible API of the widget is limited to wxWindow methods plus a
+SendCommand method, but it is still quite powerful.  See
+wxPython/contrib/dllwidget and wxPython/demo/dllwidget for more
+details.</p>
+</div>
+<div class="section" id="id13">
+<h1><a name="id13">2.3.1</a></h1>
+<p>Added EVT_GRID_EDITOR_CREATED and wxGridEditorCreatedEvent so the user
+code can get access to the edit control when it is created, (to push
+on a custom event handler for example.)</p>
+<p>Added wxTextAttr class and SetStyle, SetDefaultStyle and
+GetDefaultStyle methods to wxTextCtrl.</p>
+<p>Added ability to use xml resource files.  Still need to add ability to
+subclass wxXmlResourceHandler, etc...</p>
+<p>Added wxGridAutoEditMixin to the mixins library package.</p>
+<p>Made ColourSelect be derived from wxButton.</p>
+<p>Fixed img2py to work correctly with Python 2.1.</p>
+<p>Added enhanced wxVTKRenderWindow by Prabhu Ramachandran</p>
+</div>
+<div class="section" id="id14">
+<h1><a name="id14">2.3.0</a></h1>
+<p>Removed initial startup dependency on the OpenGL DLLs so only the
+glcanvasc.pyd depends on them, (on wxMSW.)</p>
+<p>Changed wxFont, wxPen, wxBrush to not implicitly use the
+wxThe[Font|Pen|Brush]List objects behind the scenes, but to use normal
+ctor and dtors.</p>
+<p>Exposed the wxThe[Font|Pen|Brush]List to wxPython.</p>
+<p>Also added wxTheColourDatabase and added a library module (in the
+wxPython.lib.colourdb module) to load LOTS more colour names into the
+colour database.</p>
+<p>Added wxWakeUpMainThread, wxMutexGuiEnter, wxMutexGuiLeave,
+wxMutexGuiLocker and wxThread_IsMain to assist with dealing with GUI
+access from non-GUI threads.</p>
+<p>wxPyOnDemandOutputWindow is now (more) thread safe if non-GUI threads
+use print, sys.stdout.write, etc.</p>
+<p>Added CreateTextSizer and CreateButtonSizer to wxDialog</p>
+<p>Added wxPython/lib/infoframe.py from Chris Fama.  It contains a class
+that can be used in place of wxPyOnDemandOutputWindow.</p>
+<p>Added colourselect.py, imagebrowser.py and an updated calendar.py to
+wxPython/lib from Lorne White.</p>
+<p>Added patch to wxPoint_LIST_helper from Tim Hochberg that should make
+it gobs faster in certain situations.</p>
+<p>Added tools that will take an image file in a wx supported format and
+convert it to data embedded in a Python source file.  The image is
+converted to XPM format which is essentially a list of strings
+containing info about each pixel.  The image's transparency mask is
+included, if there is one, or a mask can be added if a mask colour is
+specified on the command line.  It is then pickled and optionally
+compressed and written to a Python source file along with functions to
+convert it to either a wxBitmap or a wxImage.  See
+wxPython/demo/images.py for examples, and wxPython/Tools/img2py.py for
+the implementation.</p>
+<p>Fixed wxStyledTextCtrl to be much faster on wxGTK.  There was some
+experimental code that got left in place that ended up causing way too
+many refreshes.</p>
+<p>A couple more hacks in my_distutils.py so wxPython can be built with
+the distutils that comes with Python 2.1.</p>
+<p>Added a ton of missing methods for wxPrintData.</p>
+<p>Switched to InnoSetup for MSW distributions.</p>
+<p>Added wxToggleButton.</p>
+<p>Fixed bug that prevented wxTreeCtrl.OnCompareItems from being called.</p>
+<dl>
+<dt>Added some methods to wxGrid:</dt>
+<dd>GetCellHighlightPenWidth
+GetCellHighlightROPenWidth
+SetCellHighlightPenWidth
+SetCellHighlightROPenWidth
+GetGridWindow
+GetGridRowLabelWindow
+GetGridColLabelWindow
+GetGridCornerLabelWindow</dd>
+</dl>
+<p>Added wxGetClientDisplayRect which on wxMSW returns a wxRect
+representing the area on screen not occupied by the taskbar and such.
+On other platforms it is equivallent to wxGetDisplaySize.</p>
+<dl>
+<dt>OOR:</dt>
+<dd><p class="first">Implemented the first phase of OOR (Original Object Return).  See
+the text in the demo for more details of what this means, but in a
+nutshell methods such as wxWindow.GetParent or FindWindowById will
+now return a shadow object of the proper type if it can.  By
+&quot;proper type&quot; I mean that if the wxWindow pointer returned from
+FindWindowById really points to a wxButton then the Python object
+constructed will be of a wxButtonPtr class instead of wxWindowPtr
+as before.  This should reduce or eliminiate the need for
+wxPyTypeCast.  (Woo Hoo!)  The objects returned are still not the
+original Python object, but that is the next step.  (Although it
+will probably only work on Python 2.1 and beyond because it will
+use weak references.)</p>
+<p class="last">This first phase of the OOR plan is fairly significant and has
+required a lot of changes all over wxPython, most of which should
+be transparent to you, however I'm not 100% sure that it didn't
+introduce any new bugs that are hiding somewhere and didn't get
+stomped on during my testing.  So please be sure to test everything
+thoroughly when you install this version and be sure to report any
+object-type related oddities to me.</p>
+</dd>
+</dl>
+<p>There is now a wxObject class that most other classes derive from like
+in C++, but the methods provided don't really match but are wxPython
+specific.  It could have been added long ago but OOR required it so it
+finally got done.</p>
+<p>Finally added wxPyLineShape.GetLineControlPoints, which has been on my
+list for a while.  The above OOR modification made this easier.</p>
+<p>Fixed the __cmp__ methods for wxPoint and others.</p>
+<p>Added wxWave.</p>
+<p>Added the wxPython.lib.mixins package to the library, it is where
+useful mix-in classes can be placed.  Currently there is one to help
+make the columns in a wxListCtrl sortable, and the MagicIMageList from
+Mike Fletcher.  If you have any custom code that can be factored out
+of existing classes into a mix-in that would be useful to others
+please send it to me for inclusion in this package.</p>
+<p>Added a few little sample applications to help newbies to get started
+by having smaller functional apps to play with.  They can be found in
+wxPython/samples.</p>
+</div>
+<div class="section" id="id15">
+<h1><a name="id15">2.2.6</a></h1>
+<p>No changes happened in the Python wrappers for this release, only
+changes and fixes in the wxWindows library.</p>
+</div>
+<div class="section" id="id16">
+<h1><a name="id16">2.2.5</a></h1>
+<p>New typemaps for wxString when compiling for Python 2.0 and beyond
+that allow Unicode objects to be passed as well as String objects.  If
+a Unicode object is passed PyString_AsStringAndSize is used to convert
+it to a wxString using the default encoding.</p>
+<p>Fixed the generic buttons so tool tips work for them.</p>
+<p>Fixed a bug in the demo's tree control.</p>
+<p>Added a listbox to the listbox demo that shows how to find items with
+a matching prefix as keys are typed.</p>
+<p>Added code to the wxListCtrl demo to show how to get text from a
+column in report mode.</p>
+<p>Added code to the toolbar demo to clear the long help from the status
+bar after 2 seconds.</p>
+<p>Added wxJoystick.</p>
+<p>Fixed wxTimer so it can be used as described in the docs, either with
+a Notify method in a subclass, or sending an event to a wxEvtHandler
+object, (usually a window.)</p>
+<p>Added wxNotifyEvent.Allow()</p>
+<p>Fixed GOBS of reference leaks.</p>
+<p>Massive code changes and cleanup to allow wxPython to be split into
+multiple extension modules again.  A Python CObject is used to allow
+the &quot;export&quot; of SWIG functions and other common helper functions from
+the wxc module to other modules, even if they are in separate shared
+libraries.  Should also be usable from 3rd party code, just include
+wxPython/src/export.h</p>
+<p>Changed the default setup so the following are built as separate
+extension modules:  calendar, glcanvas, grid, html, ogl, stc, and
+utils.  Will probably add more later.</p>
+<p>Changed the wxPrinterDC to use the new constructor taking a
+wxPrintData object.  The old ctor is still there using the
+wxPrinterDC2 name.</p>
+<p>Added wxPython.lib.anchors.py from Riaan Booysen.  It contains a class
+that implements Delphi's Anchors with wxLayoutConstraints.</p>
+<p>Added wxPython.lib.fancytext from Timothy Hochberg.</p>
+<p>Changed the GenericButtons to send their event in idle time, so the
+mouse won't be captured when the event handler is called.</p>
+<p>Added wxPython.lib.rpcMixin from Greg Landrum, although it's not
+integrated with the demo yet.  It allows a wxPython GUI to be an
+XML-RPC server.</p>
+</div>
+<div class="section" id="new-in-2-2-2">
+<h1><a name="new-in-2-2-2">New in 2.2.2</a></h1>
+<p>Significantly changed how the wxStyledtextCtrl code that wraps
+Scintilla is implemented.  Most of it is now automatically generated
+from an interface definition file provided by Scintilla.  This means
+that it will be much easier to stay in sync with new Scintilla
+releases, but also means that some of the method and identifier names
+have changed.  See wxPython/demo/data/stc.h for a copy of the C++
+interface from which the Python interface is generated.  There is now
+some inline documentation in that file that should really help explain
+how things work.</p>
+<p>I am now using the Python Distutils to build wxPython and to make some
+of the distribution files.  (See <a class="reference" href="http://www.python.org/sigs/distutils-sig/">http://www.python.org/sigs/distutils-sig/</a>)
+This means no more messing with my kludgy build.py/Makefile hack,
+builds will be more consistent with other Python extensions that also
+use Distutils, and will hopefully make wxPython easier to build for
+platforms where there have been troubles before.  If you are building
+wxPython for Python 1.5.2 or for 1.6, then you will need to get and
+install version 1.0 of Distutils from the website above.  If you are
+using Python 2.0 then you already have it.</p>
+<p>Added wxInputStream and the wxFileSystem family of classes,
+contributed by Joerg Baumann.</p>
+<p>Added wxProcess and support for it to wxExecute.  wxProcess lets you
+get notified when an asyncronous child process terminates, and also to
+get input/output streams for the child process's stdout, stderr and
+stdin.</p>
+<p>Removed the old python sizers.</p>
+<p>Added __add__, __sub__ and __cmp__ (equality check only) for wxPoint
+and wxRealPoint.</p>
+<p>Changed the build to make one big extension module instead of one for
+the core and each contrib.  This allowed me to do away with the
+libwxPyHelpers.so on unix systems.</p>
+<p>Lots of little fixes here and there.</p>
+<p>Some hacks on wxGTK to try and make the AutoComplete listbox in the
+wxStyledTextCtrl to behave better.  It's still not as nice as on
+wxMSW, but at least it's a bit more usable now.</p>
+</div>
+<div class="section" id="new-in-2-2-1">
+<h1><a name="new-in-2-2-1">New in 2.2.1</a></h1>
+<p>Various tweaks, fixes, missing methods, etc.</p>
+<p>Added example use of wxTaskBarIcon to the demo.</p>
+</div>
+<div class="section" id="new-in-2-2-0">
+<h1><a name="new-in-2-2-0">New in 2.2.0</a></h1>
+<p>Added wxLog and friends.</p>
+<p>Added wxFrame.ShowFullScreen for MSW.</p>
+<p>Added PyShellWindow to the wxPython.lib package.</p>
+</div>
+<div class="section" id="new-in-2-1-16">
+<h1><a name="new-in-2-1-16">New in 2.1.16</a></h1>
+<p>Added an attribute named labelDelta to the generic buttons that
+specifies how far to offset the label when the button is in the
+depressed state.</p>
+<p>Added wxTipProvider and friends.  See the demo for an example.</p>
+<p>wxGrid can now change the cell highlight colour.</p>
+<p>Added wxDragImage.</p>
+<p>Fixed printing on wxGTK.</p>
+<p>Added wxDateTime, wxTimeSpan, and wxDateSpan to wxPython.utils.</p>
+<p>Added wxCalendarCtrl.</p>
+<p>WARNING: A while back I asked what should be done about the Magic
+Method Names.  (Methods that are automatically turned into event
+handlers by virtue of their name.)  The consensus was that it is more
+confusing to have them than to try and expand them to have greater
+coverage.  I am finally getting around to removing the code that
+generates the event binding.  This means that if you are using any of
+the following method names without a EVT_* call that you need to
+modify your code to add the EVT_* to hook the event to the method.</p>
+<blockquote>
+OnChar
+OnSize
+OnEraseBackground
+OnSysColourChanged
+OnInitDialog
+OnPaint
+OnIdle
+OnActivate
+OnMenuHighlight
+OnCloseWindow
+OnScroll</blockquote>
+<p>Added wxSpinCtrl.</p>
+</div>
+<div class="section" id="new-in-2-1-15">
+<h1><a name="new-in-2-1-15">New in 2.1.15</a></h1>
+<p>Fixed wxTreeCtrl.HitTest to return both the tree item as well as the
+flags that clairify where the click was in relation to the item.</p>
+<p>Fixed thread state problem in wxTreeCtrl.GetBoundingBox and
+GetSelections.</p>
+<p>Fixed some problems in OGL.  Also wxShape.SetClientData and
+.GetClientData can now deal with Python objects.</p>
+<p>Added wxListCtrl.SortItems and changed the demo to show how to use it.</p>
+<p>Plugged a memory leak.</p>
+<p>Wrapped the new wxGrid and friends.  The old wxGrid class is no longer
+available.  There are some incompatibilities, and unfortunately the
+new classes are not documented yet, (however the methods are more
+consistent with each other now so you may be able to guess pretty
+good...)</p>
+<p>Updated filebrowsebutton.py and calendar.py with changes from their
+authors.  There is now a FileBrowseButtonWithHistory class (what a
+mouthful!) and wxCalendar has printing support.</p>
+<p>Added ActiveXWrapper to the library, and some good demos of it too.
+It works great for embedding a COM (a.k.a OCX, a.k.a ActiveX) control
+in a window and calling its methods.  It actually creates a new class
+on the fly that derives from wxWindow, the COM CoClass and others
+needed to make it all work.  The resulting class can be instantiated
+just like wxWindow, used in sizers, etc.  It also responds to all COM
+method calls, properties, etc., and if the class or a mix-in has
+matching method names, then the COM events will be propogated back to
+them.</p>
+<p>Created a typemap that allows a string to be used for parameters
+expecting a wxColour type.  The string is either a colour name as
+defined in the wxColourDatabase, or a colour spec of the form
+&quot;#RRGGBB&quot;.  See the wxStyledTextCtrl demo for an example.</p>
+<p>I almost forgot to mention the wxStyledTextCtrl!  Yes, the
+wxStyledTextCtrl is finally in wxPython!!  (And the crowd goes
+wild...)   There's no documentaTion yet (the crowd boos and hisses...)
+but I've included a very readable source file in the
+wxPython/demo/data directory, a couple fairly good examples, and you
+can also refer to the Scintilla documentaion at
+<a class="reference" href="http://www.scintilla.org/ScintillaDoc.html">http://www.scintilla.org/ScintillaDoc.html</a> to help fill in the gaps
+until the docs are done.  (The croud murmers contentedly as the tool
+provider smiles convincingly and removes his flame-proof suit.)</p>
+</div>
+<div class="section" id="what-s-new-in-2-1-13">
+<h1><a name="what-s-new-in-2-1-13">What's new in 2.1.13</a></h1>
+<p>Skipped a version number to match what has been released for wxGTK.</p>
+<p>Updated wxMVCTree and added a demo for it, also fixed layout on GTK
+and some flicker problems.</p>
+<p>Added a wrapper class for the Visualization ToolKit (or VTK) in the
+wxPython.lib.vtk module.  (<a class="reference" href="http://www.kitware.com/">http://www.kitware.com/</a>)</p>
+<p>Fixed wxTreeCtrl.SetItemImage and GetItemImage to recognise the new
+&quot;which&quot; parameter.</p>
+<p>Added wxPython.lib.spashscreen from Mike Fletcher.</p>
+<p>Added wxPython.lib.filebrowsebutton also from Mike Fletcher.</p>
+<p>Renamed wxTreeCtrl.GetParent to GetItemParent to avoid a name clash
+with wxWindow.GetParent.</p>
+<p>Added wxIntersectRect to compute the intersection of two wxRect's.
+It is used like this:</p>
+<blockquote>
+intersect = wxIntersectRect(rect1, rect2)</blockquote>
+<p>If r1 and r2 don't intersect then None is returned, otherwise the
+rectangle representing the intersection is returned.</p>
+<p>Some bug fixes for Clipboard and Drag-n-Drop.</p>
+<p>Rotated text!!!  WooHoo!  (See wxDC.DrawRotatedText())</p>
+<p>Added a set of Generic Buttons to the library.  These are simple
+window classes that look and act like native buttons, but you can have
+a bit more control over them.  The bezel width can be set in addition
+to colours, fonts, etc.  There is a ToggleButton as well as Bitmap
+versions too.  They should also serve as a good example of how to
+create your own classes derived from wxControl.</p>
+<p>The C++ wxToolBar classes have been redone, and so have the wxPython
+wrappers.  There have been slight modifications to some of the methods
+but shouldn't impact anybody too much.  I took the opportunity to add
+support for setting user data on each toolbar tool.  The new AddTool
+methods look like this:</p>
+<blockquote>
+<dl>
+<dt>def AddTool(ID,</dt>
+<dd>bitmap,
+pushedBitmap = wxNullBitmap,
+toggle = FALSE,
+clientData = NULL,
+shortHelpString = &quot;&quot;,
+longHelpString = &quot;&quot;)</dd>
+<dt>def AddSimpleTool(ID,</dt>
+<dd>bitmap,
+shortHelpString = &quot;&quot;,
+longHelpString = &quot;&quot;,
+toggle=FALSE)</dd>
+</dl>
+</blockquote>
+<p>There are also corresponding InsertTool and InsertSimpleTool methods
+that additionally take an integer position as the first parameter.</p>
+<p>Added a wrapper for the new PCX and TIFF ImageHandlers.</p>
+<p>wxRect now simulates attributes named left, right, top and bottom.</p>
+<p>Removed all non wx stuff from the glcanvas module since DA's PyOpenGL
+is better and compatible with the wxGLCanvas.  You can get it at
+<a class="reference" href="http://starship.python.net:9673/crew/da/Code/PyOpenGL">http://starship.python.net:9673/crew/da/Code/PyOpenGL</a>.</p>
+<p>Added some missing EVT functions.</p>
+<p>Added Dirk Holtwic's editor classes to the wxPython.lib.editor
+package.</p>
+<p>Changed all the &quot;LIST&quot; parameter names to &quot;choices&quot; to match the docs.</p>
+<p>More fixes for the wxFloatBar, and it now works on wxGTK even better
+than wxMSW!  (The feat is accomplished by using the wxTB_DOCKABLE
+style flag instead of trying to float it ourselves.)</p>
+</div>
+<div class="section" id="what-s-new-in-2-1-11">
+<h1><a name="what-s-new-in-2-1-11">What's new in 2.1.11</a></h1>
+<p>Skipped a few version numbers so wxMSW, wxGTK and wxPython are all
+syncronized.</p>
+<p>wxImage.SetData now makes a copy of the image data before giving it to
+wxImage.  I mistakenly thought that wxImage would copy the data
+itself.</p>
+<p>Fixed wxMSW's notebook so the pages get their size set as they are
+being added.  This should remove the need for our
+wxNotebook.ResizeChildren hack.</p>
+<p>wxPanels now support AutoLayout, and wxNotebooks and wxSplitterWindows
+no longer tell their children to Layout() themselves.  This will
+probably only effect you if you have a wxWindow with AutoLayout inside
+a notebook or splitter.  If so, either change it to a wxPanel or add
+an EVT_SIZE handler that calls Layout().</p>
+<p>Fixed deadlock problem that happened when using threads.</p>
+<p>Added new HTML printing classes.</p>
+<p>Added wxWindow.GetHandle</p>
+<p>Apparently wxMouseEvent.Position has been depreciated in wxWindows as
+it is no longer available by default.  You can use GetPositionTuple
+(returning a tuple with x,y) instead, or GetPosition (returning a
+wxPoint.)</p>
+<p>Added wxPostEvent function that allows events to be posted and then
+processed later.  This is a thread-safe way to interact with the GUI
+thread from other threads.</p>
+<p>Added Clipboard and Drag-and-Drop classes.</p>
+<p>Added wxFontEnumerator.</p>
+<p>Many updates to wxMenu, wxMenuBar.</p>
+<p>wxPyEvent and wxPyCommandEvent derived classes now give you the actual
+Python object in the event handler instead of a new shadow.</p>
+<p>Added a Calendar widget from Lorne White to the library.</p>
+<p>Made some fixes to the wxFloatbar.  It still has some troubles on
+wxGTK...</p>
+<p>Added an MVC tree control from Bryn Keller to the library.</p>
+</div>
+<div class="section" id="what-s-new-in-2-1-5">
+<h1><a name="what-s-new-in-2-1-5">What's new in 2.1.5</a></h1>
+<p>This is a quick bug-fix release to take care of a few nasties that
+crept in at the last minute before 2.1.4 was called done.  No new
+major features.</p>
+</div>
+<div class="section" id="what-s-new-in-2-1-4">
+<h1><a name="what-s-new-in-2-1-4">What's new in 2.1.4</a></h1>
+<p>This release is NOT syncronized with a snapshot release of wxGTK or
+wxMSW.  For MSW this isn't much of a problem since you can get the
+binaries from the web site.  For other platforms you'll have to build
+wxGTK from CVS.  (See <a class="reference" href="http://web.ukonline.co.uk/julian.smart/wxwin/cvs.htm">http://web.ukonline.co.uk/julian.smart/wxwin/cvs.htm</a>)
+To get the same set of sources from CVS that I used, checkout using
+the wxPy-2-1-4 tag.</p>
+<p>Now back to what's new...</p>
+<p>Much more support for event-less callbacks and add-on modules.</p>
+<p>Created add-on module with wxOGL classes.</p>
+<p>Added wxWindow.GetChildren().  Be careful of this.  It returns a <em>copy</em>
+of the list of the window's children.  While you are using the list if
+anything changes in the real list (a child is deleted, etc.) then the
+list you are holding will suddenly have window references to garbage
+memory and your app will likely crash.  But if you are careful it works
+great!</p>
+<p>Added a bunch of new and missing methods to wxTreeCrtl.  The
+SortChildren method is now supported, but currently only for the
+default sort order.</p>
+<p>Added typemaps for wxSize, wxPoint, wxRealPoint, and wxRect that allow
+either the actual objects or Python sequence values to be used.  For
+example, the following are equivallent:</p>
+<blockquote>
+win = wxWindow(parent, size = wxSize(100, 100))
+win = wxWindow(parent, size = (100, 100))</blockquote>
+<p>Super-charged the wxHtml module.  You can now create your own tag
+handlers and also have access to the parser and cell classes.  There
+is a tag handler in the library at wxPython.lib.wxpTag that
+understands the WXP tag and is able to place wxPython windows on HTML
+pages.  See the demo for an example.</p>
+<p>A bunch of the methods of wxMenuBar were previously ifdef'd out for
+wxGTK.  Added them back in since the methods exist now.</p>
+<p>Wrapped the wxHtmlHelpController and related classes.</p>
+<p>Wrapped the C++ versions of wxSizer and friends.  The Python-only
+versions are still in the library, but depreciated.  (You will get a
+warning message if you try to use them, but the warning can be
+disabled.) The usage of the C++ versions is slightly different, and
+the functionality of wxBorderSizer is now part of wxBoxSizer.  I have
+added a few methods to wxSizer to try and make the transition as
+smooth as possible, I combined all Add methods into a single method
+that handles all cases, added an AddMany method, etc.  One step I did
+not take was to make the default value of flag in the Add method be
+wxGROW.  This would have made it more backward compatible, but less
+portable to and from wxWin C++ code.  Please see the docs and demo for
+further details.</p>
+<p>Added wxPyEvent and wxPyCommandEvent classes, derived from wxEvent and
+wxCommandEvent.  Each of them has SetPyData and GetPyData methods that
+accept or return a single Python object.  You can use these classes
+directly or derive from them to create your own types of event objects
+that can pass through the wxWindows event system without loosing their
+Python parts (as long as they are stored with SetPyData.)  Stay tuned
+for more info and examples in future releases.</p>
+<p>Added wxPython.lib.grids as an example of how to derive a new sizer
+from the C++ sizers.  In this module you will find wxGridSizer and
+wxFlexGridSizer.  wxGridSizer arrainges its items in a grid in which
+all the widths and heights are the same.  wxFlexgridSizer allows
+different widths and heights, and you can also specify rows and/or
+columns that are growable.  See the demo for a couple examples for how
+to use them.</p>
+<p>Added the wxValidator class, and created a class named wxPyValidator
+that should be used for the base class of any Python validators.  See
+the demo for an example.  Please note that you MUST implement a Clone
+method in your validator classes because of the way some things work
+in the underlying C++ library.  I did not add wxTextValidator because
+of some issues of how it transfers data to and from a wxString, which
+in wxPython is automatically translated to and from Python strings, so
+there would never be a concrete wxString that would hang around long
+enough for the validator to do its job.  On the other hand, it should
+be real easy to duplicate the functionality of wxTextValidator in a
+pure Python class derived from wxPyValidator.</p>
+<p>I've finally added a feature that has been on my list for close to two
+years!  Ever wondered what that zero is for when you create your app
+object?  Well now you can leave it out or explicitly set it to a true
+value.  This value now controls what is to be done with sys.stdout and
+sys.stderr.  A false value leaves them alone, and a true value sets
+them to an instance of wxPyOnDemandOutputWindow.  (On windows the
+default is true, on unix platforms the default is false.)  This class
+creates a frame containing a wxTextCtrl as soon as anything is written
+to sys.stdout or sys.stderr.  If you close the window it will come
+back again the next time something is written.  (You can call
+app.RestoreStdio to turn this off.)  If you would rather that the stdio be
+redirected to a file, you can provide a second parameter to your app
+object's constructor that is a filename.  If you want to use your own
+class instead of wxPyOnDemandOutputWindow you can either implement
+RedirectStdio() in you app class or change the value of
+wxApp.outputWindowClass like this:</p>
+<blockquote>
+<dl>
+<dt>class MyApp(wxApp):</dt>
+<dd><p class="first">outputWindowClass = MyClass</p>
+<dl class="last">
+<dt>def OnInit(self):</dt>
+<dd>frame = MyFrame()
+self.SetTopWindow(frame)
+return true</dd>
+</dl>
+</dd>
+</dl>
+</blockquote>
+<p>Please see the implementation of wxPyOnDemandOutputWindow and wxApp in
+wx.py for more details.  A few words of caution:  if you are running
+your app in a debugger, changing sys.stdout and sys.stderr is likely
+to really screw things up.</p>
+<p>Added wxCaret.  Unfortunately it's author has still not documented it
+in the wxWindows docs...</p>
+<p>Some new 3rd party contributions in wxPython.lib.  PyShell, in
+shell.py is an interesting implementaion of an interactive Python
+shell in wxWindows.  floatbar.py has a class derived from wxToolBar
+that can sense mouse drags and then reparent itself into another
+frame. Moving the new frame close to where it came from puts the tool
+bar back into the original parent.  (Unfortunately there is currently
+a bug in wxGTK's wxFrame.SetToolBar so the FloatBar has some
+problems...)</p>
+</div>
+<div class="section" id="what-s-new-in-2-1b3">
+<h1><a name="what-s-new-in-2-1b3">What's new in 2.1b3</a></h1>
+<p>This release is syncronized with release 2.1 snapshot 9 of wxWindows.</p>
+<p>Switched to using SWIG from CVS (see <a class="reference" href="http://swig.cs.uchicago.edu/cvs.html">http://swig.cs.uchicago.edu/cvs.html</a>)
+for some of the new features and such.  Also they have encorporated my
+patches so there is really no reason to stick with the current (very
+old) release...  This version of SWIG gives the following new
+features:</p>
+<blockquote>
+<ol class="arabic">
+<li><p class="first">Keyword arguments.  You no longer have to specify all the
+parameters with defaults to a method just to specify a
+non-default value on the end.  You can now do this instead:</p>
+<blockquote>
+<p>win = wxWindow(parent, -1, style = mystyle)</p>
+</blockquote>
+</li>
+<li><p class="first">There is now an an equivalence between Python's None and C++'s
+NULL.  This means that any methods that might return NULL will
+now return None and you can use none where wxWindows might be
+expecting NULL.  This makes things much more snake-ish.</p>
+</li>
+</ol>
+</blockquote>
+<p>There is a new build system based on a new Python program instead of
+raw makefiles.  Now wxPython builds are virtually the same on MSW or
+Unix systems.  See the end of this file for new build instructions and
+see distrib/build.py for more details.</p>
+<p>wxDC.Bilt now includes the useMask parameter, and has been split into
+two different versions.  wxDC.BlitXY is like what was there before and
+takes raw coordinants and sizes, and the new wxDC.Blit is for the new
+interface using wxPoints and a wxSize.</p>
+</div>
+<div class="section" id="what-s-new-in-2-1b2">
+<h1><a name="what-s-new-in-2-1b2">What's new in 2.1b2</a></h1>
+<p>Added the missing wxWindow.GetUpdateRegion() method.</p>
+<p>Made a new change in SWIG (update your patches everybody) that
+provides a fix for global shadow objects that get an exception in
+their __del__ when their extension module has already been deleted.
+It was only a 1 line change in .../SWIG/Modules/pycpp.cxx at about
+line 496 if you want to do it by hand.</p>
+<p>It is now possible to run through MainLoop more than once in any one
+process.  The cleanup that used to happen as MainLoop completed (and
+prevented it from running again) has been delayed until the wxc module
+is being unloaded by Python.</p>
+<p>I fixed a bunch of stuff in the C++ version of wxGrid so it wouldn't
+make wxPython look bad.</p>
+<p>wxWindow.PopupMenu() now takes a wxPoint instead of  x,y.  Added
+wxWindow.PopupMenuXY to be consistent with some other methods.</p>
+<p>Added wxGrid.SetEditInPlace and wxGrid.GetEditInPlace.</p>
+<p>You can now provide your own app.MainLoop method.  See
+wxPython/demo/demoMainLoop.py for an example and some explaination.</p>
+<p>Got the in-place-edit for the wxTreeCtrl fixed and added some demo
+code to show how to use it.</p>
+<p>Put the wxIcon constructor back in for GTK as it now has one that
+matches MSW's.</p>
+<p>Added wxGrid.GetCells</p>
+<p>Added wxSystemSettings static methods as functions with names like
+wxSystemSettings_GetSystemColour.</p>
+<p>Removed wxPyMenu since using menu callbacks have been depreciated in
+wxWindows.  Use wxMenu and events instead.</p>
+<dl>
+<dt>Added alternate wxBitmap constructor (for MSW only) as</dt>
+<dd>wxBitmapFromData(data, type, width, height, depth = 1)</dd>
+</dl>
+<p>Added a helper function named wxPyTypeCast that can convert shadow
+objects of one type into shadow objects of another type.  (Like doing
+a down-cast.)  See the implementation in wx.py for some docs.</p>
+<p>Fixed wxImage GetData and SetData to properly use String objects for
+data transfer.</p>
+<p>Added access methods to wxGridEvent.</p>
+<p>New Makefile/Setup files supporting multiple dynamic extension modules
+for unix systems.</p>
+<p>Fixes for the wxGLCanvas demo to work around a strange bug in gtk.</p>
+<p>SWIG support routines now compiled separately instead of being bundled
+in wx.cpp.</p>
+</div>
+<div class="section" id="what-s-new-in-2-1b1">
+<h1><a name="what-s-new-in-2-1b1">What's new in 2.1b1</a></h1>
+<p>Fixed wxComboBox.SetSelection so that it actually sets the selected
+item.  (Actually just removed it from wxPython and let it default to
+wxChoice.SetSelection which was already doing the right thing.)</p>
+<p>Added the Printing Framework.</p>
+<p>Switched back to using the wxWindows DLL for the pre-built Win32
+version.  The problem was needing to reinitialize static class info
+data after loading each extension module.</p>
+<p>Lots of little tweaks and additions to reflect changes to various
+wxWindows classes.</p>
+<p>Fixed a bug with attaching objects to tree items.  Actually was a
+symptom of a larger problem with not obtaining the interpreter lock
+when doing any Py_DECREFs.</p>
+<p>wxSizer and friends.  Sizers are layout tools that manage a colection
+of windows and sizers.  Different types of sizers apply different
+types of layout algorithms.  You saw it here first!  These classes are
+not even in the wxWindows C++ library yet!</p>
+</div>
+<div class="section" id="what-s-new-in-2-0b9">
+<h1><a name="what-s-new-in-2-0b9">What's new in 2.0b9</a></h1>
+<p>Bug fix for ListCtrl in test4.py (Was a missing file...  DSM!)</p>
+<p>Bug fix for occassional GPF on Win32 systems upon termination of a
+wxPython application.</p>
+<p>Added wxListBox.GetSelections returning selections as a Tuple.</p>
+<p>Added a wxTreeItemData that is able to hold any Python object and be
+associated with items in a wxTreeCtrl.  Added test pytree.py to show
+this feature off.</p>
+<p>Added wxSafeYield function.</p>
+<p>OpenGL Canvas can be optionally compiled in to wxPython.</p>
+<p>Awesome new Demo Framework for showing off wxPython and for learning
+how it all works.</p>
+<p>The pre-built Win32 version is no longer distributing the wxWindows
+DLL.  It is statically linked with the wxWindows library instead.</p>
+<p>Added a couple missing items from the docs.</p>
+<p>Added wxImage, wxImageHandler, wxPNGHandler, wxJPEGHandler,
+wxGIFHandler and wxBMPHandler.</p>
+<p>Added new methods to wxTextCtrl.</p>
+<p>Fixed some problems with how SWIG was wrapping some wxTreeCtrl
+methods.</p>
+</div>
+<div class="section" id="what-s-new-in-2-0b8">
+<h1><a name="what-s-new-in-2-0b8">What's new in 2.0b8</a></h1>
+<p>Support for using Python threads in wxPython apps.</p>
+<p>Several missing methods from various classes.</p>
+<p>Various bug fixes.</p>
+</div>
+<div class="section" id="what-s-new-in-2-0b7">
+<h1><a name="what-s-new-in-2-0b7">What's new in 2.0b7</a></h1>
+<p>Added DLG_PNT and DLG_SZE convienience methods to wxWindow class.</p>
+<p>Added missing constructor and other methods for wxMenuItem.</p>
+</div>
+<div class="section" id="what-s-new-in-2-0b6">
+<h1><a name="what-s-new-in-2-0b6">What's new in 2.0b6</a></h1>
+<p>Just a quickie update to fix the self-installer to be compatible with
+Python 1.5.2b2's Registry settings.</p>
+</div>
+<div class="section" id="what-s-new-in-2-0b5">
+<h1><a name="what-s-new-in-2-0b5">What's new in 2.0b5</a></h1>
+<p>Well obviously the numbering scheme has changed.  I did this to
+reflect the fact that this truly is the second major revision of
+wxPython, (well the third actually if you count the one I did for
+wxWindows 1.68 and then threw away...) and also that it is associated
+with the 2.0 version of wxWindows.</p>
+<p>I have finally started documenting wxPython.  There are several pages
+in the wxWindows documentation tree specifically about wxPython, and I
+have added notes within the class references about where and how wxPython
+diverges from wxWindows.</p>
+<p>Added wxWindow_FromHWND(hWnd) for wxMSW to construct a wxWindow from a
+window handle.  If you can get the window handle into the python code,
+it should just work...  More news on this later.</p>
+<p>Added wxImageList, wxToolTip.</p>
+<p>Re-enabled wxConfig.DeleteAll() since it is reportedly fixed for the
+wxRegConfig class.</p>
+<p>As usual, some bug fixes, tweaks, etc.</p>
+</div>
+<div class="section" id="what-s-new-in-0-5-3">
+<h1><a name="what-s-new-in-0-5-3">What's new in 0.5.3</a></h1>
+<p>Added wxSashWindow, wxSashEvent, wxLayoutAlgorithm, etc.</p>
+<p>Various cleanup, tweaks, minor additions, etc. to maintain
+compatibility with the current wxWindows.</p>
+</div>
+<div class="section" id="what-s-new-in-0-5-0">
+<h1><a name="what-s-new-in-0-5-0">What's new in 0.5.0</a></h1>
+<p>Changed the import semantics from <tt class="literal"><span class="pre">&quot;from</span> <span class="pre">wxPython</span> <span class="pre">import</span> <span class="pre">*&quot;</span></tt> to 
+<tt class="literal"><span class="pre">&quot;from</span> <span class="pre">wxPython.wx</span> <span class="pre">import</span> <span class="pre">*&quot;</span></tt>  This is for people who are worried about
+namespace pollution, they can use &quot;from wxPython import wx&quot; and then
+prefix all the wxPython identifiers with &quot;wx.&quot;</p>
+<p>Added wxTaskbarIcon for wxMSW.</p>
+<p>Made the events work for wxGrid.</p>
+<p>Added wxConfig.</p>
+<p>Added wxMiniFrame for wxGTK.</p>
+<p>Changed many of the args and return values that were pointers to gdi
+objects to references to reflect changes in the wxWindows API.</p>
+<p>Other assorted fixes and additions.</p>
+</div>
+<div class="section" id="what-s-new-in-0-4-2">
+<h1><a name="what-s-new-in-0-4-2">What's new in 0.4.2</a></h1>
+<p>wxPython on wxGTK works!!!  Both dynamic and static on Linux and
+static on Solaris have been tested.  Many thanks go to Harm
+&lt;<a class="reference" href="mailto:H.v.d.Heijden&#64;phys.tue.nl">H.v.d.Heijden&#64;phys.tue.nl</a>&gt; for his astute detective work on tracking
+down a nasty DECREF bug.  Okay so I have to confess that it was just a
+DSM (Dumb Stupid Mistake) on my part but it was nasty none the less
+because the behavior was so different on different platforms.</p>
+<p>The dynamicly loaded module on Solaris is still segfaulting, so it
+must have been a different issue all along...</p>
+</div>
+<div class="section" id="what-s-new-in-0-4">
+<h1><a name="what-s-new-in-0-4">What's New in 0.4</a></h1>
+<p>1. Worked on wxGTK compatibility.  It is partially working.  On a
+Solaris/Sparc box wxPython is working but only when it is statically
+linked with the Python interpreter.  When built as a dyamically loaded
+extension module, things start acting weirdly and it soon seg-faults.
+And on Linux both the statically linked and the dynamically linked
+version segfault shortly after starting up.</p>
+<ol class="arabic simple" start="2">
+<li>Added Toolbar, StatusBar and SplitterWindow classes.</li>
+<li>Varioius bug fixes, enhancements, etc.</li>
+</ol>
+</div>
+</div>
+</body>
+</html>