readme.txt
1 Welcome to wxWidgets for GTK+
2 -----------------------------
3
4You have downloaded the GTK+ port of the wxWidgets GUI library.
5
6It is recommended to use at least GTK+ 2.2.3 to get the
7most out of wxWidgets and some features are only available
8when using GTK+ 2.4 or even from GTK+ 2.8. Note that if you
9compile wxWidgets against GTK+ 2.8 your app will still work
10with older GTK+ version down to version 2.2 as wxWidgets
11tests for the presence of newer features at run-time and it
12will fall back to a generic implementation if these features
13are not present in the GTK+ version used.
14
15wxWidgets 2.8 still supports GTK+ 1.2, but no developement
16is done on that port anymore and support for GTK+ 1.2 will
17probably be dropped entirely. Indeed, one of the major steps
18in the developement cycle leading up to wxWidgets 2.8 was
19that the codebase for GTK+ 1.2 and GTK+ 2.0 were separated
20so that improvements and clean-ups to the GTK+ 2.0 port
21could be done without caring for GTK+ 1.2.
22
23More info about the wxWidgets project (including all the
24other ports and version of wxWidgets) can be found at the
25main wxWidgets homepage at:
26
27 http://www.wxwidgets.org/
28
29Information on how to install can be found in the file
30INSTALL.txt, but if you cannot wait, this should work on
31many systems:
32
33 mkdir build_gtk
34 cd build_gtk
35 ../configure
36 make
37 su <type root password>
38 make install
39 ldconfig
40
41In order to use wxGTK with GTK 1.2 you need to use --with-gtk=1
42configure option. To build the library in Unicode mode (all
43strings will be wide strings and so on) you need to configure
44with GTK 2.0 and add --enable-unicode.
45
46Please note that it is strongly advised to build the library in
47a separate directory, as shown above, as it allows you to have
48different builds of it (for example with and without debug) in
49parallel. If you build in the source directory, don't forget to
50do "make clean" before changing the configuration!
51
52When you run into problems, please read the INSTALL.txt and
53follow those instructions. If you still don't have any success,
54please send a bug report to one of our mailing list, INCLUDING
55A DESCRIPTION OF YOUR SYSTEM AND YOUR PROBLEM, SUCH AS YOUR
56VERSION OF GTK, WXGTK, WHAT DISTRIBUTION YOU USE AND WHAT ERROR
57WAS REPORTED. I know this has no effect, but I tried...
58
59Please send problems concerning installation, feature requests,
60bug reports or comments to the wxWidgets users list. These can
61be found at http://www.wxwidgets.org and more specifically at
62http://lists.wxwidgets.org.
63
64wxWidgets doesn't come with any guarantee whatsoever. It
65might crash your harddisk or destroy your monitor. It doesn't
66claim to be suitable for any special or general purpose.
67
68 Regards,
69
70 Robert Roebling
71
72