X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=INSTALL.in;h=4b59bcefd2f48fd1cdfe4bedc009f7d0e6f34d14;hb=83b4e2efc6cc641798df582a618bb227b6f63eb6;hp=6992b0d70aa033d5ec4149eb456bfcf245d940e6;hpb=42cc312df65ba892bfc21e638f109c77be3cd00e;p=~andy%2Fgtk diff --git a/INSTALL.in b/INSTALL.in index 6992b0d70..4b59bcefd 100644 --- a/INSTALL.in +++ b/INSTALL.in @@ -3,184 +3,32 @@ Prerequisites GTK+ requires the following packages: - - The GLIB, Pango, and Atk libraries, available at the same location as GTK+ + - The GLib, Pango, GdkPixbuf, ATK and cairo libraries, available at + the same location as GTK+. GTK+ @GTK_VERSION@ requires at least + GLib @GLIB_REQUIRED_VERSION@, Pango @PANGO_REQUIRED_VERSION@, + GdkPixbuf @GDK_PIXBUF_REQUIRED_VERSION@, ATK @ATK_REQUIRED_VERSION@ + and cairo @CAIRO_REQUIRED_VERSION@. - - 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. + - gobject-introspection @INTROSPECTION_REQUIRED_VERSION@ or newer. Simple install procedure ======================== % gzip -cd gtk+-@GTK_VERSION@.tar.gz | tar xvf - # unpack the sources - % cd gtk+-@GTK_VERSION@ # change to the toplevel directory - % ./configure # run the `configure' script - % make # build GTK + % cd gtk+-@GTK_VERSION@ # 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 -with older versions of X. - -* --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. - -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. - - -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) - -or, - - 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 + % make install # install GTK+ -to +The Details +=========== -use_stdc_env False +Complete information about installing GTK+ and related libraries +can be found in the file: -in the file /usr/X11R6/lib/X11/locale/ja_JP/XLC_LOCALE. + docs/reference/gtk/html/gtk-building.html +Or online at: + http://library.gnome.org/devel/gtk/stable/gtk-building.html