From a705770e832e3656d862783acb8d9b292ffa4a83 Mon Sep 17 00:00:00 2001 From: Owen Taylor Date: Tue, 24 Mar 1998 01:54:02 +0000 Subject: [PATCH] Added some documentation about why the configuration for GTK could be Mon Mar 23 20:51:53 1998 Owen Taylor * INSTALL configure.in: Added some documentation about why the configuration for GTK could be failing, and pointed to it in the failure message. --- ChangeLog | 6 ++++++ INSTALL | 44 +++++++++++++++++++++++++++++++++++++++++++- configure.in | 8 +++++++- 3 files changed, 56 insertions(+), 2 deletions(-) diff --git a/ChangeLog b/ChangeLog index 8483d74224..9e8008d25b 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +Mon Mar 23 20:51:53 1998 Owen Taylor + + * INSTALL configure.in: Added some documentation + about why the configuration for GTK could be failing, + and pointed to it in the failure message. + Sun Mar 22 18:27:57 EST 1998 Adrian Likins * plugins/dbbrowser/dbbrowser_utils.c: diff --git a/INSTALL b/INSTALL index 6384479236..cc244fae7e 100644 --- a/INSTALL +++ b/INSTALL @@ -1,7 +1,7 @@ There are three basic steps to building and installing the GIMP on unix: - 1. You need to have installed GTK version 0.99.5 or better + 1. You need to have installed GTK version 0.99.7 or better 2. You may want to install other third party libraries that are needed for some of the available plugins: TIFF, PNG, JPEG, MPEG, etc. @@ -68,6 +68,48 @@ the libgimp library, the plug-ins, and the GIMP executable. After running `make install' and assuming the build process was successful you should be able to run `gimp'. +When ./configure fails +====================== + +'configure' tries to compile and run a short GTK program. There are +several reasons why this might fail: + +* The 'gtk-config' script installed with GTK could not be found. + (This script is used to get information about where GTK is + installed.) + + Fix: Either make sure that this program is in your path, or set + the environment variable GTK_CONFIG to the full pathname to + this program before running configure. + +* The GTK libraries were not found at run time. The details + of how to fix this problem will depend on the system: + + Fix: On Linux and other systems using ELF libraries, add the + directory to /etc/ld.so.conf or to the environment variable + LD_LIBRARY_PATH, and run 'ldconfig'. + + On other systems, it may be necessary to encode this path + into the executable, by setting the LDFLAGS environment variable + before running configure. For example: + + LDFLAGS="-R/home/joe/lib" ./configure + or + LDFLAGS="-Wl,-rpath -Wl,/home/joe/lib" ./configure + +* An old version of the GTK libraries was found instead of + your newly installed version. This commonly happens if a + binary package of GTK was previously installed on your system, + and you later compiled GTK from source. + + Fix: remove the old libraries and include files. + +A detailed log of the ./configure output is written to the file +config.log. This may help diagnose problems. + +After fixing a problem, it is safest to delete the file 'config.cache' +before re-running ./configure. + Generic Instructions for Building Auto-Configured Packages ========================================================== diff --git a/configure.in b/configure.in index 4ec69132b9..dca6f59b70 100644 --- a/configure.in +++ b/configure.in @@ -43,7 +43,7 @@ fi) AC_DEFUN(AC_GIMP_CHECK, [ AM_PATH_GTK(0.99.7,, - AC_MSG_ERROR(Cannot include/link gtk/gdk/glib--check CFLAGS/LDFLAGS)) + AC_MSG_ERROR(Test for GTK failed. See the file 'INSTALL' for help.)) X_LIBS=$GTK_LIBS X_CFLAGS=$GTK_CFLAGS AC_SUBST(X_LIBS) @@ -62,6 +62,12 @@ AC_PROG_LN_S AC_PROG_MAKE_SET AC_GIMP_CHECK +gimp_save_CFLAGS="$CFLAGS" +gimp_save_LIBS="$LIBS" + +CFLAGS="$GTK_CFLAGS $CFLAGS" +LIBS="$LIBS $GTK_LIBS" + if eval "test x$GCC = xyes"; then if echo "$CFLAGS" | grep "\-Wall" > /dev/null 2> /dev/null; then CFLAGS="$CFLAGS"