| Simple install procedure |
| ======================== |
| |
| % gzip -cd glib-1.3.7.tar.gz | tar xvf - # unpack the sources |
| % cd glib-1.3.7 # change to the toplevel directory |
| % ./configure # run the `configure' script |
| % make # build GLIB |
| |
| [ Become root if necessary ] |
| % rm -rf /install-prefix/include/glib.h /install-prefix/include/gmodule.h |
| % make install # install GLIB |
| |
| Requirements |
| ============ |
| |
| In order to implement conversions between character sets, |
| GLib requires an implementation of the standard iconv() routine. |
| Most modern systems will have a suitable implementation, however |
| many older systems lack an iconv() implementation. On such systems, |
| you must install the libiconv library. This can be found at: |
| |
| http://clisp.cons.org/~haible/packages-libiconv.html |
| |
| If your system has an iconv implementation but you want to use |
| libiconv instead, you can pass the --with-libiconv option to |
| configure. This forces libiconv to be used. |
| |
| Note that if you have libiconv installed in your default include |
| search path (for instance, in /usr/local/), but don't enable |
| it, you will get an error while compiling GTK+ because the |
| iconv.h that libiconv installs hides the system iconv. |
| |
| 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 ] |
| |
| 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 |
| |
| |
| 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 glib-config is created during the configure |
| process, and installed in the bin/ directory |
| ($exec_prefix/bin). This is used to determine the location of glib |
| when building applications. If you move glib after installation, |
| it will be necessary to edit this file. |
| |