2012-07-10 19:51:44 -04:00
|
|
|
wxWidgets 2.9.5 Release Notes
|
2010-07-18 09:39:16 -04:00
|
|
|
=============================
|
1998-12-31 12:32:18 -05:00
|
|
|
|
2011-07-04 17:26:11 -04:00
|
|
|
Welcome to the latest release of wxWidgets, a free cross-platform C++
|
|
|
|
framework for writing advanced GUI applications using native controls.
|
|
|
|
|
1998-12-31 13:18:56 -05:00
|
|
|
|
2010-07-18 09:39:16 -04:00
|
|
|
In addition to common and advanced GUI facilities such as frames,
|
|
|
|
scrolling windows, toolbars, tree controls, icons, device contexts,
|
|
|
|
printing, splitter windows and so on, there are wrappers for common
|
2011-07-04 17:26:11 -04:00
|
|
|
file operations, facilities for writing network applications,
|
|
|
|
thread handling, and so on. You can learn more about wxWidgets at
|
|
|
|
|
|
|
|
http://www.wxwidgets.org/
|
|
|
|
|
|
|
|
|
|
|
|
wxWidgets sources are available for download from
|
|
|
|
|
2012-07-10 19:51:44 -04:00
|
|
|
https://sourceforge.net/projects/wxwindows/files/2.9.5/
|
2011-07-04 17:26:11 -04:00
|
|
|
|
|
|
|
or
|
|
|
|
|
2012-07-10 19:51:44 -04:00
|
|
|
ftp://ftp.wxwidgets.org/pub/2.9.5/
|
2011-07-04 17:26:11 -04:00
|
|
|
|
|
|
|
Please see the "Files" section below for the description of various
|
|
|
|
files available at these locations.
|
|
|
|
|
2010-07-18 09:39:16 -04:00
|
|
|
|
|
|
|
A detailed reference manual including in-depth overviews for various
|
|
|
|
topics is supplied in various formats and can be accessed online at
|
2011-07-04 17:26:11 -04:00
|
|
|
|
2012-07-10 19:51:44 -04:00
|
|
|
http://docs.wxwidgets.org/2.9.5/
|
2010-07-18 09:39:16 -04:00
|
|
|
|
|
|
|
|
2012-07-10 19:51:44 -04:00
|
|
|
Note about naming: while 2.9.5 is called a "development" release,
|
2011-07-04 17:26:11 -04:00
|
|
|
this only means that API is not guaranteed to remain unchanged in the
|
|
|
|
subsequent 2.9.x releases (although it is still likely that it will),
|
|
|
|
unlike in the stable 2.8.x branch. We believe the current version is
|
|
|
|
stable and suitable for use in production environment.
|
1998-12-31 13:18:56 -05:00
|
|
|
|
1998-12-31 12:32:18 -05:00
|
|
|
|
1999-01-27 05:01:14 -05:00
|
|
|
|
1999-10-26 11:16:29 -04:00
|
|
|
Changes in this release
|
|
|
|
-----------------------
|
|
|
|
|
2010-07-18 09:39:16 -04:00
|
|
|
This release contains several years worth of improvements compared
|
|
|
|
to 2.8 version. Notably, Unicode support has been completely
|
|
|
|
overhauled and made much easier to use. Debugging support, including
|
|
|
|
when using a release build of the library, was much improved making
|
|
|
|
it less likely that you use the library incorrectly. Many new GUI
|
|
|
|
and base classes have been added or improved.
|
|
|
|
|
2012-07-03 15:58:51 -04:00
|
|
|
Compared to the previous 2.9.3 release the most important change is
|
|
|
|
the addition of new, still experimental, GTK+ 3 support in wxGTK.
|
|
|
|
But the main focus of this release is on incremental improvements
|
|
|
|
and fixing defects in preparation for 3.0 release. In particular,
|
|
|
|
wxOSX/Cocoa port has been significantly improved.
|
|
|
|
|
2010-07-18 09:39:16 -04:00
|
|
|
Please see the file docs/changes.txt for more details and make sure
|
|
|
|
to read the section "Incompatible changes since 2.8" if you upgrade
|
|
|
|
from a previous wxWidgets release.
|
|
|
|
|
|
|
|
This release introduces many important changes and we are looking
|
|
|
|
forward to your feedback about them. In particular please let us
|
|
|
|
know about any regressions compared to the previous versions (see
|
|
|
|
the section "Bug reporting" below) so that we could fix them before
|
|
|
|
3.0 release.
|
|
|
|
|
1999-10-26 11:16:29 -04:00
|
|
|
|
1998-12-31 12:32:18 -05:00
|
|
|
Platforms supported
|
1998-05-20 10:01:55 -04:00
|
|
|
-------------------
|
|
|
|
|
2010-07-18 09:39:16 -04:00
|
|
|
wxWidgets currently supports the following primary platforms:
|
1998-12-31 12:32:18 -05:00
|
|
|
|
2010-07-18 09:39:16 -04:00
|
|
|
- Windows 95/98/ME, NT, 2000, XP, Vista, 7
|
2012-07-03 01:37:02 -04:00
|
|
|
- Most Unix variants using the GTK+ toolkit (version 2.6 or newer)
|
2010-07-18 09:39:16 -04:00
|
|
|
- Mac OS X (10.4 or newer) using either Carbon or Cocoa
|
2008-08-27 07:06:49 -04:00
|
|
|
|
2010-07-18 09:39:16 -04:00
|
|
|
There is some support for the following platforms:
|
2008-08-27 07:06:49 -04:00
|
|
|
|
|
|
|
- Most Unix variants with X11
|
2002-09-08 08:35:21 -04:00
|
|
|
- Most Unix variants with Motif/Lesstif
|
2008-08-27 07:06:49 -04:00
|
|
|
- Most Unix variants with GTK+ 1.2
|
2012-07-02 11:56:47 -04:00
|
|
|
- Most Unix variants with GTK+ 3 (still in development)
|
2008-08-27 07:06:49 -04:00
|
|
|
- OS/2
|
2010-07-18 09:39:16 -04:00
|
|
|
- Windows CE (Pocket PC)
|
1999-01-31 13:47:10 -05:00
|
|
|
|
2000-02-12 05:44:03 -05:00
|
|
|
Most popular C++ compilers are supported; see the install.txt
|
2010-07-18 09:39:16 -04:00
|
|
|
file for each platform (available via docs/html/index.htm) and
|
|
|
|
http://wiki.wxwidgets.org/Supported_Platforms for the most up to
|
|
|
|
date status.
|
|
|
|
|
1998-12-31 12:32:18 -05:00
|
|
|
|
|
|
|
Files
|
|
|
|
-----
|
|
|
|
|
2011-07-04 17:26:11 -04:00
|
|
|
wxWidgets is distributed in source form in several archive formats.
|
|
|
|
ZIP and 7z archives are for Microsoft Windows users and contain the
|
|
|
|
files with DOS/Windows line endings while the compressed tar archives
|
|
|
|
for Unix systems users (including OS X) and contain the files with
|
|
|
|
Unix line endings. Please notice that some Windows tools still don't
|
|
|
|
accept files with Unix line endings and that compiling sources with
|
|
|
|
DOS line endings under Unix will fail, so please choose the correct
|
|
|
|
file for your system.
|
|
|
|
|
|
|
|
In addition to the sources, documentation in HTML, CHM and HTB
|
|
|
|
(wxWidgets help viewer) formats is provided as well as an installer
|
|
|
|
for Microsoft Windows. Notice that you will still need to compile
|
|
|
|
wxWidgets even when using the installer.
|
1999-02-19 16:54:37 -05:00
|
|
|
|
2012-07-09 10:15:37 -04:00
|
|
|
Experimentally, we also supply binaries of wxMSW libraries built
|
|
|
|
with several versions of Microsoft Visual C++ compiler for this
|
|
|
|
release. They are available in the "binaries" subdirectory, see
|
|
|
|
the description of the files in the README file there.
|
|
|
|
|
2010-07-18 09:39:16 -04:00
|
|
|
|
1998-12-31 12:32:18 -05:00
|
|
|
Installation
|
|
|
|
------------
|
|
|
|
|
2004-10-03 05:57:15 -04:00
|
|
|
wxWidgets needs to be compiled before you can test out the samples
|
|
|
|
or write your own applications. For installation information, please
|
2010-07-18 09:39:16 -04:00
|
|
|
see the install.txt file in the docs subdirectory appropriate for
|
|
|
|
the platform you use.
|
|
|
|
|
1998-05-20 10:01:55 -04:00
|
|
|
|
1998-12-31 13:18:56 -05:00
|
|
|
Licence information
|
1998-12-31 12:32:18 -05:00
|
|
|
-------------------
|
|
|
|
|
|
|
|
For licensing information, please see the files:
|
|
|
|
|
|
|
|
docs/preamble.txt
|
|
|
|
docs/licence.txt
|
|
|
|
docs/licendoc.txt
|
|
|
|
docs/gpl.txt
|
|
|
|
docs/lgpl.txt
|
2013-05-24 13:05:19 -04:00
|
|
|
docs/xserver.txt
|
1998-12-31 12:32:18 -05:00
|
|
|
|
1998-12-31 13:18:56 -05:00
|
|
|
Although this may seem complex, it is there to allow authors of
|
2005-04-17 06:34:19 -04:00
|
|
|
proprietary/commercial applications to use wxWidgets in addition
|
|
|
|
to those writing GPL'ed applications. In summary, the licence is
|
|
|
|
LGPL plus a clause allowing unrestricted distribution of
|
|
|
|
application binaries. To answer a FAQ, you don't have to
|
|
|
|
distribute any source if you wish to write commercial
|
2010-07-18 09:39:16 -04:00
|
|
|
applications using wxWidgets.
|
2005-04-17 06:34:19 -04:00
|
|
|
|
|
|
|
However, if you distribute wxGTK or wxMotif (with Lesstif)
|
|
|
|
version of your application, don't forget that it is linked
|
|
|
|
against GTK+ (or Lesstif) which is covered by LGPL *without*
|
|
|
|
exception notice. Under Linux systems your app is probably linked
|
|
|
|
against LGPL glibc as well. Please read carefully LGPL, section
|
|
|
|
6. which describes conditions for distribution of closed source
|
|
|
|
applications linked against LGPL library. Basically you should
|
|
|
|
link dynamically and include source code of LGPL libraries with
|
|
|
|
your product (unless it is already present in user's system -
|
2010-07-18 09:39:16 -04:00
|
|
|
like glibc usually is).
|
2000-01-28 20:12:45 -05:00
|
|
|
|
2000-02-27 16:06:38 -05:00
|
|
|
If you use TIFF image handler, please see src/tiff/COPYRIGHT
|
2003-08-14 17:00:13 -04:00
|
|
|
for libtiff licence details.
|
2000-02-27 16:06:38 -05:00
|
|
|
|
2005-04-17 06:34:19 -04:00
|
|
|
If you use JPEG image handler, documentation for your program
|
|
|
|
should contain following sentence: "This software is based in
|
|
|
|
part on the work of the Independent JPEG Group". See
|
|
|
|
src/jpeg/README for details.
|
2000-02-27 16:06:38 -05:00
|
|
|
|
2005-04-17 06:34:19 -04:00
|
|
|
If you use wxRegEx class on a system without native regular
|
|
|
|
expressions support (i.e. MS Windows), see src/regex/COPYRIGHT
|
|
|
|
file for Henry Spencer's regular expression library copyright.
|
2001-07-13 13:15:10 -04:00
|
|
|
|
2003-08-14 17:00:13 -04:00
|
|
|
If you use wxXML classes or XRC, see src/expat/COPYING for licence details.
|
|
|
|
|
2010-07-18 09:39:16 -04:00
|
|
|
|
1998-12-31 13:18:56 -05:00
|
|
|
Documentation
|
|
|
|
-------------
|
|
|
|
|
2010-07-18 09:39:16 -04:00
|
|
|
wxWidgets documentation is available online at
|
2012-07-10 19:51:44 -04:00
|
|
|
http://docs.wxwidgets.org/2.9.5/ and can also be downloaded in HTML
|
2010-07-18 09:39:16 -04:00
|
|
|
format. To generate documentation in other formats (PDF, CHM, ...)
|
|
|
|
please use the scripts in docs/doxygen directory.
|
1998-12-31 13:18:56 -05:00
|
|
|
|
2000-03-14 12:53:11 -05:00
|
|
|
|
2010-07-18 09:39:16 -04:00
|
|
|
Bug reporting
|
|
|
|
-------------
|
1999-11-08 09:53:39 -05:00
|
|
|
|
2008-06-06 20:01:39 -04:00
|
|
|
The wxWidgets bug tracker can be browsed at:
|
|
|
|
|
|
|
|
http://trac.wxwidgets.org/report
|
|
|
|
|
|
|
|
Please use the search function of our Trac installation to find
|
|
|
|
any possibly relevant bugs before reporting new ones. Also please
|
2008-06-06 21:24:56 -04:00
|
|
|
notice that often trying to correct the bug yourself is the
|
|
|
|
quickest way to fix it. Even if you fail to do it, you may
|
2008-06-06 20:01:39 -04:00
|
|
|
discover valuable information allowing us to fix it while doing
|
|
|
|
it. We also give much higher priority to bug reports with patches
|
|
|
|
fixing the problems so this ensures that your report will be
|
|
|
|
addressed sooner.
|
2002-09-07 06:16:03 -04:00
|
|
|
|
1998-12-31 13:18:56 -05:00
|
|
|
|
|
|
|
Further information
|
|
|
|
-------------------
|
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
The wxWidgets Web site is located at:
|
1998-12-31 13:18:56 -05:00
|
|
|
|
2011-06-29 13:49:59 -04:00
|
|
|
http://www.wxwidgets.org/
|
1998-12-31 13:18:56 -05:00
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
The main wxWidgets ftp site is at:
|
1998-12-31 13:18:56 -05:00
|
|
|
|
2011-06-29 13:49:59 -04:00
|
|
|
ftp://ftp.wxwidgets.org/pub/
|
1998-12-31 13:18:56 -05:00
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
A wxWidgets CD-ROM with the latest distribution plus an HTML
|
1998-12-31 13:18:56 -05:00
|
|
|
front-end and hundreds of MB of compilers, utilities and other
|
2004-05-04 04:27:20 -04:00
|
|
|
material may be ordered from the CD-ROM page: see the wxWidgets
|
2001-05-08 06:11:24 -04:00
|
|
|
web site.
|
1998-12-31 13:18:56 -05:00
|
|
|
|
2001-06-09 13:43:16 -04:00
|
|
|
Have fun!
|
1998-12-31 13:18:56 -05:00
|
|
|
|
2012-07-02 11:56:47 -04:00
|
|
|
The wxWidgets Team, July 2012
|