Pileus Git - ~andy/gtk/blob - INSTALL

   1 Simple install procedure
   2 ========================
   3
   4   % gzip -cd gtk-1.0.0.tar.gz | tar xvf - # unpack the sources
   5   % cd gtk-1.0.0                          # change to the toplevel directory
   6   % ./configure                           # run the `configure' script
   7   % make                                  # build GTK
   8   [ Become root if necessary ]
   9   % make install                          # install GTK
  10
  11 The Nitty-Gritty
  12 ================
  13
  14 The 'configure' script can be given a number of options to enable
  15 and disable various features. For a complete list, type:
  16
  17   ./configure --help
  18
  19 A few of the more important ones:
  20
  21 *  --prefix=PREFIX         install architecture-independent files in PREFIX
  22                            [ Defaults to /usr/local ]
  23
  24 *  --exec-prefix=EPREFIX   install architecture-dependent files in EPREFIX
  25                            [ Defaults to the value given to --prefix ]
  26
  27 *  --with-xinput=[no/gxi/xfree] support XInput [default=no]
  28
  29 The --with-xinput flag specifies whether to compile with support
  30 for the XInput extension (mainly used for graphics tablets), and
  31 which form of support to use:
  32
  33   no    : no support
  34   gxi   : Use generic XInput support
  35   xfree : Use special features in the Wacom drivers in XFree86 3.3.1
  36           and later.
  37
  38 For more information, follow the link from http://www.gtk.org
  39
  40 *  --enable-xim            support XIM [default=yes]
  41
  42 Specifying --disable-xim will disable support for entering
  43 internationalized text using X Input Methods. This will give some
  44 slight savings in speed and memory use and might be necessary
  45 with older versions of X.
  46
  47 *  --with-locale=LOCALE   locale name you want to use
  48
  49 The --with-locale options is used to determine if your operating
  50 system has support for the locale you will be using. If not, X's
  51 built in locale support will be used.
  52
  53 Because of bugs in autoconf, it is necessary to specify this
  54 option even if your LANG environment variable is correctly set.
  55
  56 This option does not determine which locale GTK will use at
  57 runtime. That will be determined from the usual environment
  58 variables.  If you will be using multiple locales with GTK,
  59 specify the one for which your operating system has the worst
  60 support for the --with-locale option.
  61
  62
  63 Options can be given to the compiler and linker by setting
  64 environment variables before running configure. A few of the more
  65 important ones:
  66
  67  CC       : The C compiler to use
  68  CPPFLAGS : Flags for the C preprocesser such as -I and -D
  69  CFLAGS   : C compiler flags
  70
  71 The most important use of this is to set the
  72 optimization/debugging flags. For instance, to compile with no
  73 debugging information at all, run configure as:
  74
  75  CFLAGS=-O2 ./configure           # Bourne compatible shells (sh/bash/zsh)
  76
  77 or,
  78
  79  setenv CFLAGS -O2 ; ./configure  # csh and variants
  80
  81
  82 Installation directories
  83 ========================
  84
  85 The location of the installed files is determined by the --prefix
  86 and --exec-prefix options given to configure. There are also more
  87 detailed flags to control individual directories. However, the
  88 use of these flags is not tested.
  89
  90 One particular detail to note, is that the architecture-dependent
  91 include file glibconfig.h is installed in:
  92
  93   $exec_pref/lib/glib/include/
  94
  95 if you have a version in $prefix/include, this is out of date
  96 and should be deleted.
  97
  98 A shell script gtk-config is created during the configure
  99 process, and installed in the bin/ directory
 100 ($exec_prefix/bin). This is used to determine the location of GTK
 101 when building applications.  If you move GTK after installation,
 102 it will be necessary to edit this file.
 103
 104 For complete details, see the file docs/gtk-config.txt
 105
 106
 107 Notes for using XIM support for Japanese input
 108 ==============================================
 109
 110 * There is a bug in older versions of kinput2 that will cause GTK
 111 to hang when destroying a text entry. The latest versions of
 112 kinput is available from:
 113
 114   ftp://ftp.sra.co.jp/pub/x11/kinput2
 115
 116 * The locale information file for the ja_JP EUC locale
 117 distributed with some recent versions of X11 specifies to use the
 118 C library multibyte functions. Unless your C library has support
 119 for Japanese locales, this is incorrect, and will cause problems
 120 for GTK's internationalization.
 121
 122 (In particular, this occurs with GNU libc 2.0 and 2.1, in which
 123 the multibyte functions always translate to and from UTF-8; but
 124 the problem may occur for other C libraries, and other operating
 125 systems as well.)
 126
 127 To fix this, change the line:
 128
 129 use_stdc_env            True
 130
 131 to
 132
 133 use_stdc_env            False
 134
 135 in the file /usr/X11R6/lib/X11/locale/ja_JP/XLC_LOCALE.
 136
 137