]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/gtk/readme.txt
file not needed any longer after ZIP r/w patch
[wxWidgets.git] / docs / gtk / readme.txt
index cdf339cce4dda6c5c5b54057ecb5736077a510b8..2b9ccf1e9e8ba7144c60726fcebf722a21d2ed4d 100644 (file)
@@ -1,64 +1,73 @@
 
-  Welcome to wxWindows/Gtk 2.1 snapshot 3,
+   Welcome to wxWidgets/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 -
-Particularly the makefile system will change entirly.
-More information is available from my homepage at:
+You have downloaded version 2.5 of the GTK port of the 
+wxWidgets GUI library.
 
-  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:
+wxWidgets 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 info about the wxWidgets project (including the
+Windows, X11/Motif and other ports) can be found at the main
+wxWidgets homepage at:
 
-  http://web.ukonline.co.uk/julian.smart/wxwin
+                  http://www.wxwidgets.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 (when using GTK 1.0 read the INSTALL.txt):
+many systems:
 
-./configure
-make
-su <type root password>
-ldconfig
-make install
-exit
+    mkdir gtk
+    cd gtk
+    ../configure --with-gtk
+    make
+    su <type root password>
+    make install
+    ldconfig
 
-Type the following to make the samples
+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.
 
-make samples
+Note that so far, support for GTK 2.0 has only been tested on
+Linux with glibc 2.2.
 
-To start the samples, change into the directory that
-corresponds to the sample and your system, e.g on a
-linux-gnu machine the minimal sample would get started
-from the wxWindows base dir with
 
-./samples/minimal/linux-gnu/minimal
+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
+
+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 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 
-libwx_gtk2.a (static) and libwx_gtk2.so.1.0 (shared) so that 
-once a binary incompatible version of wxWindows/Gtk comes out 
-we'll augment 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 wxWidgets/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 Information on 
-how to subscribe is available from my homepage.
+bug reports or comments to the wxWidgets 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 migh
-crash your harddisk or destroy your monitor. It doesn't claim to be
-suitable for any special purpose.
+wxWidgets/Gtk doesn't come with any guarantee whatsoever. I
+might crash your harddisk or destroy your monitor. It doesn't 
+claim to be suitable for any special or general purpose.
 
   Regards,