mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-12-26 15:36:14 +01:00
cca5009912
Sat Feb 23 21:36:51 2002 Owen Taylor <otaylor@redhat.com>
* configure.in: 1.3.15, binary, interface age 0.
* NEWS: Updated.
118 lines
4.7 KiB
Plaintext
118 lines
4.7 KiB
Plaintext
Simple install procedure
|
|
========================
|
|
|
|
% gzip -cd glib-1.3.15.tar.gz | tar xvf - # unpack the sources
|
|
% cd glib-1.3.15 # 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 ]
|
|
|
|
* --enable-gc-friendly When enabled all memory freed by the application,
|
|
but retained by GLib for performance reasons
|
|
is set to zero, thus making deployed garbage
|
|
collection or memory profiling tools detect
|
|
unlinked memory correctly. This will make GLib
|
|
slightly slower.
|
|
[ Disabled by default ]
|
|
|
|
* --disable-threads Do not compile GLib to be multi thread safe. GLib
|
|
will be slightly faster then. This is however not
|
|
recommended, as many programs rely on GLib being
|
|
multi thread safe.
|
|
[ Enabled by default ]
|
|
|
|
* --with-threads=[none/posix/dce/solaris/win32] Specify a thread
|
|
implementation to use.
|
|
* 'posix' and 'dce' can be used interchangeable
|
|
to mean the different versions of posix
|
|
threads. configure tries to find out, which
|
|
one is installed.
|
|
* 'solaris' uses the native Solaris thread
|
|
implementation.
|
|
* 'none' means that GLib will be thread safe,
|
|
but does not have a default thread
|
|
implementation. This has to be supplied to
|
|
g_thread_init() by the programmer.
|
|
[ Determined by configure by default ]
|
|
|
|
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.
|
|
|