testing wxComboBox::SetBackgroundColour()

[wxWidgets.git] / docs / gtk / readme.txt

diff --git a/docs/gtk/readme.txt b/docs/gtk/readme.txt
index 5dd853ff8ee1cf0566a7612e7c55b309f98807b8..6b29045711e6e32754c60466aa5b17415fb6a5ac 100644 (file)
--- a/docs/gtk/readme.txt
+++ b/docs/gtk/readme.txt
@@ -1,58 +1,73 @@
 
 

-  Welcome to wxWindows/Gtk 2.1 snapshot 6,
+   Welcome to wxWindows/Gtk 2.5

 
 

-you have downloaded version 2.1 of the GTK+ 1.2 port of 
-the wxWindows GUI library. This is a developers release
-and is it not suited for production development. Beware
-that major changes can happen before a final release.
+You have downloaded version 2.5 of the GTK port of the 
+wxWindows GUI library.

 
 

-Beginning from snapshot 6 wxWindows uses a completely
-new make file system on Unix that uses GNU automake,
-GNU autoconf and GNU autoheader. You do not need these
-programs in order to use the library, but for taking
-part in its development, they are required.
+wxWindows no longer supports GTK 1.0 (as did some early
+snapshots) so that you will need GTK 1.2 when using it.
+GTK 1.2.6 or above is recommended although some programs 
+will work with GTK 1.2.3 onwards. There is now support
+for GTK 2.0.

 
 

-More information is available from my homepage at:
+More info about the wxWindows project (including the
+Windows, X11/Motif and other ports) can be found at the main
+wxWindows homepage at:

 
 

-  http://wesley.informatik.uni-freiburg.de/~wxxt
-  
-and about the wxWindows project as a whole (and the
-Windows and Motif ports in particular) can be found
-at Julian Smart's homepage at:
-
-  http://web.ukonline.co.uk/julian.smart/wxwin
+                  http://www.wxwindows.org

   
 Information on how to install can be found in the file 
 INSTALL.txt, but if you cannot wait, this should work on
   
 Information on how to install can be found in the file 
 INSTALL.txt, but if you cannot wait, this should work on

-many systems (when using GTK 1.0 read the INSTALL.txt):
+many systems:
+
+    mkdir gtk
+    cd gtk
+    ../configure --with-gtk
+    make
+    su <type root password>
+    make install
+    ldconfig
+
+In order to use wxGTK with GTK 2.0 you need to use --enable-gtk2
+configure option. To build the library in Unicode mode (all
+strings will be wide strings and so on) you need to configure
+with GTK 2.0 and add --enable-unicode.

 
 

-./configure
-make
-su <type root password>
-make install
-ldconfig
-exit
+Note that so far, support for GTK 2.0 has only been tested on
+Linux with glibc 2.2.

 
 

-When you run into problems, please read the INSTALL.txt and
+
+Please note that it is strongly advised to build the library in
+a separate directory, as shown above, as it allows you to have
+different builds of it (for example with and without debug) in
+parallel. If you build in the source directory, don't forget to
+do "make clean" before changing the configuration!
+
+
+When you run into problems, please read the INSTALL.txt and 

 follow those instructions. If you still don't have any success,
 follow those instructions. If you still don't have any success,

-please send a bug report to one of our mailing lists (see
-my homepage) INCLUDING A DESCRIPTION OF YOUR SYSTEM AND 
-YOUR PROBLEM, SUCH AS YOUR VERSION OF GTK, WXGTK, WHAT
-DISTRIBUTION YOU USE AND WHAT ERROR WAS REPORTED. I know 
-this has no effect, but I tried...
+please send a bug report to one of our mailing list, INCLUDING 
+A DESCRIPTION OF YOUR SYSTEM AND YOUR PROBLEM, SUCH AS YOUR 
+VERSION OF GTK, WXGTK, WHAT DISTRIBUTION YOU USE AND WHAT ERROR 
+WAS REPORTED. I know this has no effect, but I tried...

 
 The library produced by the install process will be called 
 
 The library produced by the install process will be called 

-libwx_gtk.a (static) and libwx_gtk-2.1.so.0.0.0 (shared) so that 
-once a binary incompatible version of wxWindows/Gtk comes out 
-we'll augment the library version number to avoid linking problems.
+libwx_gtk.a (static, only buil if --disable-shared configure
+switch was used or if shared libraries are not supported at all
+on your platform which is quite unlikely) and
+libwx_gtk-2.2.so.0.0.0 (shared) so that once a binary
+incompatible version of wxWindows/Gtk comes out we'll augment
+the library version number to avoid linking problems.

 
 Please send problems concerning installation, feature requests, 
 
 Please send problems concerning installation, feature requests, 

-bug reports or comments to the wxWindows users Information on 
-how to subscribe is available from my homepage.
+bug reports or comments to the wxWindows users list. Information 
+on how to subscribe is available from my homepage.
+
+Do NOT send any comments directly to me.

 
 

-wxWindows/Gtk doesn't come with any guarantee whatsoever. It might 
-crash your harddisk or destroy your monitor. It doesn't claim to be
-suitable for any special or general purpose.
+wxWindows/Gtk doesn't come with any guarantee whatsoever. It 
+might crash your harddisk or destroy your monitor. It doesn't 
+claim to be suitable for any special or general purpose.

 
   Regards,
 
 
   Regards,