aboutsummaryrefslogtreecommitdiffstats
path: root/chapter06/glib.xml
diff options
context:
space:
mode:
Diffstat (limited to 'chapter06/glib.xml')
-rw-r--r--chapter06/glib.xml172
1 files changed, 172 insertions, 0 deletions
diff --git a/chapter06/glib.xml b/chapter06/glib.xml
new file mode 100644
index 000000000..ee5297676
--- /dev/null
+++ b/chapter06/glib.xml
@@ -0,0 +1,172 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+ <!ENTITY % general-entities SYSTEM "../general.ent">
+ %general-entities;
+]>
+
+<sect1 id="ch-system-glib" role="wrap">
+ <?dbhtml filename="glib.html"?>
+
+ <sect1info condition="script">
+ <productname>glib</productname>
+ <productnumber>&glib-version;</productnumber>
+ <address>&glib-url;</address>
+ </sect1info>
+
+ <title>Glib-&glib-version;</title>
+
+ <indexterm zone="ch-system-glib">
+ <primary sortas="a-Glib">Glib</primary>
+ </indexterm>
+
+ <sect2 role="package">
+ <title/>
+
+ <para>The GLib package contains a low-level core library. This is useful
+ for providing data structure handling for C, portability wrappers and
+ interfaces for such runtime functionality as an event loop, threads,
+ dynamic loading, and an object system.</para>
+
+ <segmentedlist>
+ <segtitle>&buildtime;</segtitle>
+ <segtitle>&diskspace;</segtitle>
+
+ <seglistitem>
+ <seg>&glib-ch6-sbu;</seg>
+ <seg>&glib-ch6-du;</seg>
+ </seglistitem>
+ </segmentedlist>
+
+ </sect2>
+
+ <sect2 role="installation">
+ <title>Installation of Glib</title>
+
+ <para>Prepare Glib for compilation:</para>
+
+<screen><userinput remap="configure">PCRE_LIBS="-L/usr/lib -lpcre" PCRE_CFLAGS="-I/usr/include" ./configure --prefix=/usr --with-pcre=system</userinput></screen>
+
+ <variablelist>
+ <title>The meaning of the configure options:</title>
+
+ <varlistentry>
+ <term><parameter>--with-pcre=system</parameter></term>
+ <listitem>
+ <para>This parameter causes the build to use a system-provided
+ version of the PCRE library instead of an internal version.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
+ <para>Compile the package:</para>
+
+<screen><userinput remap="make">make</userinput></screen>
+
+ <para>Due to dependencies on additional Perl modules and other packages not yet present
+ (e.g. desktop-file-utils and DBus), it is not possible to run Glib's test suite.</para>
+
+ <para>Install the package:</para>
+
+<screen><userinput remap="install">make install</userinput></screen>
+
+ </sect2>
+
+ <sect2 id="contents-glib" role="content">
+ <title>Contents of Glib</title>
+
+ <segmentedlist>
+ <segtitle>Installed programs</segtitle>
+ <segtitle>Installed libraries</segtitle>
+ <segtitle>Installed directories</segtitle>
+
+ <seglistitem>
+ <seg>gio-querymodules, glib-genmarshal, glib-gettextize,
+ glib-mkenums, gobject-query, gtester and gtester-report</seg>
+ <seg>libgio-2.0.so, libglib-2.0.so, libgmodule-2.0.so,
+ libgobject-2.0.so, and libgthread-2.0.so</seg>
+ <seg>/usr/include/{gio-unix-2.0/gio,glib-2.0/{gio,glib,gobject}},
+ /usr/lib/{gio/modules,glib-2.0/include},
+ /usr/share/{gdb/auto-load,glib-2.0/{gdb, gettext/po},gtk-doc/html/{gio,glib,gobject}}</seg>
+ </seglistitem>
+ </segmentedlist>
+
+ <variablelist>
+ <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+ <?dbfo list-presentation="list"?>
+ <?dbhtml list-presentation="table"?>
+
+ <varlistentry id="gio-querymodules">
+ <term><command>gio-querymodules</command></term>
+ <listitem>
+ <para>is a C code marshaller generation utility for GLib
+ closures.</para>
+ <indexterm zone="ch-system-glib gio-querymodules">
+ <primary sortas="b-glib">gio-querymodules</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="glib-gettextize">
+ <term><command>glib-gettextize</command></term>
+ <listitem>
+ <para>is a variant of the gettext internationalization
+ utility.</para>
+ <indexterm zone="ch-system-glib glib-gettextize">
+ <primary sortas="b-glib-gettextize">glib-gettextize</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="glib-mkenums">
+ <term><command>glib-mkenums</command></term>
+ <listitem>
+ <para>is a C language enum description generation utility.</para>
+ <indexterm zone="ch-system-glib glib-mkenums">
+ <primary sortas="b-glib-mkenums">glib-mkenums</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="gobject-query">
+ <term><command>gobject-query</command></term>
+ <listitem>
+ <para>Is a small utility that draws a tree of types.</para>
+ <indexterm zone="ch-system-glib gobject-query">
+ <primary sortas="b-gobject-query">gobject-query</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="gtester">
+ <term><command>gtester</command></term>
+ <listitem>
+ <para>Is a test running utility.</para>
+ <indexterm zone="ch-system-glib gtester">
+ <primary sortas="b-gtester">gtester</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="gtester-report">
+ <term><command>gtester-report</command></term>
+ <listitem>
+ <para>Is a test report formatting utility.</para>
+ <indexterm zone="ch-system-glib gtester-report">
+ <primary sortas="b-gtester-report">gtester-report</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="glib">
+ <term><filename class="libraryfile">Glib libraries</filename></term>
+ <listitem>
+ <para>contain a general purpose low-level core library.</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </sect2>
+
+</sect1>