When sending bug reports tell us what version of wxWidgets you are
using (including the beta) and what compiler on what system. One
- example: wxGTK 2.6.2, gcc 2.95.4, Redhat 6.2
+ example: wxGTK 2.6.3, gcc 3.4.5, Fedora Core 4
* The simplest case
-------------------
---------------
wxWidgets/GTK+ requires the GTK+ library to be installed on your system. It has
-to be a stable version, preferably version 1.2.10 (at least 1.2.3 is required,
-1.2.7 is strongly recommended).
+to be a stable version, preferably GTK+ 2.x.y, where x is an even number.
+GTK+ version 1.2 is highly discouraged, but if you decide to still use it,
+please use version 1.2.10 (at least 1.2.3 is required, 1.2.7 is strongly recommended).
You can get the newest version of the GTK+ from the GTK+ homepage at:
wxWidgets no longer supports GTK 1.0.x (as did some early
snapshots) and support for GTK 1.2.x will be phased out
over time. Nearly all work is now done on GTK 2.0.x and
-quite a few of the enhancements of GTK+ 2.2.x and even
-GTK 2.4.x are used.
+quite a few of the enhancements of GTK+ 2.4.x and even
+GTK 2.8.x are used.
More info about the wxWidgets project (including all the
other ports and version of wxWidgets) can be found at the
\section{wxGTK port}\label{wxgtkport}
-wxGTK is a port of wxWidgets using the GTK+ library available
-from www.gtk.org. It makes use of GTK+'s native widgets wherever
-possible and uses wxWidgets' generic controls when needed. GTK+
-itself has been ported to a number of systems, but so far only the
-original X11 version is supported. Support for the recently released
-GTK+ 2.0 including Unicode support is work in progress.
+wxGTK is a port of wxWidgets using the GTK+ library.
+It makes use of GTK+'s native widgets wherever possible and uses
+wxWidgets' generic controls when needed. GTK+ itself has been
+ported to a number of systems, but so far only the original X11
+version is supported. Support for other GTK+ backends is planned,
+such as the new DirectFB backend.
-You will need GTK+ 1.2.3 or higher which is available from:
+All work is being done on GTK+ version 2.0 and above. Support for
+GTK+ 1.2 will be deprecated in a later release.
+
+You will need GTK+ 2.0 or higher which is available from:
\urlref{http://www.gtk.org}{http://www.gtk.org}
+The newer version of GTK+ you use, the more native widgets and
+features will be utilized. We have gone to a great extent to
+allow compiling wxWidgets applications with a latest version of
+GTK+, with the resulting binary working on systems even with a
+much lower version of GTK+. You will have to ensure that the
+application is launched with lazy symbol binding for that.
+
In order to configure wxWidgets to compile wxGTK you will
-need to type:
+need use the {\tt --with-gtk} argument to the {\tt configure} script.
+This is the default for many systems.
-\begin{verbatim}
- configure --with-gtk
-\end{verbatim}
+GTK+ 1.2 can still be used, albeit discouraged. For that you can
+pass {\tt --with-gtk=1} to the {\tt configure} script.
For further information, please see the files in docs/gtk
in the distribution.