2.4 -> 2.5; build in another directory than source one; mention --disable-shared

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@20150 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

docs/gtk/readme.txt

@@ -1,7 +1,7 @@
 
-   Welcome to wxWindows/Gtk 2.4
+   Welcome to wxWindows/Gtk 2.5
 
-you have downloaded version 2.4 of the GTK port of the 
+You have downloaded version 2.5 of the GTK port of the 
 wxWindows GUI library.
 
 wxWindows no longer supports GTK 1.0 (as did some early
@@ -10,32 +10,40 @@ 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 info about the wxWindows project (and the Windows
+More info about the wxWindows project (including the
-and Motif ports in particular) can be found at Julian's 
+Windows, X11/Motif and other ports) can be found at the main
-homepage at:
+wxWindows homepage at:
 
-  http://www.wxwindows.org
+                  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
 many systems:
 
-./configure --with-gtk
+    mkdir gtk
-make
+    cd gtk
-su <type root password>
+    ../configure --with-gtk
-make install
+    make
-ldconfig
+    su <type root password>
-exit
+    make install
+    ldconfig
 
-In order to use wxGTK with GTK 2.0 and its unicode
+In order to use wxGTK with GTK 2.0 you need to use --enable-gtk2
-support, you need to configure
+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 --with-gtk --enable-gtk2 --enable-unicode
+Note that so far, support for GTK 2.0 has only been tested on
-etc.
-
-So far, support for GTK 2.0 has only been tested on
 Linux with glibc 2.2.
 
+
+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,
 please send a bug report to one of our mailing list, INCLUDING 
@@ -44,10 +52,12 @@ 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 
-libwx_gtk.a (static) and libwx_gtk-2.2.so.0.0.0 (shared) so 
+libwx_gtk.a (static, only buil if --disable-shared configure
-that once a binary incompatible version of wxWindows/Gtk comes 
+switch was used or if shared libraries are not supported at all
-out we'll augment the library version number to avoid linking 
+on your platform which is quite unlikely) and
-problems.
+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, 
 bug reports or comments to the wxWindows users list. Information