X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=INSTALL;h=f002dc7592bb13cf0d8c1292c9c08e61f7dc7998;hb=1493f6f7d4f4b49cc95fc1693cbee19fd3573503;hp=4fecd0a213c655fc1f67b2aea8b07b734155f30b;hpb=dd34bcca5e6627c8a269c9232a8906e3bd8947df;p=~andy%2Fgtk diff --git a/INSTALL b/INSTALL index 4fecd0a21..f002dc759 100644 --- a/INSTALL +++ b/INSTALL @@ -1,36 +1,186 @@ -The 'configure' script can be given a number of options to -enable and disable various features. For a complete list, -type: +Prerequisites +============= + +GTK+ requires the following packages: + + - The GLIB, Pango, and Atk libraries, available at the same location as GTK+ + + - 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: + + http://www.libtiff.org/ + ftp://swrinde.nde.swri.edu/pub/png/src/ + ftp://ftp.uu.net/graphics/jpeg/ + + 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. + +Simple install procedure +======================== + + % gzip -cd gtk+-1.3.10.tar.gz | tar xvf - # unpack the sources + % cd gtk+-1.3.10 # change to the toplevel directory + % ./configure # run the `configure' script + % make # build GTK + [ Become root if necessary ] + % make install # install GTK + +The Nitty-Gritty +================ + +The 'configure' script can be given a number of options to enable +and disable various features. For a complete list, type: + ./configure --help +A few of the more important ones: + +* --prefix=PREFIX install architecture-independent files in PREFIX + [ Defaults to /usr/local ] + +* --exec-prefix=EPREFIX install architecture-dependent files in EPREFIX + [ Defaults to the value given to --prefix ] + +* --with-xinput=[no/gxi/xfree] support XInput [default=no] + +The --with-xinput flag specifies whether to compile with support +for the XInput extension (mainly used for graphics tablets), and +which form of support to use: + + no : no support + xfree : Use special features in the Wacom drivers in XFree86 3.3.1 + and later. + gxi : Use generic XInput support (not recommended) + +The XInput support is not known to work with any other XServer than +XFree86. For more information about XInput, see: + + http://www.gtk.org/~otaylor/xinput/howto/index.html + http://www.lepied.com/xfree86/ + +* --disable-nls do not use Native Language Support + +If this flag is not specified, GTK+ will try to find +and use the gettext() set of functions to provide translations +of the strings in the standard dialogs into the +user's native language. + * --enable-xim support XIM [default=yes] 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 +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. -* --with-locale=LOCALE locale name you want to use +* --with-locale=LOCALE locale name you want to use 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. +system has support for the locale you will be using. If not, X's +built in locale support will be used. -Because of bugs in autoconf, it is necessary to specify this option -even if your LANG environment variable is correctly set. +Because of bugs in autoconf, it is necessary to specify this +option even if your LANG environment variable is correctly set. 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. +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. + + +Options can be given to the compiler and linker by setting +environment variables before running configure. A few of the more +important ones: + + CC : The C compiler to use + CPPFLAGS : Flags for the C preprocesser such as -I and -D + CFLAGS : C compiler flags + +The most important use of this is to set the +optimization/debugging flags. For instance, to compile with no +debugging information at all, run configure as: + CFLAGS=-O2 ./configure # Bourne compatible shells (sh/bash/zsh) -Note for using XIM support with kinput2 ---------------------------------------- +or, -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: + setenv CFLAGS -O2 ; ./configure # csh and variants + +Native-Language Support and gettext() +===================================== + +To provide native-language support (NLS) GTK+ uses the +gettext() set of functions. These functions are found +in the C library on many systems, such as the Solaris +C library and the GNU C Library, version 2. + +If your C library does not provide the necessary functionality, +you may wish to install the GNU gettext package. You'll +need version 0.10.35 or better. Version 0.10.35 is +available from ftp://alpha.gnu.org/pub/gnu + +Generally, GTK+ will properly detect what is installed +on your system and enable or disable NLS as appropriate. +However, in rare cases, it may be necessary to disable +NLS manually to get GTK+ to compile. You can do this +by specifying the --disable-nls flag when configuring +GTK+. + +Installation directories +======================== + +The location of the installed files is determined by the --prefix +and --exec-prefix options given to configure. There are also more +detailed flags to control individual directories. However, the +use of these flags is not tested. + +One particular detail to note, is that the architecture-dependent +include file glibconfig.h is installed in: + + $exec_pref/lib/glib/include/ + +if you have a version in $prefix/include, this is out of date +and should be deleted. + +A shell script gtk-config is created during the configure +process, and installed in the bin/ directory +($exec_prefix/bin). This is used to determine the location of GTK +when building applications. If you move GTK after installation, +it will be necessary to edit this file. + +For complete details, see the file docs/gtk-config.txt + + +Notes for using XIM support for Japanese input +============================================== + +* 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: ftp://ftp.sra.co.jp/pub/x11/kinput2 + +* The locale information file for the ja_JP EUC locale +distributed with some recent versions of X11 specifies to use the +C library multibyte functions. Unless your C library has support +for Japanese locales, this is incorrect, and will cause problems +for GTK's internationalization. + +(In particular, this occurs with GNU libc 2.0 in which +the multibyte functions always translate to and from UTF-8; but +the problem may occur for other C libraries, and other operating +systems as well.) + +To fix this, change the line: + +use_stdc_env True + +to + +use_stdc_env False + +in the file /usr/X11R6/lib/X11/locale/ja_JP/XLC_LOCALE. + +