source: general/genlib/glib2.xml@ f2d585bd

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f2d585bd was f2d585bd, checked in by Douglas R. Reno <renodr@…>, 8 months ago

Update to glib-2.66.7
Update to WebKitGTK+-2.30.5
Update to asciidoc-9.1.0
Update to xterm-366 (Security Update)
Fix a crash in bluez when using A2DP-based bluetooth devices
Belatedly mark Jinja2 as a security update

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

  • Property mode set to 100644
File size: 16.7 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 "20d515238d2d22f1ec2057828fb59d52">
10 <!ENTITY glib2-size "4.6 MB">
11 <!ENTITY glib2-buildsize "206 MB (add 1 MB for tests)">
12 <!ENTITY glib2-time "0.5 SBU (add 1.0 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 If a previous version of glib is installed, move the headers out of the
159 way so that later packages do not encounter conflicts:
160 </para>
161
162<screen><userinput remap="pre">[ -e /usr/include/glib-2.0 ] &amp;&amp; mv -vf /usr/include/glib-2.0{,.old}</userinput></screen>
163
164 </warning>
165
166 <para>
167 Install <application>GLib</application> by running the following
168 commands:
169 </para>
170
171<screen><userinput>mkdir build &amp;&amp;
172cd build &amp;&amp;
173
174meson --prefix=/usr \
175 -Dman=true \
176 -Dselinux=disabled \
177 .. &amp;&amp;
178ninja</userinput></screen>
179
180 <note><para>
181 If <xref linkend="libxslt"/> is installed, the above command may
182 indicate several (about 33) errors that start with "Error: no ID for
183 constraint linkend:" when generating the man pages. These are harmless.
184 </para></note>
185
186 <para>
187 The <application>GLib</application> test suite requires
188 <application>desktop-file-utils</application> for some tests. However,
189 <application>desktop-file-utils</application> requires
190 <application>GLib</application> in order to compile; therefore, you must
191 first install <application>GLib</application> and then run the test
192 suite.
193 </para>
194
195 <para>
196 Now, as the <systemitem class="username">root</systemitem> user:
197 </para>
198
199<screen role="root"><userinput>ninja install &amp;&amp;
200
201mkdir -p /usr/share/doc/glib-&glib2-version; &amp;&amp;
202cp -r ../docs/reference/{NEWS,gio,glib,gobject} /usr/share/doc/glib-&glib2-version;</userinput></screen>
203
204 <para>
205 You should now install <xref linkend="desktop-file-utils"/> and
206 <xref linkend="shared-mime-info"/> and proceed to
207 run the test suite.
208 </para>
209
210 <para>
211 To test the results, after having installed the package, issue:
212 <command>ninja test</command>.
213 <!-- glib issue #1954: -->
214 <!-- One test named gdbus-server-auth sometimes fails.-->
215 <!-- SysV has the symlink now, so gdatetime no longer fails.-->
216 <!-- Needs /etc/localtime to be a symbolic link. In addition
217 the link must be to some place like /usr/share/zoneinfo/...
218
219 This can be overcome if the line below in glib/tests/gdatetime.c
220 is removed or commented out.
221 g_assert_true (*g_time_zone_get_identifier (tz) != '/');
222
223 NOTE: systemd implements this as a hard requirement. -->
224 <!-- with 2.60.4 on systemd, all tests pass. -->
225 <!-- with 2.64.1 on sysV, all tests pass. -->
226 </para>
227
228 <para>
229 Finally, if this is a reinstall from glib2-2.64.x or earlier, remove
230 (as the <systemitem class="username">root</systemitem> user) an
231 obsolete header file that interferes with some packages:
232 </para>
233
234<screen role="root rebuild"><userinput>rm -f /usr/include/glib-2.0/glib/gurifuncs.h</userinput></screen>
235
236 </sect2>
237
238 <sect2 role="commands">
239 <title>Command Explanations</title>
240
241 <para>
242 <parameter>-Dman=true</parameter>: This switch causes the
243 build to create and install the package man pages.
244 </para>
245
246 <para>
247 <parameter>-Dselinux=disabled</parameter>: This switch disables
248 support for selinux which is not supported in BLFS.
249 </para>
250
251 <para>
252 <option>-Dgtk_doc=true</option>: This switch causes the
253 build to create and install the API documentation.
254 </para>
255
256 </sect2>
257
258 <sect2 role="content">
259 <title>Contents</title>
260
261 <segmentedlist>
262 <segtitle>Installed Programs</segtitle>
263 <segtitle>Installed Libraries</segtitle>
264 <segtitle>Installed Directories</segtitle>
265
266 <seglistitem>
267 <seg>
268 gapplication, gdbus, gdbus-codegen,
269 gio, gio-querymodules,
270 glib-compile-resources, glib-compile-schemas,
271 glib-genmarshal, glib-gettextize,
272 glib-mkenums, gobject-query,
273 gresource, gsettings,
274 gtester, and gtester-report
275 </seg>
276 <seg>
277 libgio-2.0.so,
278 libglib-2.0.so,
279 libgmodule-2.0.so,
280 libgobject-2.0.so, and
281 libgthread-2.0.so
282 </seg>
283 <seg>
284 /usr/include/gio-unix-2.0,
285 /usr/include/glib-2.0,
286 /usr/lib/glib-2.0,
287 /usr/share/glib-2.0,
288 /usr/share/doc/glib-&glib2-version;, and
289 /usr/share/gtk-doc/html/{gio,glib,gobject}
290 </seg>
291 </seglistitem>
292 </segmentedlist>
293
294 <variablelist>
295 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
296 <?dbfo list-presentation="list"?>
297 <?dbhtml list-presentation="table"?>
298
299 <varlistentry id="gapplication">
300 <term><command>gapplication</command></term>
301 <listitem>
302 <para>
303 can be used to start applications and to send
304 messages to already-running instances of other applications.
305 </para>
306 <indexterm zone="glib2 gapplication">
307 <primary sortas="b-gapplication">application</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311 <varlistentry id="gdbus">
312 <term><command>gdbus</command></term>
313 <listitem>
314 <para>
315 is a simple tool used for working with
316 <application>D-Bus</application> objects.
317 </para>
318 <indexterm zone="glib2 gdbus">
319 <primary sortas="b-gdbus">gdbus</primary>
320 </indexterm>
321 </listitem>
322 </varlistentry>
323
324 <varlistentry id="gdbus-codegen">
325 <term><command>gdbus-codegen</command></term>
326 <listitem>
327 <para>
328 is used to generate code and/or documentation for one or
329 more <application>D-Bus</application> interfaces.
330 </para>
331 <indexterm zone="glib2 gdbus-codegen">
332 <primary sortas="b-gdbus-codegen">gdbus-codegen</primary>
333 </indexterm>
334 </listitem>
335 </varlistentry>
336
337 <varlistentry id="gio">
338 <term><command>gio</command></term>
339 <listitem>
340 <para>
341 is a utility that makes many <application>GIO</application>
342 features available from the command line.
343 </para>
344 <indexterm zone="glib2 gio">
345 <primary sortas="b-gio">gio</primary>
346 </indexterm>
347 </listitem>
348 </varlistentry>
349
350 <varlistentry id="gio-querymodules">
351 <term><command>gio-querymodules</command></term>
352 <listitem>
353 <para>
354 is used to create a <filename>giomodule.cache</filename> file in
355 the listed directories. This file lists the implemented extension
356 points for each module that has been found.
357 </para>
358 <indexterm zone="glib2 gio-querymodules">
359 <primary sortas="b-gio-querymodules">gio-querymodules</primary>
360 </indexterm>
361 </listitem>
362 </varlistentry>
363
364 <varlistentry id="glib-compile-resources">
365 <term><command>glib-compile-resources</command></term>
366 <listitem>
367 <para>
368 is used to read the resource description from a file and
369 the files that it references to create a binary resource
370 bundle that is suitable for use with the GResource API.
371 </para>
372 <indexterm zone="glib2 glib-compile-resources">
373 <primary sortas="b-glib-compile-resources">glib-compile-resources</primary>
374 </indexterm>
375 </listitem>
376 </varlistentry>
377
378 <varlistentry id="glib-compile-schemas">
379 <term><command>glib-compile-schemas</command></term>
380 <listitem>
381 <para>
382 is used to compile all the GSettings XML schema files
383 in a directory into a binary file with the name
384 <filename>gschemas.compiled</filename> that can be used by GSettings.
385 </para>
386 <indexterm zone="glib2 glib-compile-schemas">
387 <primary sortas="b-glib-compile-resources">glib-compile-schemas</primary>
388 </indexterm>
389 </listitem>
390 </varlistentry>
391
392 <varlistentry id="glib-genmarshal">
393 <term><command>glib-genmarshal</command></term>
394 <listitem>
395 <para>
396 is a C code marshaller generation utility for GLib closures.
397 </para>
398 <indexterm zone="glib2 glib-genmarshal">
399 <primary sortas="b-glib-genmarshal">glib-genmarshal</primary>
400 </indexterm>
401 </listitem>
402 </varlistentry>
403
404 <varlistentry id="glib-gettextize">
405 <term><command>glib-gettextize</command></term>
406 <listitem>
407 <para>
408 is a variant of the <application>gettext</application>
409 internationalization utility.
410 </para>
411 <indexterm zone="glib2 glib-gettextize">
412 <primary sortas="b-glib-gettextize">glib-gettextize</primary>
413 </indexterm>
414 </listitem>
415 </varlistentry>
416
417 <varlistentry id="glib-mkenums">
418 <term><command>glib-mkenums</command></term>
419 <listitem>
420 <para>
421 is a C language enum description generation utility.
422 </para>
423 <indexterm zone="glib2 glib-mkenums">
424 <primary sortas="b-glib-mkenums">glib-mkenums</primary>
425 </indexterm>
426 </listitem>
427 </varlistentry>
428
429 <varlistentry id="gobject-query">
430 <term><command>gobject-query</command></term>
431 <listitem>
432 <para>
433 is a small utility that draws a tree of types.
434 </para>
435 <indexterm zone="glib2 gobject-query">
436 <primary sortas="b-gobject-query">gobject-query</primary>
437 </indexterm>
438 </listitem>
439 </varlistentry>
440
441 <varlistentry id="gresource">
442 <term><command>gresource</command></term>
443 <listitem>
444 <para>
445 offers a simple command line interface to GResource.
446 </para>
447 <indexterm zone="glib2 gresource">
448 <primary sortas="b-gresource">gresource</primary>
449 </indexterm>
450 </listitem>
451 </varlistentry>
452
453 <varlistentry id="gsettings">
454 <term><command>gsettings</command></term>
455 <listitem>
456 <para>
457 offers a simple command line interface to GSettings.
458 </para>
459 <indexterm zone="glib2 gsettings">
460 <primary sortas="b-gsettings">gsettings</primary>
461 </indexterm>
462 </listitem>
463 </varlistentry>
464
465 <varlistentry id="gtester">
466 <term><command>gtester</command></term>
467 <listitem>
468 <para>
469 is a test running utility.
470 </para>
471 <indexterm zone="glib2 gtester">
472 <primary sortas="b-gtester">gtester</primary>
473 </indexterm>
474 </listitem>
475 </varlistentry>
476
477 <varlistentry id="gtester-report">
478 <term><command>gtester-report</command></term>
479 <listitem>
480 <para>
481 is a test report formatting utility.
482 </para>
483 <indexterm zone="glib2 gtester-report">
484 <primary sortas="b-gtester-report">gtester-report</primary>
485 </indexterm>
486 </listitem>
487 </varlistentry>
488
489 <varlistentry id="GLib-libraries">
490 <term>GLib libraries</term>
491 <listitem>
492 <para>
493 contain low-level core libraries for the
494 <application>GIMP</application> Toolkit.
495 </para>
496 <indexterm zone="glib2 GLib-libraries">
497 <primary sortas="c-GLib-libraries">Glib libraries</primary>
498 </indexterm>
499 </listitem>
500 </varlistentry>
501
502 </variablelist>
503
504 </sect2>
505
506</sect1>
Note: See TracBrowser for help on using the repository browser.