-------------------------------
How to upgrade to wxWindows 1.5
-------------------------------

In addition to internal restructuring, this release of wxWindows has a
few changes to the API and makefiles which will affect existing code.

These are as follows.

- wxChoice::String and wxListBox::String have been changed to
  wxChoice::GetString and wxListBox::String to avoid clashes with
  the Motif String type.

- Device contexts are now derived from the abstract device context
  wxDC, so wxDC objects can no longer be created directly. See the
  documentation for wxDC, wxPostScriptDC, wxCanvasDC and wxPrinterDC
  for further details.

- wxEvent is now abstract. Please use wxMouseEvent in OnEvent,
  wxKeyEvent in OnChar, and wxCommandEvent in command callbacks.

- Set the WX environment variable to your wxWindows distribution
  directory to avoid having to change the supplied makefiles.

- makefiles should be altered to invoke the wxWindows makefile in
  wx/src/msw or wx/src/x (depending on platform), instead of wx/src.
  The necessary wxWindows include file directories are now wx/include,
  wx/include/base and wx/include/msw or wx/include/x (depending on platform).

- In DOS makefiles, the resource compiler will need to be passed the
  include directory wx/include/msw, which is where wx.rc resides.

- Consider the wxToolBar utility for jazzing up your applications a little!
