source: general/genlib/glib2.xml@ f1fbb028

10.1 11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since f1fbb028 was f1fbb028, checked in by Bruce Dubbs <bdubbs@…>, 4 years ago

Update to glib-2.64.5.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23684 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 16.8 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/&glib2-minor;/glib-&glib2-version;.tar.xz">
8 <!ENTITY glib2-download-ftp "&gnome-download-ftp;/glib/&glib2-minor;/glib-&glib2-version;.tar.xz">
9 <!ENTITY glib2-md5sum "9bc5c8da9b31d19c10d91ea4b902c04b">
10 <!ENTITY glib2-size "4.6 MB">
11 <!ENTITY glib2-buildsize "170 MB (add 7 MB for tests)">
12 <!ENTITY glib2-time "0.3 SBU (add 0.5 SBU for tests; both using parallelism=4)">
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 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 &lfs10_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">Additional Downloads</bridgehead>
76 <itemizedlist spacing="compact">
77 <listitem>
78 <para>
79 Optional patch:
80 <ulink url="&patch-root;/glib-&glib2-version;-skip_warnings-1.patch"/>
81 </para>
82 </listitem>
83 </itemizedlist>
84
85 <bridgehead renderas="sect3">GLib Dependencies</bridgehead>
86
87 <bridgehead renderas="sect4">Recommended</bridgehead>
88 <para role="recommended">
89 <xref linkend="libxslt"/> and
90 <xref linkend="pcre"/> (built with Unicode properties)
91 </para>
92
93 <bridgehead renderas="sect4">Optional</bridgehead>
94 <para role="optional">
95 <xref linkend="dbus"/> and
96 <ulink url="https://bindfs.org/">bindfs</ulink>
97 (both may be used in some tests),
98 <xref linkend="gdb"/> (for bindings),
99 <xref linkend="DocBook"/>,
100 <xref linkend="docbook-xsl"/>,
101 <xref linkend="gtk-doc"/> (to build API documentation), and
102 <xref linkend="glib-networking"/> (for some tests, but this is a circular
103 dependency)
104 </para>
105
106 <bridgehead renderas="sect4">Additional Runtime Dependencies</bridgehead>
107 <para role="recommended">
108 <xref role="runtime" linkend="gobject-introspection"/>
109 (should be installed before gtk+, atk, etc.)
110 </para>
111 <para role="optional">
112 Quoted directly from the <filename>INSTALL</filename> file:
113 <quote>Some of the mimetype-related functionality in GIO requires the
114 <command>update-mime-database</command> and
115 <command>update-desktop-database</command> utilities</quote>,
116 which are part of
117 <xref role="runtime" linkend="shared-mime-info"/> and
118 <xref role="runtime" linkend="desktop-file-utils"/>, respectively.
119 These two utilities are also needed for some tests.
120 </para>
121
122 <para condition="html" role="usernotes">User Notes:
123 <ulink url="&blfs-wiki;/glib2"/>
124 </para>
125 </sect2>
126
127 <sect2 role="installation">
128 <title>Installation of GLib</title>
129
130 <para>
131 If desired, apply the optional patch. In many cases, applications that
132 use this library, either directly or indirectly via other libraries such
133 as <xref linkend="gtk3"/>, output numerous warnings when run from the
134 command line. This patch enables the use of an environment variable,
135 <envar>GLIB_LOG_LEVEL</envar>, that supresses unwanted messages. The
136 value of the variable is a digit that corresponds to:
137 </para>
138
139 <simplelist>
140 <member>1 Alert</member>
141 <member>2 Critical</member>
142 <member>3 Error</member>
143 <member>4 Warning</member>
144 <member>5 Notice</member>
145 </simplelist>
146
147 <para>
148 For instance <userinput>export GLIB_LOG_LEVEL=4</userinput> will skip
149 output of Warning and Notice messages (and Info/Debug messages if they
150 are turned on). If <envar>GLIB_LOG_LEVEL</envar> is not defined, normal
151 message output will not be affected.
152 </para>
153
154<screen><userinput>patch -Np1 -i ../glib-&glib2-version;-skip_warnings-1.patch</userinput></screen>
155
156 <warning>
157 <para>
158
159 If upgrading from a previous version of GLib that was built using
160 autotools, and the <application>libtool</application> archives (.la
161 files) were installed, you will need to adjust all installed libtool
162 archives,
163 <filename>/usr/lib/libg{io,lib,module,object,thread}-2.0.la</filename>,
164 to replace references to the libtool archives for this package with the
165 appropriate linker library flag (-l),
166 <command>-lg{io,lib,module,object,thread}</command>. 600+ files must be
167 modified on a complete gnome desktop.
168
169 </para>
170
171 <para>
172 Alternatively, you can just remove the unneeded .la files
173 with the script at <xref linkend="la-files"/>.
174 </para>
175 </warning>
176
177 <para>
178 Install <application>GLib</application> by running the following
179 commands:
180 </para>
181
182<screen><userinput>mkdir build &amp;&amp;
183cd build &amp;&amp;
184
185meson --prefix=/usr \
186 -Dman=true \
187 -Dselinux=disabled \
188 .. &amp;&amp;
189ninja</userinput></screen>
190
191 <note><para>
192 If <xref linkend="libxslt"/> is installed, the above command may
193 indicate several (about 33) errors that start with "Error: no ID for
194 constraint linkend:" when gnerating the man pages. These are harmless.
195 </para></note>
196
197 <para>
198 The <application>GLib</application> test suite requires
199 <application>desktop-file-utils</application> for some tests. However,
200 <application>desktop-file-utils</application> requires
201 <application>GLib</application> in order to compile; therefore, you must
202 first install <application>GLib</application> and then run the test
203 suite.
204 </para>
205
206 <para>
207 Now, as the <systemitem class="username">root</systemitem> user:
208 </para>
209
210<screen role="root"><userinput>ninja install &amp;&amp;
211
212mkdir -p /usr/share/doc/glib-&glib2-version; &amp;&amp;
213cp -r ../docs/reference/{NEWS,gio,glib,gobject} /usr/share/doc/glib-&glib2-version;</userinput></screen>
214
215 <para>
216 You should now install <xref linkend="desktop-file-utils"/> and
217 <xref linkend="shared-mime-info"/> and proceed to
218 run the test suite.
219 </para>
220
221 <para>
222 To test the results, after having installed the package, issue:
223 <command>ninja test</command>.
224 <!-- glib issue #1954: -->
225 <!-- One test named gdbus-server-auth sometimes fails.-->
226 <!-- SysV has the symlink now, so gdatetime no longer fails.-->
227 <!-- Needs /etc/localtime to be a symbolic link. In addition
228 the link must be to some place like /usr/share/zoneinfo/...
229
230 This can be overcome if the line below in glib/tests/gdatetime.c
231 is removed or commented out.
232 g_assert_true (*g_time_zone_get_identifier (tz) != '/');
233
234 NOTE: systemd implements this as a hard requirement. -->
235 <!-- with 2.60.4 on systemd, all tests pass. -->
236 <!-- with 2.64.1 on sysV, all tests pass. -->
237 </para>
238
239 </sect2>
240
241 <sect2 role="commands">
242 <title>Command Explanations</title>
243
244 <para>
245 <parameter>-Dman=true</parameter>: This switch causes the
246 build to create and install the package man pages.
247 </para>
248
249 <para>
250 <parameter>-Dselinux=disabled</parameter>: This switch disables
251 support for selinux which is not supported in BLFS.
252 </para>
253
254 <para>
255 <option>-Ddoc=true</option>: This switch causes the
256 build to create and install the API documentation.
257 </para>
258
259 </sect2>
260
261 <sect2 role="content">
262 <title>Contents</title>
263
264 <segmentedlist>
265 <segtitle>Installed Programs</segtitle>
266 <segtitle>Installed Libraries</segtitle>
267 <segtitle>Installed Directories</segtitle>
268
269 <seglistitem>
270 <seg>
271 gapplication, gdbus, gdbus-codegen,
272 gio, gio-querymodules,
273 glib-compile-resources, glib-compile-schemas,
274 glib-genmarshal, glib-gettextize,
275 glib-mkenums, gobject-query,
276 gresource, gsettings,
277 gtester, and gtester-report
278 </seg>
279 <seg>
280 libgio-2.0.so,
281 libglib-2.0.so,
282 libgmodule-2.0.so,
283 libgobject-2.0.so, and
284 libgthread-2.0.so
285 </seg>
286 <seg>
287 /usr/include/gio-unix-2.0,
288 /usr/include/glib-2.0,
289 /usr/lib/glib-2.0,
290 /usr/share/glib-2.0, and
291 /usr/share/gtk-doc/html/{gio,glib,gobject}
292 </seg>
293 </seglistitem>
294 </segmentedlist>
295
296 <variablelist>
297 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
298 <?dbfo list-presentation="list"?>
299 <?dbhtml list-presentation="table"?>
300
301 <varlistentry id="gapplication">
302 <term><command>gapplication</command></term>
303 <listitem>
304 <para>
305 can be used to start applications and to send
306 messages to already-running instances of other applications.
307 </para>
308 <indexterm zone="glib2 gapplication">
309 <primary sortas="b-gapplication">application</primary>
310 </indexterm>
311 </listitem>
312 </varlistentry>
313 <varlistentry id="gdbus">
314 <term><command>gdbus</command></term>
315 <listitem>
316 <para>
317 is a simple tool used for working with
318 <application>D-Bus</application> objects.
319 </para>
320 <indexterm zone="glib2 gdbus">
321 <primary sortas="b-gdbus">gdbus</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325
326 <varlistentry id="gdbus-codegen">
327 <term><command>gdbus-codegen</command></term>
328 <listitem>
329 <para>
330 is used to generate code and/or documentation for one or
331 more <application>D-Bus</application> interfaces.
332 </para>
333 <indexterm zone="glib2 gdbus-codegen">
334 <primary sortas="b-gdbus-codegen">gdbus-codegen</primary>
335 </indexterm>
336 </listitem>
337 </varlistentry>
338
339 <varlistentry id="gio">
340 <term><command>gio</command></term>
341 <listitem>
342 <para>
343 is a utility that makes many <application>GIO</application>
344 features available from the command line.
345 </para>
346 <indexterm zone="glib2 gio">
347 <primary sortas="b-gio">gio</primary>
348 </indexterm>
349 </listitem>
350 </varlistentry>
351
352 <varlistentry id="gio-querymodules">
353 <term><command>gio-querymodules</command></term>
354 <listitem>
355 <para>
356 is used to create a <filename>giomodule.cache</filename> file in
357 the listed directories. This file lists the implemented extension
358 points for each module that has been found.
359 </para>
360 <indexterm zone="glib2 gio-querymodules">
361 <primary sortas="b-gio-querymodules">gio-querymodules</primary>
362 </indexterm>
363 </listitem>
364 </varlistentry>
365
366 <varlistentry id="glib-compile-resources">
367 <term><command>glib-compile-resources</command></term>
368 <listitem>
369 <para>
370 is used to read the resource description from a file and
371 the files that it references to create a binary resource
372 bundle that is suitable for use with the GResource API.
373 </para>
374 <indexterm zone="glib2 glib-compile-resources">
375 <primary sortas="b-glib-compile-resources">glib-compile-resources</primary>
376 </indexterm>
377 </listitem>
378 </varlistentry>
379
380 <varlistentry id="glib-compile-schemas">
381 <term><command>glib-compile-schemas</command></term>
382 <listitem>
383 <para>
384 is used to compile all the GSettings XML schema files
385 in a directory into a binary file with the name
386 <filename>gschemas.compiled</filename> that can be used by GSettings.
387 </para>
388 <indexterm zone="glib2 glib-compile-schemas">
389 <primary sortas="b-glib-compile-resources">glib-compile-schemas</primary>
390 </indexterm>
391 </listitem>
392 </varlistentry>
393
394 <varlistentry id="glib-genmarshal">
395 <term><command>glib-genmarshal</command></term>
396 <listitem>
397 <para>
398 is a C code marshaller generation utility for GLib closures.
399 </para>
400 <indexterm zone="glib2 glib-genmarshal">
401 <primary sortas="b-glib-genmarshal">glib-genmarshal</primary>
402 </indexterm>
403 </listitem>
404 </varlistentry>
405
406 <varlistentry id="glib-gettextize">
407 <term><command>glib-gettextize</command></term>
408 <listitem>
409 <para>
410 is a variant of the <application>gettext</application>
411 internationalization utility.
412 </para>
413 <indexterm zone="glib2 glib-gettextize">
414 <primary sortas="b-glib-gettextize">glib-gettextize</primary>
415 </indexterm>
416 </listitem>
417 </varlistentry>
418
419 <varlistentry id="glib-mkenums">
420 <term><command>glib-mkenums</command></term>
421 <listitem>
422 <para>
423 is a C language enum description generation utility.
424 </para>
425 <indexterm zone="glib2 glib-mkenums">
426 <primary sortas="b-glib-mkenums">glib-mkenums</primary>
427 </indexterm>
428 </listitem>
429 </varlistentry>
430
431 <varlistentry id="gobject-query">
432 <term><command>gobject-query</command></term>
433 <listitem>
434 <para>
435 is a small utility that draws a tree of types.
436 </para>
437 <indexterm zone="glib2 gobject-query">
438 <primary sortas="b-gobject-query">gobject-query</primary>
439 </indexterm>
440 </listitem>
441 </varlistentry>
442
443 <varlistentry id="gresource">
444 <term><command>gresource</command></term>
445 <listitem>
446 <para>
447 offers a simple command line interface to GResource.
448 </para>
449 <indexterm zone="glib2 gresource">
450 <primary sortas="b-gresource">gresource</primary>
451 </indexterm>
452 </listitem>
453 </varlistentry>
454
455 <varlistentry id="gsettings">
456 <term><command>gsettings</command></term>
457 <listitem>
458 <para>
459 offers a simple command line interface to GSettings.
460 </para>
461 <indexterm zone="glib2 gsettings">
462 <primary sortas="b-gsettings">gsettings</primary>
463 </indexterm>
464 </listitem>
465 </varlistentry>
466
467 <varlistentry id="gtester">
468 <term><command>gtester</command></term>
469 <listitem>
470 <para>
471 is a test running utility.
472 </para>
473 <indexterm zone="glib2 gtester">
474 <primary sortas="b-gtester">gtester</primary>
475 </indexterm>
476 </listitem>
477 </varlistentry>
478
479 <varlistentry id="gtester-report">
480 <term><command>gtester-report</command></term>
481 <listitem>
482 <para>
483 is a test report formatting utility.
484 </para>
485 <indexterm zone="glib2 gtester-report">
486 <primary sortas="b-gtester-report">gtester-report</primary>
487 </indexterm>
488 </listitem>
489 </varlistentry>
490
491 <varlistentry id="GLib-libraries">
492 <term>GLib libraries</term>
493 <listitem>
494 <para>
495 contain low-level core libraries for the
496 <application>GIMP</application> Toolkit.
497 </para>
498 <indexterm zone="glib2 GLib-libraries">
499 <primary sortas="c-GLib-libraries">Glib libraries</primary>
500 </indexterm>
501 </listitem>
502 </varlistentry>
503
504 </variablelist>
505
506 </sect2>
507
508</sect1>
Note: See TracBrowser for help on using the repository browser.