- exit with $? instead of 1 in case of failure

[~andy/gtk] / INSTALL

diff --git a/INSTALL b/INSTALL
index 4fecd0a213c655fc1f67b2aea8b07b734155f30b..1dd49e46c84c4ff2821b12bd16deb5b5291f1319 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -1,36 +1,43 @@
-The 'configure' script can be given a number of options to
-enable and disable various features. For a complete list,
-type:
-  ./configure --help
+Prerequisites
+=============
 
-*  --enable-xim            support XIM [default=yes]
+GTK+ requires the following packages:
 
-Specifying --disable-xim will disable support for entering
-internationalized text using X Input Methods. This will give
-some slight savings in speed and memory use and might be necessary
-with older versions of X.
+ - The GLib, Pango, and Atk libraries, available at the same location as GTK+
+   (Either Pango-1.0 or Pango-1.2 can be used with GTK+-2.2; 
+   Pango-1.2 is recommended.)
 
-* --with-locale=LOCALE    locale name you want to use
+ - The TIFF, PNG, and JPEG image loading libraries. You most
+   likely have these installed on your system already. If not
+   these libraries are available from:
 
-The --with-locale options is used to determine if your operating
-system has support for the locale you will be using. If not, X's built
-in locale support will be used.
+    http://www.libtiff.org/
+    ftp://swrinde.nde.swri.edu/pub/png/src/
+    ftp://ftp.uu.net/graphics/jpeg/
 
-Because of bugs in autoconf, it is necessary to specify this option
-even if your LANG environment variable is correctly set.
+   If these libraries are not available, the corresponding 
+   image loaders will simply not be built. However, this
+   may cause applications using GTK+ not to function properly.
 
-This option does not determine which locale GTK will use at
-runtime. That will be determined from the usual environment variables.
-If you will be using multiple locales with GTK, specify the one
-for which your operating system has the worst support for the 
---with-locale option.
+Simple install procedure
+========================
 
+  % gzip -cd gtk+-2.3.4.tar.gz | tar xvf - # unpack the sources
+  % cd gtk+-2.3.4                         # change to the toplevel directory
+  % ./configure                                   # run the `configure' script
+  % make                                  # build GTK
+  [ Become root if necessary ]
+  % make install                          # install GTK
 
-Note for using XIM support with kinput2
----------------------------------------
+The Details
+===========
 
-There is a bug in older versions of kinput2 that will cause 
-GTK to hang when destroying a text entry. The latest versions
-of kinput is available from:
+Complete information about installing GTK+ and related libraries can be found 
+in the file:
+
+ docs/reference/gtk/html/gtk-building.html
+
+Or online at:
+
+ http://developer.gnome.org/doc/API/2.0/gtk/gtk-building.html
 
-  ftp://ftp.sra.co.jp/pub/x11/kinput2