mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2025-02-15 23:07:16 +01:00
Move install docs into reference manual.
This commit is contained in:
parent
7b0da6c54a
commit
754d18b050
@ -1,3 +1,9 @@
|
|||||||
|
2003-04-09 Matthias Clasen <maclas@gmx.de>
|
||||||
|
|
||||||
|
* INSTALL:
|
||||||
|
* INSTALL.in: Remove list of configuration flags, since these
|
||||||
|
are already documented in docs/reference/glib/building.sgml.
|
||||||
|
|
||||||
2003-04-08 Matthias Clasen <maclas@gmx.de>
|
2003-04-08 Matthias Clasen <maclas@gmx.de>
|
||||||
|
|
||||||
* INSTALL: Move Cross-compliation information to reference manual.
|
* INSTALL: Move Cross-compliation information to reference manual.
|
||||||
|
@ -1,3 +1,9 @@
|
|||||||
|
2003-04-09 Matthias Clasen <maclas@gmx.de>
|
||||||
|
|
||||||
|
* INSTALL:
|
||||||
|
* INSTALL.in: Remove list of configuration flags, since these
|
||||||
|
are already documented in docs/reference/glib/building.sgml.
|
||||||
|
|
||||||
2003-04-08 Matthias Clasen <maclas@gmx.de>
|
2003-04-08 Matthias Clasen <maclas@gmx.de>
|
||||||
|
|
||||||
* INSTALL: Move Cross-compliation information to reference manual.
|
* INSTALL: Move Cross-compliation information to reference manual.
|
||||||
|
@ -1,3 +1,9 @@
|
|||||||
|
2003-04-09 Matthias Clasen <maclas@gmx.de>
|
||||||
|
|
||||||
|
* INSTALL:
|
||||||
|
* INSTALL.in: Remove list of configuration flags, since these
|
||||||
|
are already documented in docs/reference/glib/building.sgml.
|
||||||
|
|
||||||
2003-04-08 Matthias Clasen <maclas@gmx.de>
|
2003-04-08 Matthias Clasen <maclas@gmx.de>
|
||||||
|
|
||||||
* INSTALL: Move Cross-compliation information to reference manual.
|
* INSTALL: Move Cross-compliation information to reference manual.
|
||||||
|
@ -1,3 +1,9 @@
|
|||||||
|
2003-04-09 Matthias Clasen <maclas@gmx.de>
|
||||||
|
|
||||||
|
* INSTALL:
|
||||||
|
* INSTALL.in: Remove list of configuration flags, since these
|
||||||
|
are already documented in docs/reference/glib/building.sgml.
|
||||||
|
|
||||||
2003-04-08 Matthias Clasen <maclas@gmx.de>
|
2003-04-08 Matthias Clasen <maclas@gmx.de>
|
||||||
|
|
||||||
* INSTALL: Move Cross-compliation information to reference manual.
|
* INSTALL: Move Cross-compliation information to reference manual.
|
||||||
|
@ -1,3 +1,9 @@
|
|||||||
|
2003-04-09 Matthias Clasen <maclas@gmx.de>
|
||||||
|
|
||||||
|
* INSTALL:
|
||||||
|
* INSTALL.in: Remove list of configuration flags, since these
|
||||||
|
are already documented in docs/reference/glib/building.sgml.
|
||||||
|
|
||||||
2003-04-08 Matthias Clasen <maclas@gmx.de>
|
2003-04-08 Matthias Clasen <maclas@gmx.de>
|
||||||
|
|
||||||
* INSTALL: Move Cross-compliation information to reference manual.
|
* INSTALL: Move Cross-compliation information to reference manual.
|
||||||
|
@ -1,3 +1,9 @@
|
|||||||
|
2003-04-09 Matthias Clasen <maclas@gmx.de>
|
||||||
|
|
||||||
|
* INSTALL:
|
||||||
|
* INSTALL.in: Remove list of configuration flags, since these
|
||||||
|
are already documented in docs/reference/glib/building.sgml.
|
||||||
|
|
||||||
2003-04-08 Matthias Clasen <maclas@gmx.de>
|
2003-04-08 Matthias Clasen <maclas@gmx.de>
|
||||||
|
|
||||||
* INSTALL: Move Cross-compliation information to reference manual.
|
* INSTALL: Move Cross-compliation information to reference manual.
|
||||||
|
99
INSTALL
99
INSTALL
@ -37,7 +37,7 @@ configure. This forces libiconv to be used.
|
|||||||
|
|
||||||
Note that if you have libiconv installed in your default include
|
Note that if you have libiconv installed in your default include
|
||||||
search path (for instance, in /usr/local/), but don't enable
|
search path (for instance, in /usr/local/), but don't enable
|
||||||
it, you will get an error while compiling GTK+ because the
|
it, you will get an error while compiling GLib because the
|
||||||
iconv.h that libiconv installs hides the system iconv.
|
iconv.h that libiconv installs hides the system iconv.
|
||||||
|
|
||||||
If you are using the native iconv implementation on Solaris
|
If you are using the native iconv implementation on Solaris
|
||||||
@ -49,11 +49,11 @@ SUNWkiu8 packages.
|
|||||||
|
|
||||||
The native iconv on Compaq Tru64 doesn't contain support for
|
The native iconv on Compaq Tru64 doesn't contain support for
|
||||||
UTF-8, so you'll need to use GNU libiconv instead. (When
|
UTF-8, so you'll need to use GNU libiconv instead. (When
|
||||||
using GNU libiconv for GTK+, you'll need to use GNU libiconv
|
using GNU libiconv for GLib, you'll need to use GNU libiconv
|
||||||
for GNU gettext as well.) This probably applies to related
|
for GNU gettext as well.) This probably applies to related
|
||||||
operating systems as well.
|
operating systems as well.
|
||||||
|
|
||||||
Finally, for message catalog handling, GTK+ requires an implementation
|
Finally, for message catalog handling, GLib requires an implementation
|
||||||
of gettext(). If your system doesn't provide this functionality,
|
of gettext(). If your system doesn't provide this functionality,
|
||||||
you should use the libintl library from the GNU gettext package,
|
you should use the libintl library from the GNU gettext package,
|
||||||
available from:
|
available from:
|
||||||
@ -63,90 +63,14 @@ available from:
|
|||||||
The Nitty-Gritty
|
The Nitty-Gritty
|
||||||
================
|
================
|
||||||
|
|
||||||
The 'configure' script can be given a number of options to enable
|
Complete information about installing GLib can be found
|
||||||
and disable various features. For a complete list, type:
|
in the file:
|
||||||
|
|
||||||
./configure --help
|
docs/reference/glib/html/glib-building.html
|
||||||
|
|
||||||
A few of the more important ones:
|
Or online at:
|
||||||
|
|
||||||
* --prefix=PREFIX install architecture-independent files in PREFIX
|
http://developer.gnome.org/doc/API/2.0/glib/glib-building.html
|
||||||
[ Defaults to /usr/local ]
|
|
||||||
|
|
||||||
* --exec-prefix=EPREFIX install architecture-dependent files in EPREFIX
|
|
||||||
[ Defaults to the value given to --prefix ]
|
|
||||||
|
|
||||||
* --enable-debug=[yes/no/minimum] determines the amount of debugging
|
|
||||||
code to include. 'yes' will includes some
|
|
||||||
extra checks and debugging features that
|
|
||||||
may be useful for people developing with
|
|
||||||
GLib. 'no' produces a somewhat smaller and
|
|
||||||
faster library at the expense of reduced
|
|
||||||
robustness.
|
|
||||||
[ Defaults to 'minimum' for stable releases ]
|
|
||||||
|
|
||||||
* --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.
|
|
||||||
[ --disable-gc-friendly is default ]
|
|
||||||
|
|
||||||
* --disable-mem-pools Do not cache freed objects. When specified,
|
|
||||||
GLib will immediately return freed memory
|
|
||||||
to the C library instead of keeping around
|
|
||||||
pools of free objects such as linked list
|
|
||||||
and hash table nodes. Specifying this
|
|
||||||
will make GLib slower in most cases, but it
|
|
||||||
will use less memory.
|
|
||||||
[ --enable-mem-pools is the 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.
|
|
||||||
[ --enable-threads is the 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 ]
|
|
||||||
|
|
||||||
* --enable-included-printf=[yes/no/auto] Specify whether to build using
|
|
||||||
the included copy of the Trio library
|
|
||||||
for string formatting functions like printf().
|
|
||||||
The default is 'auto', which means that
|
|
||||||
Trio will be used if configure detects
|
|
||||||
missing features in your system native
|
|
||||||
printf implementation.
|
|
||||||
|
|
||||||
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
|
Installation directories
|
||||||
@ -182,8 +106,13 @@ Cross-compiling GLib
|
|||||||
Information about cross-compilation of GLib can be found
|
Information about cross-compilation of GLib can be found
|
||||||
in the file:
|
in the file:
|
||||||
|
|
||||||
docs/reference/glib/docs/reference/glib/html/glib-cross-compiling.html
|
docs/reference/glib/html/glib-cross-compiling.html
|
||||||
|
|
||||||
Or online at:
|
Or online at:
|
||||||
|
|
||||||
http://developer.gnome.org/doc/API/2.0/glib/glib-cross-compiling.html
|
http://developer.gnome.org/doc/API/2.0/glib/glib-cross-compiling.html
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
210
INSTALL.in
210
INSTALL.in
@ -37,7 +37,7 @@ configure. This forces libiconv to be used.
|
|||||||
|
|
||||||
Note that if you have libiconv installed in your default include
|
Note that if you have libiconv installed in your default include
|
||||||
search path (for instance, in /usr/local/), but don't enable
|
search path (for instance, in /usr/local/), but don't enable
|
||||||
it, you will get an error while compiling GTK+ because the
|
it, you will get an error while compiling GLib because the
|
||||||
iconv.h that libiconv installs hides the system iconv.
|
iconv.h that libiconv installs hides the system iconv.
|
||||||
|
|
||||||
If you are using the native iconv implementation on Solaris
|
If you are using the native iconv implementation on Solaris
|
||||||
@ -49,11 +49,11 @@ SUNWkiu8 packages.
|
|||||||
|
|
||||||
The native iconv on Compaq Tru64 doesn't contain support for
|
The native iconv on Compaq Tru64 doesn't contain support for
|
||||||
UTF-8, so you'll need to use GNU libiconv instead. (When
|
UTF-8, so you'll need to use GNU libiconv instead. (When
|
||||||
using GNU libiconv for GTK+, you'll need to use GNU libiconv
|
using GNU libiconv for GLib, you'll need to use GNU libiconv
|
||||||
for GNU gettext as well.) This probably applies to related
|
for GNU gettext as well.) This probably applies to related
|
||||||
operating systems as well.
|
operating systems as well.
|
||||||
|
|
||||||
Finally, for message catalog handling, GTK+ requires an implementation
|
Finally, for message catalog handling, GLib requires an implementation
|
||||||
of gettext(). If your system doesn't provide this functionality,
|
of gettext(). If your system doesn't provide this functionality,
|
||||||
you should use the libintl library from the GNU gettext package,
|
you should use the libintl library from the GNU gettext package,
|
||||||
available from:
|
available from:
|
||||||
@ -63,90 +63,14 @@ available from:
|
|||||||
The Nitty-Gritty
|
The Nitty-Gritty
|
||||||
================
|
================
|
||||||
|
|
||||||
The 'configure' script can be given a number of options to enable
|
Complete information about installing GLib can be found
|
||||||
and disable various features. For a complete list, type:
|
in the file:
|
||||||
|
|
||||||
./configure --help
|
docs/reference/glib/html/glib-building.html
|
||||||
|
|
||||||
A few of the more important ones:
|
Or online at:
|
||||||
|
|
||||||
* --prefix=PREFIX install architecture-independent files in PREFIX
|
http://developer.gnome.org/doc/API/2.0/glib/glib-building.html
|
||||||
[ Defaults to /usr/local ]
|
|
||||||
|
|
||||||
* --exec-prefix=EPREFIX install architecture-dependent files in EPREFIX
|
|
||||||
[ Defaults to the value given to --prefix ]
|
|
||||||
|
|
||||||
* --enable-debug=[yes/no/minimum] determines the amount of debugging
|
|
||||||
code to include. 'yes' will includes some
|
|
||||||
extra checks and debugging features that
|
|
||||||
may be useful for people developing with
|
|
||||||
GLib. 'no' produces a somewhat smaller and
|
|
||||||
faster library at the expense of reduced
|
|
||||||
robustness.
|
|
||||||
[ Defaults to 'minimum' for stable releases ]
|
|
||||||
|
|
||||||
* --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.
|
|
||||||
[ --disable-gc-friendly is default ]
|
|
||||||
|
|
||||||
* --disable-mem-pools Do not cache freed objects. When specified,
|
|
||||||
GLib will immediately return freed memory
|
|
||||||
to the C library instead of keeping around
|
|
||||||
pools of free objects such as linked list
|
|
||||||
and hash table nodes. Specifying this
|
|
||||||
will make GLib slower in most cases, but it
|
|
||||||
will use less memory.
|
|
||||||
[ --enable-mem-pools is the 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.
|
|
||||||
[ --enable-threads is the 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 ]
|
|
||||||
|
|
||||||
* --enable-included-printf=[yes/no/auto] Specify whether to build using
|
|
||||||
the included copy of the Trio library
|
|
||||||
for string formatting functions like printf().
|
|
||||||
The default is 'auto', which means that
|
|
||||||
Trio will be used if configure detects
|
|
||||||
missing features in your system native
|
|
||||||
printf implementation.
|
|
||||||
|
|
||||||
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
|
Installation directories
|
||||||
@ -167,7 +91,7 @@ and should be deleted.
|
|||||||
|
|
||||||
.pc files for the various libraries are installed in
|
.pc files for the various libraries are installed in
|
||||||
$exec_prefix/lib/pkgconfig to provide information when compiling
|
$exec_prefix/lib/pkgconfig to provide information when compiling
|
||||||
other packages that depend on GTK+. If you set PKG_CONFIG_PATH
|
other packages that depend on GLib. If you set PKG_CONFIG_PATH
|
||||||
so that it points to this directory, then you can get the
|
so that it points to this directory, then you can get the
|
||||||
correct include flags and library flags for compiling a GLib
|
correct include flags and library flags for compiling a GLib
|
||||||
application with:
|
application with:
|
||||||
@ -179,117 +103,9 @@ application with:
|
|||||||
Cross-compiling GLib
|
Cross-compiling GLib
|
||||||
====================
|
====================
|
||||||
|
|
||||||
Cross-compilation is the proceess of compiling a program or
|
Information about cross-compilation of GLib can be found
|
||||||
library on a different architecture or operating system then
|
in the file:
|
||||||
it will be run upon. GLib is slightly more difficult to
|
|
||||||
cross-compile than many packages because much of GLib is
|
|
||||||
about hiding differences between different systems.
|
|
||||||
|
|
||||||
These notes cover things specific to cross-compiling GLib;
|
docs/reference/glib/html/glib-cross-compiling.html
|
||||||
for general information about cross-compilation, see the
|
|
||||||
autoconf info pages.
|
|
||||||
|
|
||||||
GLib tries to detect as much information as possible about
|
Or online at:
|
||||||
the target system by compiling and linking programs without
|
|
||||||
actually running anything; however, some information GLib
|
|
||||||
needs is not available this way. This information needs
|
|
||||||
to be provided to the configure script via a "cache file"
|
|
||||||
or by setting the cache variables in your environment.
|
|
||||||
|
|
||||||
As an example of using a cache file, to cross compile for
|
|
||||||
the "MingW32" Win32 runtine environment on a Linux system,
|
|
||||||
create a file 'win32.cache' with the following contents:
|
|
||||||
|
|
||||||
===
|
|
||||||
glib_cv_long_long_format=ll
|
|
||||||
glib_cv_stack_grows=no
|
|
||||||
===
|
|
||||||
|
|
||||||
Then execute the following commands:
|
|
||||||
|
|
||||||
===
|
|
||||||
PATH=/path/to/mingw32-compiler/bin:$PATH
|
|
||||||
chmod a-w win32.cache # prevent configure from changing it
|
|
||||||
./configure --cache-file=win32.cache --host=mingw32
|
|
||||||
===
|
|
||||||
|
|
||||||
The complete list of cache file variables follows. Most
|
|
||||||
of these won't need to be set in most cases.
|
|
||||||
|
|
||||||
Cache file variables
|
|
||||||
====================
|
|
||||||
|
|
||||||
glib_cv_long_long_format=[ll/q/I64]
|
|
||||||
|
|
||||||
Format used by printf and scanf for 64 bit integers. "ll" is
|
|
||||||
the C99 standard, and what is used by the 'trio' library
|
|
||||||
that GLib builds if your printf() is insufficiently capable.
|
|
||||||
Doesn't need to be set if you are compiling using trio.
|
|
||||||
|
|
||||||
glib_cv_stack_grows=[yes/no]
|
|
||||||
|
|
||||||
Whether the stack grows up or down. Most places will want "no",
|
|
||||||
A few architectures, such as PA-RISC need "yes".
|
|
||||||
|
|
||||||
glib_cv_working_bcopy=[yes/no]
|
|
||||||
|
|
||||||
Whether your bcopy can handle overlapping copies. Only needs to be set
|
|
||||||
if you don't have memmove. (Very unlikely)
|
|
||||||
|
|
||||||
glib_cv_sane_realloc=[yes/np]
|
|
||||||
|
|
||||||
Whether your realloc() conforms to ANSI C and can handle NULL as
|
|
||||||
the first argument. Defaults to "yes" and probably doesn't need to be set.
|
|
||||||
|
|
||||||
glib_cv_have_strlcpy=[yes/no]
|
|
||||||
|
|
||||||
Whether you have strlcpy that matches OpenBSD. Defaults to "no",
|
|
||||||
which is safe, since GLib uses a built-in version in that case.
|
|
||||||
|
|
||||||
glib_cv_va_val_copy=[yes/no]
|
|
||||||
|
|
||||||
Whether va_list can be copied as a pointer. If set to "no",
|
|
||||||
then memcopy will be used. Only matters if you don't have
|
|
||||||
va_copy or __va_copy. (So, doesn't matter for GCC.) Defaults
|
|
||||||
to "yes" which is slightly more common than "no".
|
|
||||||
|
|
||||||
glib_cv_rtldglobal_broken=[yes/no]
|
|
||||||
|
|
||||||
Whether you have a bug found in OSF/1 v5.0. Defaults to "no".
|
|
||||||
|
|
||||||
glib_cv_uscore=[yes/no]
|
|
||||||
|
|
||||||
Whether an underscore needs to be prepended to symbols when
|
|
||||||
looking them up via dlsym. Only needs to be set if your system
|
|
||||||
uses dlopen/dlsym.
|
|
||||||
|
|
||||||
ac_cv_func_posix_getpwuid_r=[yes/no]
|
|
||||||
|
|
||||||
Whether you have a getpwuid_r function (in your C library,
|
|
||||||
not your thread library) that conforms to the POSIX spec.
|
|
||||||
(Takes a 'struct passwd **' as the final argument)
|
|
||||||
|
|
||||||
ac_cv_func_nonposix_getpwuid_r=[yes/no]
|
|
||||||
|
|
||||||
Whether you have some variant of getpwuid_r that doesn't
|
|
||||||
conform to to the POSIX spec, but GLib might be able to
|
|
||||||
use (or might segfault.) Only needs to be set if
|
|
||||||
ac_cv_func_posix_getpwuid_r is not set. It's safest to set
|
|
||||||
this to "no".
|
|
||||||
|
|
||||||
glib_cv_use_pid_surrogate=[yes/no]
|
|
||||||
|
|
||||||
Whether to use a setpriority() on the PID of the thread as
|
|
||||||
a method for setting the priority of threads. This only
|
|
||||||
needs to be set when using POSIX threads.
|
|
||||||
|
|
||||||
ac_cv_func_printf_unix98=[yes/no]
|
|
||||||
|
|
||||||
Whether your printf() family supports Unix98 style %N$
|
|
||||||
positional parameters. Defaults to "no".
|
|
||||||
|
|
||||||
ac_cv_func_vsnprintf_c99=[yes/no]
|
|
||||||
|
|
||||||
Whether you have a vsnprintf() with C99 semantics. (C99 semantics
|
|
||||||
means returns the number of bytes that would have been written
|
|
||||||
had the output buffer had enough space.). Defaults to "no".
|
|
||||||
|
@ -1,3 +1,9 @@
|
|||||||
|
2003-04-09 Matthias Clasen <maclas@gmx.de>
|
||||||
|
|
||||||
|
* glib/glib-docs.sgml: Move dependencies to building.sgml.
|
||||||
|
|
||||||
|
* glib/building.sgml: Move stuff from INSTALL here.
|
||||||
|
|
||||||
2003-04-08 Matthias Clasen <maclas@gmx.de>
|
2003-04-08 Matthias Clasen <maclas@gmx.de>
|
||||||
|
|
||||||
* glib/cross.sgml: New file; cross-compilation information.
|
* glib/cross.sgml: New file; cross-compilation information.
|
||||||
|
@ -10,7 +10,7 @@
|
|||||||
<refpurpose>
|
<refpurpose>
|
||||||
How to compile GLib itself
|
How to compile GLib itself
|
||||||
</refpurpose>
|
</refpurpose>
|
||||||
</refnamediv>
|
</refnamediv>
|
||||||
|
|
||||||
<refsect1 id="building">
|
<refsect1 id="building">
|
||||||
<title>Building the Library on UNIX</title>
|
<title>Building the Library on UNIX</title>
|
||||||
@ -39,14 +39,122 @@ How to compile GLib itself
|
|||||||
<command>./configure --help</command> for information about
|
<command>./configure --help</command> for information about
|
||||||
the standard options.
|
the standard options.
|
||||||
</para>
|
</para>
|
||||||
|
<para>
|
||||||
|
The GTK+ documentation contains
|
||||||
|
<ulink url="../gtk/gtk-building.html">further details</ulink>
|
||||||
|
about the build process and ways to influence it.
|
||||||
|
</para>
|
||||||
</refsect1>
|
</refsect1>
|
||||||
|
<refsect1 id="dependencies">
|
||||||
|
<title>Dependencies</title>
|
||||||
|
<para>
|
||||||
|
Before you can compile the GLib library, you need to have
|
||||||
|
various other tools and libraries installed on your
|
||||||
|
system. The two tools needed during the build process (as
|
||||||
|
differentiated from the tools used in when creating GLib
|
||||||
|
mentioned above such as <application>autoconf</application>)
|
||||||
|
are <command>pkg-config</command> and GNU make.
|
||||||
|
</para>
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
<ulink
|
||||||
|
url="http://www.freedesktop.org/software/pkgconfig/">pkg-config</ulink>
|
||||||
|
is a tool for tracking the compilation flags needed for
|
||||||
|
libraries that are used by the GLib library. (For each
|
||||||
|
library, a small <literal>.pc</literal> text file is
|
||||||
|
installed in a standard location that contains the compilation
|
||||||
|
flags needed for that library along with version number
|
||||||
|
information.) The version of <command>pkg-config</command>
|
||||||
|
needed to build GLib is mirrored in the
|
||||||
|
<filename>dependencies</filename> directory
|
||||||
|
on the <ulink url="ftp://ftp.gtk.org/pub/gtk/v2.2/">GTK+ FTP
|
||||||
|
site.</ulink>
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
The GTK+ makefiles will mostly work with different versions
|
||||||
|
of <command>make</command>, however, there tends to be
|
||||||
|
a few incompatibilities, so the GTK+ team recommends
|
||||||
|
installing <ulink url="http://www.gnu.org/software/make">GNU
|
||||||
|
make</ulink> if you don't already have it on your system
|
||||||
|
and using it. (It may be called <command>gmake</command>
|
||||||
|
rather than <command>make</command>.)
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
<para>
|
||||||
|
GLib depends on a number of other libraries.
|
||||||
|
</para>
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
The <ulink url="http://www.gnu.org/software/libiconv/">GNU
|
||||||
|
libiconv library</ulink> is needed to build GLib if your
|
||||||
|
system doesn't have the <function>iconv()</function>
|
||||||
|
function for doing conversion between character
|
||||||
|
encodings. Most modern systems should have
|
||||||
|
<function>iconv()</function>, however many older systems lack
|
||||||
|
an <function>iconv()</function> implementation. On such systems,
|
||||||
|
you must install the libiconv library. This can be found at:
|
||||||
|
<ulink url="http://www.gnu.org/software/libiconv">http://www.gnu.org/software/libiconv</ulink>.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
If your system has an <function>iconv()</function> implementation but
|
||||||
|
you want to use libiconv instead, you can pass the
|
||||||
|
--with-libiconv option to configure. This forces
|
||||||
|
libiconv to be used.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
Note that if you have libiconv installed in your default include
|
||||||
|
search path (for instance, in <filename>/usr/local/</filename>), but
|
||||||
|
don't enable it, you will get an error while compiling GLib because
|
||||||
|
the <filename>iconv.h</filename> that libiconv installs hides the
|
||||||
|
system iconv.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
If you are using the native iconv implementation on Solaris
|
||||||
|
instead of libiconv, you'll need to make sure that you have
|
||||||
|
the converters between locale encodings and UTF-8 installed.
|
||||||
|
At a minimum you'll need the SUNWuiu8 package. You probably
|
||||||
|
should also install the SUNWciu8, SUNWhiu8, SUNWjiu8, and
|
||||||
|
SUNWkiu8 packages.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
The native iconv on Compaq Tru64 doesn't contain support for
|
||||||
|
UTF-8, so you'll need to use GNU libiconv instead. (When
|
||||||
|
using GNU libiconv for GLib, you'll need to use GNU libiconv
|
||||||
|
for GNU gettext as well.) This probably applies to related
|
||||||
|
operating systems as well.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
The libintl library from the <ulink
|
||||||
|
url="http://www.gtk.org/software/gettext">GNU gettext
|
||||||
|
package</ulink> is needed if your system doesn't have the
|
||||||
|
<function>gettext()</function> functionality for handling
|
||||||
|
message translation databases.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
A thread implementation is needed, unless you want to compile GLib
|
||||||
|
without thread support, which is not recommended. The thread support
|
||||||
|
in GLib can be based upon several native thread implementations,
|
||||||
|
e.g. POSIX threads, DCE threads or Solaris threads.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
|
||||||
|
</refsect1>
|
||||||
<refsect1 id="extra-configuration-options">
|
<refsect1 id="extra-configuration-options">
|
||||||
<title>Extra Configuration Options</title>
|
<title>Extra Configuration Options</title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
In addition to the normal options, the
|
In addition to the normal options, the
|
||||||
<command>configure</command> script in the GTK+
|
<command>configure</command> script in the GLib
|
||||||
library supports these additional arguments:
|
library supports these additional arguments:
|
||||||
|
|
||||||
<cmdsynopsis>
|
<cmdsynopsis>
|
||||||
@ -70,8 +178,8 @@ How to compile GLib itself
|
|||||||
<arg>--with-threads=[none|posix|dce|solaris|win32]</arg>
|
<arg>--with-threads=[none|posix|dce|solaris|win32]</arg>
|
||||||
</group>
|
</group>
|
||||||
<group>
|
<group>
|
||||||
<arg>--disable-included-printf</arg>
|
<arg>--disable-included-printf</arg>
|
||||||
<arg>--enable-included-printf</arg>
|
<arg>--enable-included-printf</arg>
|
||||||
</group>
|
</group>
|
||||||
<group>
|
<group>
|
||||||
<arg>--disable-gtk-doc</arg>
|
<arg>--disable-gtk-doc</arg>
|
||||||
@ -93,7 +201,7 @@ How to compile GLib itself
|
|||||||
even mostly bug-free software by changing the effect of many bugs
|
even mostly bug-free software by changing the effect of many bugs
|
||||||
from simple warnings into fatal crashes. Thus
|
from simple warnings into fatal crashes. Thus
|
||||||
<option>--enable-debug=no</option> should <emphasis>not</emphasis>
|
<option>--enable-debug=no</option> should <emphasis>not</emphasis>
|
||||||
be used for stable releases of gtk+.
|
be used for stable releases of GLib.
|
||||||
</para>
|
</para>
|
||||||
</formalpara>
|
</formalpara>
|
||||||
|
|
||||||
@ -127,7 +235,8 @@ How to compile GLib itself
|
|||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<structname>GList</structname>, <structname>GSList</structname>,
|
<structname>GList</structname>, <structname>GSList</structname>,
|
||||||
<structname>GNode</structname> allocations
|
<structname>GNode</structname>, <structname>GHash</structname>
|
||||||
|
allocations
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
@ -178,7 +287,7 @@ How to compile GLib itself
|
|||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>
|
<listitem><para>
|
||||||
'posix' and 'dce' can be used interchangeable
|
'posix' and 'dce' can be used interchangeable
|
||||||
to mean the different versions of posix
|
to mean the different versions of Posix
|
||||||
threads. configure tries to find out, which
|
threads. configure tries to find out, which
|
||||||
one is installed.
|
one is installed.
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
@ -191,7 +300,7 @@ How to compile GLib itself
|
|||||||
'none' means that GLib will be thread safe,
|
'none' means that GLib will be thread safe,
|
||||||
but does not have a default thread
|
but does not have a default thread
|
||||||
implementation. This has to be supplied to
|
implementation. This has to be supplied to
|
||||||
g_thread_init() by the programmer.
|
<function>g_thread_init()</function> by the programmer.
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
|
|
||||||
@ -199,8 +308,8 @@ How to compile GLib itself
|
|||||||
</formalpara>
|
</formalpara>
|
||||||
|
|
||||||
<formalpara>
|
<formalpara>
|
||||||
<title><systemitem>--disable-included-printf</systemitem> and
|
<title><systemitem>--disable-included-printf</systemitem> and
|
||||||
<systemitem>--enable-included-printf</systemitem></title>
|
<systemitem>--enable-included-printf</systemitem></title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
By default the <command>configure</command> script will try
|
By default the <command>configure</command> script will try
|
||||||
|
@ -78,32 +78,6 @@ loop abstraction, and so on. It works on many UNIX-like platforms, Windows,
|
|||||||
OS/2 and BeOS. GLib is released under the GNU Library General Public License
|
OS/2 and BeOS. GLib is released under the GNU Library General Public License
|
||||||
(GNU LGPL).
|
(GNU LGPL).
|
||||||
</para>
|
</para>
|
||||||
<para>
|
|
||||||
GLib depends on the following:
|
|
||||||
<variablelist>
|
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term><function>iconv()</function></term>
|
|
||||||
<listitem><para>
|
|
||||||
In order to implement conversions between character sets,
|
|
||||||
GLib requires an implementation of the standard <function>iconv()</function>
|
|
||||||
routine. Most modern systems will have a suitable implementation, however
|
|
||||||
many older systems lack an <function>iconv()</function> implementation. On
|
|
||||||
such systems, you must install the
|
|
||||||
<ulink url="http://clisp.cons.org/~haible/packages-libiconv.html">libiconv</ulink> library.
|
|
||||||
</para></listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term>a thread implementation</term>
|
|
||||||
<listitem><para>
|
|
||||||
The thread support in GLib can be based upon several native thread
|
|
||||||
implementations, e.g. POSIX threads, DCE threads or Solaris threads.
|
|
||||||
</para></listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
</variablelist>
|
|
||||||
</para>
|
|
||||||
|
|
||||||
&glib-Building;
|
&glib-Building;
|
||||||
&glib-Cross;
|
&glib-Cross;
|
||||||
|
Loading…
x
Reference in New Issue
Block a user