+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+]>
<refentry id="gtk-building" revision="6 Sept 2001">
<refmeta>
<refentrytitle>Compiling the GTK+ libraries</refentrytitle>
of the tools are already included in the source packages. But
it's useful to know a bit about how packages that use these
tools work. A source package is distributed as a
- <literal>tar.gz</literal> file which you unpack into a
- directory full of the source files as follows:
+ <literal>tar.gz</literal> or <literal>tar.bz2</literal> file
+ which you unpack into a directory full of the source files as follows:
</para>
<programlisting>
tar xvfz gtk+-2.0.0.tar.gz
+ tar xvfj gtk+-2.0.0.tar.bz2
</programlisting>
<para>
In the toplevel of the directory that is created, there will be
needed for that library along with version number information.)
The version of <command>pkg-config</command> needed to build
GTK+ is mirrored in the <filename>dependencies</filename> directory
- on the <ulink url="ftp://ftp.gtk.org/pub/gtk/v2.6/">GTK+ FTP
+ on the <ulink url="ftp://ftp.gtk.org/pub/gtk/">GTK+ FTP
site.</ulink>
</para>
</listitem>
The GLib library provides core non-graphical functionality
such as high level data types, Unicode manipulation, and
an object and type system to C programs. It is available
- from the <ulink url="ftp://ftp.gtk.org/pub/gtk/v2.6/">GTK+
+ from the <ulink url="ftp://ftp.gtk.org/pub/glib/">GTK+
FTP site.</ulink>
</para>
</listitem>
<para>
<ulink url="http://www.pango.org">Pango</ulink> is a library
for internationalized text handling. It is available from
- the <ulink url="ftp://ftp.gtk.org/pub/gtk/v2.6/">GTK+ FTP
+ the <ulink url="ftp://ftp.gtk.org/pub/pango/">GTK+ FTP
site.</ulink>.
</para>
</listitem>
interfaces allowing accessibility technologies such as
screen readers to interact with a graphical user interface.
It is available from the <ulink
- url="ftp://ftp.gtk.org/pub/gtk/v2.6/">GTK+ FTP site.</ulink>
+ url="ftp://ftp.gtk.org/pub/atk/">GTK+ FTP site.</ulink>
</para>
</listitem>
<listitem>
<para>
The <ulink url="http://www.fontconfig.org">fontconfig</ulink>
library provides Pango with a standard way of locating
- fonts and matching them against font names.
+ fonts and matching them against font names.
</para>
</listitem>
<listitem>
<para>
<ulink url="http://www.cairographics.org">Cairo</ulink>
- is a graphics library that supports vector graphics and image
+ is a graphics library that supports vector graphics and image
compositing. Both Pango and GTK+ use cairo for much of their
drawing.
</para>
</listitem>
+ <listitem>
+ <para>
+ <ulink url="http://live.gnome.org/GObjectIntrospection">gobject-introspection</ulink>
+ is a framework for making introspection data available to
+ language bindings.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The <ulink url="http://www.freedesktop.org/wiki/Software/shared-mime-info">shared-mime-info</ulink>
+ package is not a hard dependency of GTK+, but it contains definitions
+ for mime types that are used by GIO and, indirectly, by GTK+.
+ gdk-pixbuf will use GIO for mime type detection if possible. For this
+ to work, shared-mime-info needs to be installed and
+ <envar>XDG_DATA_DIRS</envar> set accordingly at configure time.
+ Otherwise, gdk-pixbuf falls back to its built-in mime type detection.
+ </para>
+ </listitem>
</itemizedlist>
</refsect1>
<refsect1 id="building">
<group>
<arg>--with-included-loaders==LOADER1,LOADER2,...</arg>
</group>
+ <group>
+ <arg>--with-included-immodules=MODULE1,MODULE2,...</arg>
+ </group>
<group>
<arg>--enable-debug=[no|minimum|yes]</arg>
</group>
<arg>--disable-xkb</arg>
<arg>--enable-xkb</arg>
</group>
+ <group>
+ <arg>--disable-xinerama</arg>
+ <arg>--enable-xinerama</arg>
+ </group>
<group>
<arg>--disable-gtk-doc</arg>
<arg>--enable-gtk-doc</arg>
</group>
+ <group>
+ <arg>--disable-cups</arg>
+ <arg>--enable-cups</arg>
+ </group>
<group>
<arg>--with-xinput=[no|yes]</arg>
</group>
<group>
- <arg>--with-gdktarget=[x11|linux-fb|win32]</arg>
- </group>
- <group>
- <arg>--disable-shadowfb</arg>
- <arg>--enable-shadowfb</arg>
+ <arg>--with-gdktarget=[x11|win32|quartz|directfb]</arg>
</group>
+ <group>
+ <arg>--disable-introspection</arg>
+ </group>
</cmdsynopsis>
</para>
</para>
</formalpara>
+ <formalpara>
+ <title><systemitem>--with-included-immodules</systemitem></title>
+
+ <para>
+ This option allows you to specify which input method modules you
+ want to include.
+ </para>
+ </formalpara>
+
<formalpara>
<title><systemitem>--enable-debug</systemitem></title>
</para>
</formalpara>
+ <formalpara>
+ <title><systemitem>--disable-xinerama</systemitem> and
+ <systemitem>--enable-xinerama</systemitem></title>
+
+ <para>
+ By default the <command>configure</command> script will try
+ to link against the Xinerama libraries if they are found.
+ These options can be used to explicitly control whether
+ Xinerama should be used.
+ </para>
+ </formalpara>
+
<formalpara>
<title><systemitem>--disable-gtk-doc</systemitem> and
<systemitem>--enable-gtk-doc</systemitem></title>
</para>
</formalpara>
+ <formalpara>
+ <title><systemitem>--disable-cups</systemitem> and
+ <systemitem>--enable-cups</systemitem></title>
+
+ <para>
+ By default the <command>configure</command> script will try
+ to build the cups print backend if the cups libraries are found.
+ These options can be used to explicitly control whether
+ the cups print backend should be built.
+ </para>
+ </formalpara>
+
<formalpara>
<title><systemitem>--with-xinput</systemitem></title>
<para>
<para>
Toggles between the supported backends for GDK.
The default is x11, unless the platform is Windows, in which
- case the default is win32.
+ case the default is win32. Other supported backends are
+ the quartz backend for OS X, and the DirectFB backend
+ for the Linux framebuffer.
</para>
</formalpara>
-
<formalpara>
- <title><systemitem>--disable-shadowfb</systemitem> and
- <systemitem>--enable-shadowfb</systemitem></title>
+ <title><systemitem>--disable-introspection</systemitem></title>
- <para>
- Toggles shadow framebuffer support for the linux-fb target,
- if selected.
- </para>
+ <para>
+ Build without introspection support.
+ </para>
</formalpara>
-
</refsect1>
</refentry>