aboutsummaryrefslogtreecommitdiffstats
path: root/chapter06/glib.xml
blob: 25689e915eeff91145ef53c5cf6966c926978738 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
<?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 --sysconfdir=/etc --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>