source: general/genlib/glib2.xml@ 8aeb474

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 8aeb474 was 43a4e608, checked in by Ken Moffat <ken@…>, 12 years ago

more tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10570 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 12.3 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 "bf84fefd9c1a5b5a7a38736f4ddd674a">
10 <!ENTITY glib2-size "5.9 MB">
11 <!ENTITY glib2-buildsize "180 MB">
12 <!ENTITY glib2-time "1.5 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 &lfs72_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"/>,
80 <xref linkend="pkgconfig"/> and
81 <xref linkend="python2"/>
82 </para>
83
84 <bridgehead renderas="sect4">Recommended</bridgehead>
85 <para role="recommended">
86 <xref linkend="pcre"/> (built with unicode properties)
87 </para>
88
89 <bridgehead renderas="sect4">Optional</bridgehead>
90 <para role="optional">
91 <xref linkend="attr"/>,
92 <xref linkend="dbus"/> (required to run the tests),
93 <xref linkend="gamin"/> and
94 <xref linkend="gtk-doc"/>
95 </para>
96
97 <para>
98 <application>Gamin</application> requires
99 <application>GLib</application> in order to compile; therefore,
100 you must first install <application>GLib</application>,
101 then compile <application>Gamin</application>, and recompile
102 <application>GLib</application> against it.
103 </para>
104
105 <bridgehead renderas="sect4">Additional Runtime Dependencies</bridgehead>
106 <para role="optional">
107 Quoted directly from the <filename>INSTALL</filename> file;
108 <quote>Some of the mimetype-related functionality in GIO requires the
109 <command>update-mime-database</command> and
110 <command>update-desktop-database</command> utilities</quote>,
111 which are part of
112 <xref linkend="shared-mime-info"/> and
113 <xref linkend="desktop-file-utils"/>, respectively.
114 </para>
115
116 <para condition="html" role="usernotes">User Notes:
117 <ulink url="&blfs-wiki;/glib2"/>
118 </para>
119 </sect2>
120
121 <sect2 role="installation">
122 <title>Installation of GLib</title>
123
124 <para>
125 Install <application>GLib</application> by running the following
126 commands:
127 </para>
128
129<screen><userinput>./configure --prefix=/usr \
130 --sysconfdir=/etc \
131 --with-pcre=system &amp;&amp;
132make</userinput></screen>
133
134 <para>
135 The <application>GLib</application> test suite requires
136 <application>desktop-file-utils</application> in order to run. However,
137 <application>desktop-file-utils</application> requires
138 <application>GLib</application> in order to compile; therefore, you must
139 first install <application>GLib</application> and then run the test
140 suite.
141 </para>
142
143 <para>
144 Now, as the <systemitem class="username">root</systemitem> user:
145 </para>
146
147<screen role="root"><userinput>make install</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 <parameter>--with-pcre=system</parameter>: This parameter causes the
165 build to use a system-provided version of the
166 <application>PCRE</application> library instead of an internal
167 version.
168 </para>
169
170 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
171 href="../../xincludes/gtk-doc-rebuild.xml"/>
172
173 </sect2>
174
175 <sect2 role="content">
176 <title>Contents</title>
177
178 <segmentedlist>
179 <segtitle>Installed Programs</segtitle>
180 <segtitle>Installed Libraries</segtitle>
181 <segtitle>Installed Directories</segtitle>
182
183 <seglistitem>
184 <seg>
185 gdbus, gdbus-codegen, gio-querymodules,
186 glib-compile-resources, glib-compile-schemas,
187 glib-genmarshal, glib-gettextize, glib-mkenums,
188 gobject-query, gresource, gsettings, gtester
189 and gtester-report
190 </seg>
191 <seg>
192 libgio-2.0.so, libglib-2.0.so, libgmodule-2.0.so,
193 libgobject-2.0.so, libgthread-2.0.so and libgiofam.so
194 </seg>
195 <seg>
196 /usr/include/{gio-unix-2.0,glib-2.0},
197 /usr/lib/{gdbus-2.0,gio,glib-2.0},
198 /usr/share/glib-2.0 and
199 /usr/share/gtk-doc/html/{gio,glib,gobject}
200 </seg>
201 </seglistitem>
202 </segmentedlist>
203
204 <variablelist>
205 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
206 <?dbfo list-presentation="list"?>
207 <?dbhtml list-presentation="table"?>
208
209 <varlistentry id="gdbus">
210 <term><command>gdbus</command></term>
211 <listitem>
212 <para>
213 is a simple used tool for working with D-Bus objects.
214 </para>
215 <indexterm zone="glib2 gdbus">
216 <primary sortas="b-gdbus">gdbus</primary>
217 </indexterm>
218 </listitem>
219 </varlistentry>
220
221 <varlistentry id="gdbus-codegen">
222 <term><command>gdbus-codegen</command></term>
223 <listitem>
224 <para>
225 is used to generate code and/or documentation for one or
226 more <application>D-Bus</application> interfaces.
227 </para>
228 <indexterm zone="glib2 gdbus-codegen">
229 <primary sortas="b-gdbus-codegen">gdbus-codegen</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="gio-querymodules">
235 <term><command>gio-querymodules</command></term>
236 <listitem>
237 <para>
238 is used to create a giomodule.cache file in the listed directories.
239 This file lists the implemented extension points for each module that has
240 been found.
241 </para>
242 <indexterm zone="glib2 gio-querymodules">
243 <primary sortas="b-gio-querymodules">gio-querymodules</primary>
244 </indexterm>
245 </listitem>
246 </varlistentry>
247
248 <varlistentry id="glib-compile-resources">
249 <term><command>glib-compile-resources</command></term>
250 <listitem>
251 <para>
252 is used to read the resource description from file and
253 the files that it references to create a binary resource
254 bundle that is suitable for use with the GResource API.
255 </para>
256 <indexterm zone="glib2 glib-compile-resources">
257 <primary sortas="b-glib-compile-resources">glib-compile-resources</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="glib-compile-schemas">
263 <term><command>glib-compile-schemas</command></term>
264 <listitem>
265 <para>
266 is used to compile all the GSettings XML schema files
267 in directory into a binary file with the name gschemas.compiled
268 that can be used by GSettings.
269 </para>
270 <indexterm zone="glib2 glib-compile-schemas">
271 <primary sortas="b-glib-compile-resources">glib-compile-schemas</primary>
272 </indexterm>
273 </listitem>
274 </varlistentry>
275
276 <varlistentry id="glib-genmarshal">
277 <term><command>glib-genmarshal</command></term>
278 <listitem>
279 <para>
280 is a C code marshaller generation utility for GLib closures.
281 </para>
282 <indexterm zone="glib2 glib-genmarshal">
283 <primary sortas="b-glib-genmarshal">glib-genmarshal</primary>
284 </indexterm>
285 </listitem>
286 </varlistentry>
287
288 <varlistentry id="glib-gettextize">
289 <term><command>glib-gettextize</command></term>
290 <listitem>
291 <para>
292 is a variant of the <application>gettext</application>
293 internationalization utility.
294 </para>
295 <indexterm zone="glib2 glib-gettextize">
296 <primary sortas="b-glib-gettextize">glib-gettextize</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="glib-mkenums">
302 <term><command>glib-mkenums</command></term>
303 <listitem>
304 <para>
305 is a C language enum description generation utility.
306 </para>
307 <indexterm zone="glib2 glib-mkenums">
308 <primary sortas="b-glib-mkenums">glib-mkenums</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 <varlistentry id="gobject-query">
314 <term><command>gobject-query</command></term>
315 <listitem>
316 <para>
317 is a small utility that draws a tree of types.
318 </para>
319 <indexterm zone="glib2 gobject-query">
320 <primary sortas="b-gobject-query">gobject-query</primary>
321 </indexterm>
322 </listitem>
323 </varlistentry>
324
325 <varlistentry id="gresource">
326 <term><command>gresource</command></term>
327 <listitem>
328 <para>
329 offers a simple commandline interface to GResource.
330 </para>
331 <indexterm zone="glib2 gresource">
332 <primary sortas="b-gresource">gresource</primary>
333 </indexterm>
334 </listitem>
335 </varlistentry>
336
337 <varlistentry id="gsettings">
338 <term><command>gsettings</command></term>
339 <listitem>
340 <para>
341 offers a simple commandline interface to GSettings.
342 </para>
343 <indexterm zone="glib2 gsettings">
344 <primary sortas="b-gsettings">gsettings</primary>
345 </indexterm>
346 </listitem>
347 </varlistentry>
348
349 <varlistentry id="gtester">
350 <term><command>gtester</command></term>
351 <listitem>
352 <para>
353 is a test running utility.
354 </para>
355 <indexterm zone="glib2 gtester">
356 <primary sortas="b-gtester">gtester</primary>
357 </indexterm>
358 </listitem>
359 </varlistentry>
360
361 <varlistentry id="gtester-report">
362 <term><command>gtester-report</command></term>
363 <listitem>
364 <para>
365 is a test report formatting utility.
366 </para>
367 <indexterm zone="glib2 gtester-report">
368 <primary sortas="b-gtester-report">gtester-report</primary>
369 </indexterm>
370 </listitem>
371 </varlistentry>
372
373 <varlistentry id="GLib-libraries">
374 <term>GLib libraries</term>
375 <listitem>
376 <para>
377 contain a low-level core libraries for the
378 <application>GIMP</application> Toolkit.
379 </para>
380 <indexterm zone="glib2 GLib-libraries">
381 <primary sortas="c-GLib-libraries">Glib libraries</primary>
382 </indexterm>
383 </listitem>
384 </varlistentry>
385
386 </variablelist>
387
388 </sect2>
389
390</sect1>
Note: See TracBrowser for help on using the repository browser.