INSTALL 4.91 KB
Newer Older
1 2 3 4 5 6
Prerequisites
=============

GTK+ requires the GLIB library, available at the same location as
you got this package.

7 8 9
Simple install procedure
========================

10 11
  % gzip -cd gtk+-1.1.6.tar.gz | tar xvf - # unpack the sources
  % cd gtk+-1.1.6                          # change to the toplevel directory
12 13
  % ./configure                            # run the `configure' script
  % make                                   # build GTK
14
  [ Become root if necessary ]
15
  % make install                           # install GTK
16 17 18 19 20 21 22

The Nitty-Gritty
================

The 'configure' script can be given a number of options to enable
and disable various features. For a complete list, type:

23 24
  ./configure --help

25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45
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 
  gxi   : Use generic XInput support
  xfree : Use special features in the Wacom drivers in XFree86 3.3.1
          and later.

For more information, follow the link from http://www.gtk.org

46 47 48
*  --enable-xim            support XIM [default=yes]

Specifying --disable-xim will disable support for entering
49 50
internationalized text using X Input Methods. This will give some
slight savings in speed and memory use and might be necessary
51 52
with older versions of X.

53
*  --with-locale=LOCALE   locale name you want to use
54 55

The --with-locale options is used to determine if your operating
56 57
system has support for the locale you will be using. If not, X's
built in locale support will be used.
58

59 60
Because of bugs in autoconf, it is necessary to specify this
option even if your LANG environment variable is correctly set.
61 62

This option does not determine which locale GTK will use at
63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87
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


88 89 90 91 92 93 94
Using an uninstalled copy of GLIB
=================================

You can compile GTK+ against a copy of GLIB that you have not
yet installed. To do this, give the --with-glib=DIR options
to ./configure. For instance:

95
 ./configure --with-glib=../glib-1.1.6
96 97 98 99 100

This, however, will not work if you built GLIB with different
source and build directories.


101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123
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
124 125


Owen Taylor's avatar
Owen Taylor committed
126
Notes for using XIM support for Japanese input
127
==============================================
128

129 130 131
* 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:
132 133

  ftp://ftp.sra.co.jp/pub/x11/kinput2
Owen Taylor's avatar
Owen Taylor committed
134 135

* The locale information file for the ja_JP EUC locale
136 137 138 139 140 141 142 143 144
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 and 2.1, 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.)
Owen Taylor's avatar
Owen Taylor committed
145 146 147 148 149 150 151 152 153 154 155 156

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.