source: general/genlib/glib2.xml@ 70b674f2

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 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 70b674f2 was 70b674f2, checked in by Bruce Dubbs <bdubbs@…>, 11 years ago

Update to glib-2.38.0

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