Welcome to wxWidgets, a free and open source cross-platform C++ framework for writing advanced GUI applications using native controls.
wxWidgets 3.1.0 is the first release in the new development 3.1.0 branch. This release is a "development" one as it makes (very few) incompatible API changes compared to 3.0 and does not guarantee the ABI stability, unlike the 3.0.x series. It is not inherently more buggy or less stable than the "stable" releases and you're encouraged to use it. If you're already using 3.0, upgrading shouldn't require any special effort, so please try it out.
Please notice that we provide a single source distribution containing files for all platforms, so you only need to download either the archive with the `.zip` (or `.7z` for much smaller size) extension for Microsoft Windows systems or the one with `.tar.bz2` extenstion for Unix ones, including Mac OS X.
See [README](https://raw.githubusercontent.com/wxWidgets/wxWidgets/v3.1.0/docs/readme.txt) for more information about this release and the [change log](https://raw.githubusercontent.com/wxWidgets/wxWidgets/v3.1.0/docs/changes.txt) for details of the changes in it.
## Errata
A few problems have unfortunately sneaked into this release:
* Creating `wxComboCtrl` without `wxTE_PROCESS_ENTER` style results in an assert. Solution: specify this style when creating it or apply this [one line fix](https://github.com/wxWidgets/wxWidgets/commit/cee3188c1abaa5b222c57b87cc94064e56921db8).
* Building under OS X in C++11 mode for i386 architecture (but not amd64) results in an error about narrowing conversion. Solution: apply this [two character fix](https://github.com/wxWidgets/wxWidgets/commit/ee486dba32d02c744ae4007940f41a5b24b8c574).
* Building under OS X in C++11 results in several `-Winconsistent-missing-override` warnings. Solution: we have a [fix for this](https://github.com/wxWidgets/wxWidgets/commit/173ecd77c4280e48541c33bdfe499985852935ba) too.
Please report bugs to the [issue tracker](http://trac.wxwidgets.org/newticket) or the [wx-users mailing list](http://groups.google.com/group/wx-users).
For developing applications with wxWidgets you need to download the compiler-independent `wxWidgets-3.1.0_Headers.7z` file and one of `wxMSW-3.1.0-vcXXX_Dev.7z` or `wxMSW-3.1.0_gccXXX_Dev.7z` files depending on your compiler, its version and the target architecture (x86 if not specified or x64).
Unpack both files into the same directory so that `include` and `lib` directories are at the same level after unpacking. You should be able to compile and link applications using wxWidgets in both debug and release modes but the debug symbols are provided only for debug libraries in this archive, see below for the release build debug symbols.
End users may download one of `wxMSW-3.1.0_vcXXX_ReleaseDLL.7z` or `wxMSW-3.1.0_gccXXX_ReleaseDLL.7z` files to get just the DLLs required for running the applications using wxWidgets.
