+ Please take a few minutes to read the following list, especially
+ paying attention to the most important changes which are marked
+ with '!' in the first column.
+
+ Also please note that you should ensure that WXWIN_COMPATIBILITY_2_4
+ is defined to 1 if you wish to retain maximal compatibility with 2.4
+ series.
+
+! windows are no longer fully repainted when resized, use new style
+ wxFULL_REPAINT_ON_RESIZE to force this (wxNO_FULL_REPAINT_ON_RESIZE stll
+ exists but doesn't do anything any more, this behaviour is default now)
+
+
+- no initialization/cleanup can be done in wxApp/~wxApp because they are
+ now called much earlier/later than before; please move any exiting code
+ from there to wxApp::OnInit()/OnExit()
+- also, OnExit() is not called if OnInit() fails
+- wxTheApp can't be assigned to any longer, use wxApp::SetInstance() instead
+- wxFileType::GetIcon() returns wxIconLocation, not wxIcon
+- wxColourDatabase is not a wxList any more, use AddColour to add new colours
+- wxWindow::Clear() is now called ClearBackground()
+- pointer returned by wxFont::GetNativeFontInfo() must not be deleted now
+- wxMouseEvent::Moving() doesn't return true if mouse is being dragged any more
+- pointer returned by wxColourDatabase::FindColour() must now always (and
+ not just sometimes) be deleted, to avoid problems, don't use it at all,
+ use wxColourDatabase::Find() instead.
+- (most) controls now inherit parents colours by default, override
+ ShouldInheritColours() to return false if you don't want this to happen
+
+
+
+DEPRECATED METHODS SINCE 2.4.x
+==============================
+
+Deprecated methods may still be used but will disappear in future wxWindows
+versions, please update your code to not use them.
+
+- wxDocManager::GetNoHistoryFiles() renamed to GetHistoryFilesCount()
+- wxSizer::Remove(wxWindow *), use Detach() instead [it is more clear]
+- wxSizer::Set/GetOption(): use Set/GetProportion() instead
+- wxKeyEvent::KeyCode(): use GetKeyCode instead
+- wxList::Number, First, Last, Nth: use GetCount, GetFirst/Last, Item instead
+- wxNode::Next, Previous, Data: use GetNext, GetPrevious, GetData instead
+- wxListBase::operator wxList&(): use typesafe lists instead
+- wxTheFontMapper: use wxFontMapper::Get() instead
+- wxStringHashTable: use wxHashMap instead
+- wxHashTableLong: use wxHashMap instead
+- wxArrayString::GetStringArray: no replacement
+- wxArrayString::Remove(index, count): use RemoveAt instead
+- wxTreeItemId conversion to long is deprecated and shouldn't be used
+- [MSW only] wxWindow::GetUseCtl3D(), GetTransparentBackground() and
+ SetTransparent() as well as wxNO_3D and wxUSER_COLOURS styles
+- wxList keyed interface: use wxHashMap instead
+