source: general/genlib/glib2.xml@ b84342d6

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since b84342d6 was b84342d6, checked in by Krejzi <krejzi@…>, 12 years ago

accountsservice 0.6.20, anjuta 3.4.1, glib 2.32.2, gtk+ 3.4.2, polkit 0.105, polkit-gnome 0.105, udisks 1.96.0, upower 0.9.16

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10112 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 14.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY glib2-download-http "&gnome-download-http;/glib/2.32/glib-&glib2-version;.tar.xz">
8 <!ENTITY glib2-download-ftp "&gnome-download-ftp;/glib/2.32/glib-&glib2-version;.tar.xz">
9 <!ENTITY glib2-md5sum "5bfdb6197afb90e4dbc7b1bb98f0eae0">
10 <!ENTITY glib2-size "5.9 MB">
11 <!ENTITY glib2-buildsize "180 MB">
12 <!ENTITY glib2-time "1.2 SBU (additional 4.0 SBU to run the test suite)">
13]>
14
15<sect1 id="glib2" xreflabel="GLib-&glib2-version;">
16 <?dbhtml filename="glib2.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>GLib-&glib2-version;</title>
24
25 <indexterm zone="glib2">
26 <primary sortas="a-GLib2">GLib2</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to GLib</title>
31
32 <para>
33 The <application>GLib</application> package contains a low-level
34 libraries useful for providing data structure handling for C, portability
35 wrappers and interfaces for such runtime functionality as an
36 event loop, threads, dynamic loading and an object system.
37 </para>
38
39 &lfs71_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&glib2-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&glib2-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &glib2-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &glib2-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &glib2-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &glib2-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">GLib Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Required</bridgehead>
78 <para role="required">
79 <xref linkend="libffi"/> and
80 <xref linkend="python2"/>
81 </para>
82
83 <bridgehead renderas="sect4">Recommended</bridgehead>
84 <para role="recommended">
85 <xref linkend="pcre"/> (built with unicode properties)
86 </para>
87
88 <bridgehead renderas="sect4">Optional</bridgehead>
89 <para role="optional">
90 <xref linkend="attr"/>,
91 <xref linkend="dbus"/> (required to run the tests),
92 <xref linkend="gamin"/> and
93 <xref linkend="gtk-doc"/>
94 </para>
95
96 <para>
97 <application>Gamin</application> requires
98 <application>GLib</application> in order to compile; therefore,
99 you must first install <application>GLib</application>,
100 then compile <application>Gamin</application>, and recompile
101 <application>GLib</application> against it.
102 </para>
103
104 <bridgehead renderas="sect4">Additional Runtime Dependencies</bridgehead>
105 <para role="optional">
106 Quoted directly from the <filename>INSTALL</filename> file;
107 <quote>Some of the mimetype-related functionality in GIO requires the
108 <command>update-mime-database</command> and
109 <command>update-desktop-database</command> utilities</quote>,
110 which are part of
111 <xref linkend="shared-mime-info"/> and
112 <xref linkend="desktop-file-utils"/>, respectively.
113 </para>
114
115 <para condition="html" role="usernotes">User Notes:
116 <ulink url="&blfs-wiki;/glib2"/></para>
117
118 </sect2>
119
120 <sect2 role="installation">
121 <title>Installation of GLib</title>
122
123 <para>
124 Install <application>GLib</application> by running the following
125 commands:
126 </para>
127
128<screen><userinput>PCRE_LIBS=-lpcre PCRE_CFLAGS=" " \
129LIBFFI_LIBS=-lffi LIBFFI_CFLAGS=" " \
130./configure --prefix=/usr --sysconfdir=/etc --with-pcre=system &amp;&amp;
131make</userinput></screen>
132
133 <para>
134 The <application>GLib</application> test suite requires
135 <application>desktop-file-utils</application> in order to run. However,
136 <application>desktop-file-utils</application> requires
137 <application>GLib</application> in order to compile; therefore, you must
138 first install <application>GLib</application> and then run the test
139 suite.
140 </para>
141
142 <para>
143 Now, as the <systemitem class="username">root</systemitem> user:
144 </para>
145
146<screen role="root"><userinput>make install &amp;&amp;
147ln -v -sfn ../../lib/glib-2.0/include/glibconfig.h /usr/include/glib-2.0/glibconfig.h</userinput></screen>
148
149 <para>
150 You should now install <xref linkend="desktop-file-utils"/> and proceed to
151 run the test suite.
152 </para>
153
154 <para>
155 To test the results, issue: <command>make check</command>.
156 </para>
157
158 </sect2>
159
160 <sect2 role="commands">
161 <title>Command Explanations</title>
162
163 <para>
164 PCRE_* and LIBFFI_*: <application>Glib</application> is a prerequsite
165 for <application>pkg-config</application>, but it wants to use
166 <application>pkg-config</application> during the build process.
167 These environment variables work around not having
168 <application>pkg-config</application> available.
169 </para>
170
171 <para>
172 <command>ln -v -sfn ... glibconfig.h</command>: Place a link to an
173 architecture dependent header file where programs can find it.
174 </para>
175
176 <para>
177 <parameter>--with-pcre=system</parameter>: This parameter causes the
178 build to use a system-provided version of the
179 <application>PCRE</application> library instead of an internal
180 version.
181 </para>
182
183 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
184 href="../../xincludes/gtk-doc-rebuild.xml"/>
185
186 </sect2>
187
188<!-- This has never caused any problems for me. A doc hint could help me
189 understand why this was here in first place.
190
191 <sect2 role="configuration">
192 <title>Configuring GLib</title>
193
194 <sect3>
195 <title>Configuration Information</title>
196
197 <para>
198 By default, <application>GLib</application> assumes that all
199 filenames are in the UTF-8 charset. See the <xref
200 linkend="locale-wrong-filename-encoding"/> section of the <xref
201 linkend="locale-issues"/> page for more details on this kind of issue. In
202 order to tell <application>GLib</application> and applications that use
203 it that filenames are in the default locale encoding, set the variable
204 <envar>G_FILENAME_ENCODING</envar> to the value "@locale". As the
205 <systemitem class="username">root</systemitem> user:
206 </para>
207
208<screen role="root"><userinput>cat &gt; /etc/profile.d/glib2-locale.sh &lt;&lt; "EOF"
209<literal># Use the current locale charset for filenames
210# in applications using GLib
211export G_FILENAME_ENCODING=@locale</literal>
212EOF</userinput></screen>
213
214 </sect3>
215
216 </sect2>
217-->
218
219 <sect2 role="content">
220 <title>Contents</title>
221
222 <segmentedlist>
223 <segtitle>Installed Programs</segtitle>
224 <segtitle>Installed Libraries</segtitle>
225 <segtitle>Installed Directories</segtitle>
226
227 <seglistitem>
228 <seg>
229 gdbus, gdbus-codegen, gio-querymodules,
230 glib-compile-resources, glib-compile-schemas,
231 glib-genmarshal, glib-gettextize, glib-mkenums,
232 gobject-query, gresource, gsettings, gtester
233 and gtester-report
234 </seg>
235 <seg>
236 libgio-2.0.so, libglib-2.0.so, libgmodule-2.0.so,
237 libgobject-2.0.so, libgthread-2.0.so and libgiofam.so
238 </seg>
239 <seg>
240 /usr/include/{gio-unix-2.0,glib-2.0},
241 /usr/lib/{gdbus-2.0,gio,glib-2.0},
242 /usr/share/glib-2.0 and
243 /usr/share/gtk-doc/html/{gio,glib,gobject}
244 </seg>
245 </seglistitem>
246 </segmentedlist>
247
248 <variablelist>
249 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
250 <?dbfo list-presentation="list"?>
251 <?dbhtml list-presentation="table"?>
252
253 <varlistentry id="gdbus">
254 <term><command>gdbus</command></term>
255 <listitem>
256 <para>
257 is a simple tool for working with D-Bus objects.
258 </para>
259 <indexterm zone="glib2 gdbus">
260 <primary sortas="b-gdbus">gdbus</primary>
261 </indexterm>
262 </listitem>
263 </varlistentry>
264
265 <varlistentry id="gdbus-codegen">
266 <term><command>gdbus-codegen</command></term>
267 <listitem>
268 <para>
269 is used to generate code and/or documentation for one or
270 more <application>D-Bus</application> interfaces.
271 </para>
272 <indexterm zone="glib2 gdbus-codegen">
273 <primary sortas="b-gdbus-codegen">gdbus-codegen</primary>
274 </indexterm>
275 </listitem>
276 </varlistentry>
277
278 <varlistentry id="gio-querymodules">
279 <term><command>gio-querymodules</command></term>
280 <listitem>
281 <para>
282 is used to create a giomodule.cache file in the listed directories.
283 This file lists the implemented extension points for each module that has
284 been found.
285 </para>
286 <indexterm zone="glib2 gio-querymodules">
287 <primary sortas="b-gio-querymodules">gio-querymodules</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 <varlistentry id="glib-compile-resources">
293 <term><command>glib-compile-resources</command></term>
294 <listitem>
295 <para>
296 is used to read the resource description from file and
297 the files that it references to create a binary resource
298 bundle that is suitable for use with the GResource API.
299 </para>
300 <indexterm zone="glib2 glib-compile-resources">
301 <primary sortas="b-glib-compile-resources">glib-compile-resources</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="glib-compile-schemas">
307 <term><command>glib-compile-schemas</command></term>
308 <listitem>
309 <para>
310 is used to compile all the GSettings XML schema files
311 in directory into a binary file with the name gschemas.compiled
312 that can be used by GSettings.
313 </para>
314 <indexterm zone="glib2 glib-compile-schemas">
315 <primary sortas="b-glib-compile-resources">glib-compile-schemas</primary>
316 </indexterm>
317 </listitem>
318 </varlistentry>
319
320 <varlistentry id="glib-genmarshal">
321 <term><command>glib-genmarshal</command></term>
322 <listitem>
323 <para>
324 is a C code marshaller generation utility for GLib closures.
325 </para>
326 <indexterm zone="glib2 glib-genmarshal">
327 <primary sortas="b-glib-genmarshal">glib-genmarshal</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 <varlistentry id="glib-gettextize">
333 <term><command>glib-gettextize</command></term>
334 <listitem>
335 <para>
336 is a variant of the <application>gettext</application>
337 internationalization utility.
338 </para>
339 <indexterm zone="glib2 glib-gettextize">
340 <primary sortas="b-glib-gettextize">glib-gettextize</primary>
341 </indexterm>
342 </listitem>
343 </varlistentry>
344
345 <varlistentry id="glib-mkenums">
346 <term><command>glib-mkenums</command></term>
347 <listitem>
348 <para>
349 is a C language enum description generation utility.
350 </para>
351 <indexterm zone="glib2 glib-mkenums">
352 <primary sortas="b-glib-mkenums">glib-mkenums</primary>
353 </indexterm>
354 </listitem>
355 </varlistentry>
356
357 <varlistentry id="gobject-query">
358 <term><command>gobject-query</command></term>
359 <listitem>
360 <para>
361 is a small utility that draws a tree of types.
362 </para>
363 <indexterm zone="glib2 gobject-query">
364 <primary sortas="b-gobject-query">gobject-query</primary>
365 </indexterm>
366 </listitem>
367 </varlistentry>
368
369 <varlistentry id="gresource">
370 <term><command>gresource</command></term>
371 <listitem>
372 <para>
373 offers a simple commandline interface to GResource.
374 </para>
375 <indexterm zone="glib2 gresource">
376 <primary sortas="b-gresource">gresource</primary>
377 </indexterm>
378 </listitem>
379 </varlistentry>
380
381 <varlistentry id="gsettings">
382 <term><command>gsettings</command></term>
383 <listitem>
384 <para>
385 offers a simple commandline interface to GSettings.
386 </para>
387 <indexterm zone="glib2 gsettings">
388 <primary sortas="b-gsettings">gsettings</primary>
389 </indexterm>
390 </listitem>
391 </varlistentry>
392
393 <varlistentry id="gtester">
394 <term><command>gtester</command></term>
395 <listitem>
396 <para>
397 is a test running utility.
398 </para>
399 <indexterm zone="glib2 gtester">
400 <primary sortas="b-gtester">gtester</primary>
401 </indexterm>
402 </listitem>
403 </varlistentry>
404
405 <varlistentry id="gtester-report">
406 <term><command>gtester-report</command></term>
407 <listitem>
408 <para>
409 is a test report formatting utility.
410 </para>
411 <indexterm zone="glib2 gtester-report">
412 <primary sortas="b-gtester-report">gtester-report</primary>
413 </indexterm>
414 </listitem>
415 </varlistentry>
416
417 <varlistentry id="GLib-libraries">
418 <term>GLib libraries</term>
419 <listitem>
420 <para>
421 contain a low-level core libraries for the
422 <application>GIMP</application> Toolkit.
423 </para>
424 <indexterm zone="glib2 GLib-libraries">
425 <primary sortas="c-GLib-libraries">Glib libraries</primary>
426 </indexterm>
427 </listitem>
428 </varlistentry>
429
430 </variablelist>
431
432 </sect2>
433
434</sect1>
Note: See TracBrowser for help on using the repository browser.