source: general/genlib/glib2.xml@ ca041f6

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules 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 ca041f6 was ca041f6, checked in by DJ Lucas <dj@…>, 6 years ago

Correct glib2 instructions. Add descriptive warning (without instructions) for upgrade fix.

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

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