updated xti sample

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

diff --git a/docs/gtk/readme.txt b/docs/gtk/readme.txt
index 36e8d2272c69b7b3d8aa7d9ede6896ba15ee3c89..89fcbec894dd4c83efc6981bb0a5135328602610 100644 (file)
--- a/docs/gtk/readme.txt
+++ b/docs/gtk/readme.txt
@@ -1,50 +1,70 @@
+   Welcome to wxWidgets for GTK+
+   -----------------------------

 
 

-  Welcome to wxWindows/Gtk,
+You have downloaded the GTK+ port of the wxWidgets GUI library.
+
+It is required to use at least GTK+ 2.4 and some features are 
+only available when using GTK+ 2.8 or higher. Note that if you
+compile wxWidgets against GTK+ 2.8 your app will still work
+with older GTK+ version down to version 2.4 as wxWidgets
+tests for the presence of newer features at run-time and it
+will fall back to a generic implementation if these features
+are not present in the GTK+ version used.
+
+wxWidgets 2.8 still supports GTK+ 1.2, but no developement
+is done on that port anymore and support for GTK+ 1.2 will
+probably be dropped entirely. Indeed, one of the major steps
+in the developement cycle leading up to wxWidgets 2.8 was
+that the codebase for GTK+ 1.2 and GTK+ 2.0 were separated
+so that improvements and clean-ups to the GTK+ 2.0 port 
+could be done without caring for GTK+ 1.2.
+
+More info about the wxWidgets project (including all the
+other ports and version of wxWidgets) can be found at the
+main wxWidgets homepage at:
+
+                  http://www.wxwidgets.org/

   
   

-you have downloaded version 1.99 of the GTK+ port of C++ library
-wxWindows. Information on how to install can be found in the
-file INSTALL.txt, but if you cannot wait, this should work on
-all systems
+Information on how to install can be found in the file 
+INSTALL.txt, but if you cannot wait, this should work on
+many systems:
+
+    mkdir build_gtk
+    cd build_gtk
+    ../configure
+    make
+    su <type root password>
+    make install
+    ldconfig

 
 

-configure --without-threads
-make
-su (PASSWORD)
-make install
+In order to use wxGTK with GTK 1.2 you need to use --with-gtk=1
+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.

 
 

-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...
-
-This is the beta release which means that we have a feature
-freeze. We'll move up to versin 2.0 rather soon and from then
-on there will be no more binary incompatible changes. We might
-add more classes, but none that would alter the behaviour of
-the existing ones. The library produced by the install process
-of the final version will be called libwx_gtk_1_0.a (static)
-and libwx_gtk_1_0.so.2.0.0 (shared) so that once a version
-of wxWindows/Gtk for GTK 1.2 comes out we'll change the name
-of the library to avoid linking problems.
-
-More information is available from my homepage at
-
-  http://wesley.informatik.uni-freiburg.de/~wxxt
-  
+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...
+

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

-bug reports or comments to either the wxGTK mailing list or to
-the wxWindows developers list. Information on how to subscribe
-is available from my homepage.
+bug reports or comments to the wxWidgets users list. These can
+be found at http://www.wxwidgets.org and more specifically at 
+http://lists.wxwidgets.org.

 
 

-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 purpose.
+wxWidgets 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,
 
     Robert Roebling
 
 
   Regards,
 
     Robert Roebling
 

-
-