Name change replacements
[wxWidgets.git] / docs / gtk / readme.txt
1
2    Welcome to wxWidgets/Gtk 2.5
3
4 You have downloaded version 2.5 of the GTK port of the 
5 wxWidgets GUI library.
6
7 wxWidgets no longer supports GTK 1.0 (as did some early
8 snapshots) so that you will need GTK 1.2 when using it.
9 GTK 1.2.6 or above is recommended although some programs 
10 will work with GTK 1.2.3 onwards. There is now support
11 for GTK 2.0.
12
13 More info about the wxWidgets project (including the
14 Windows, X11/Motif and other ports) can be found at the main
15 wxWidgets homepage at:
16
17                   http://www.wxwidgets.org
18   
19 Information on how to install can be found in the file 
20 INSTALL.txt, but if you cannot wait, this should work on
21 many systems:
22
23     mkdir gtk
24     cd gtk
25     ../configure --with-gtk
26     make
27     su <type root password>
28     make install
29     ldconfig
30
31 In order to use wxGTK with GTK 2.0 you need to use --enable-gtk2
32 configure option. To build the library in Unicode mode (all
33 strings will be wide strings and so on) you need to configure
34 with GTK 2.0 and add --enable-unicode.
35
36 Note that so far, support for GTK 2.0 has only been tested on
37 Linux with glibc 2.2.
38
39
40 Please note that it is strongly advised to build the library in
41 a separate directory, as shown above, as it allows you to have
42 different builds of it (for example with and without debug) in
43 parallel. If you build in the source directory, don't forget to
44 do "make clean" before changing the configuration!
45
46
47 When you run into problems, please read the INSTALL.txt and 
48 follow those instructions. If you still don't have any success,
49 please send a bug report to one of our mailing list, INCLUDING 
50 A DESCRIPTION OF YOUR SYSTEM AND YOUR PROBLEM, SUCH AS YOUR 
51 VERSION OF GTK, WXGTK, WHAT DISTRIBUTION YOU USE AND WHAT ERROR 
52 WAS REPORTED. I know this has no effect, but I tried...
53
54 The library produced by the install process will be called 
55 libwx_gtk.a (static, only buil if --disable-shared configure
56 switch was used or if shared libraries are not supported at all
57 on your platform which is quite unlikely) and
58 libwx_gtk-2.2.so.0.0.0 (shared) so that once a binary
59 incompatible version of wxWidgets/Gtk comes out we'll augment
60 the library version number to avoid linking problems.
61
62 Please send problems concerning installation, feature requests, 
63 bug reports or comments to the wxWidgets users list. Information 
64 on how to subscribe is available from my homepage.
65
66 Do NOT send any comments directly to me.
67
68 wxWidgets/Gtk doesn't come with any guarantee whatsoever. It 
69 might crash your harddisk or destroy your monitor. It doesn't 
70 claim to be suitable for any special or general purpose.
71
72   Regards,
73
74     Robert Roebling
75
76
77