source: general/genlib/glib2.xml@ a9c0e8d

10.0 10.1 11.0 11.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since a9c0e8d was a9c0e8d, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Add an optional patch to glib to allow user supression of
unwanted warning messages.

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

  • Property mode set to 100644
File size: 14.6 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 "6e4db71816ccbc8dabf0e58fa7228e76">
10 <!ENTITY glib2-size "7.5 MB">
11 <!ENTITY glib2-buildsize "190 MB (additional 74 MB for tests)">
12 <!ENTITY glib2-time "1.0 SBU (additional 4.6 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 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">Required</bridgehead>
88 <para role="required">
89 <xref linkend="python2"/> or <xref linkend="python3"/>
90 </para>
91-->
92 <bridgehead renderas="sect4">Recommended</bridgehead>
93 <para role="recommended">
94 <xref linkend="pcre"/> (built with Unicode properties)
95 </para>
96
97 <bridgehead renderas="sect4">Optional</bridgehead>
98 <para role="optional">
99 <xref linkend="dbus"/> (required for some tests),
100 <xref linkend="elfutils"/>,
101 <xref linkend="gtk-doc"/>,
102 <xref linkend="python2"/>,
103 <ulink url="ftp://oss.sgi.com/projects/fam/download/stable/">FAM library</ulink>, and
104 <ulink url="https://www.gnu.org/software/indent/">GNU Indent</ulink>
105 </para>
106
107 <bridgehead renderas="sect4">Additional Runtime Dependencies</bridgehead>
108 <para role="recommended">
109 <xref role="runtime" linkend="gobject-introspection"/>
110 (should be installed before gtk+, atk, etc.)
111 </para>
112 <para role="optional">
113 Quoted directly from the <filename>INSTALL</filename> file:
114 <quote>Some of the mimetype-related functionality in GIO requires the
115 <command>update-mime-database</command> and
116 <command>update-desktop-database</command> utilities</quote>,
117 which are part of
118 <xref role="runtime" linkend="shared-mime-info"/> and
119 <xref role="runtime" linkend="desktop-file-utils"/>, respectively.
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>If desired, appy the optional patch. In many cases, applications that
131 use this library, either directly or indirectly via other libraries such
132 as <xref linkend="gtk3"/>, output numerous warnings when run from the
133 command line. This patch enables the use of an environment variable,
134 GLIB_LOG_LEVEL, that supresses unwanted messages. The value of the
135 variable is a digit that corresponds to:</para>
136
137 <simplelist>
138 <member>1 Alert</member>
139 <member>2 Critical</member>
140 <member>3 Error</member>
141 <member>4 Warning</member>
142 <member>5 Notice</member>
143 </simplelist>
144
145 <para>For instance GLIB_LOG_LEVEL=4 will skip output of Warning and
146 Notice messages (and Info/Debug messages if they are turned on).
147 If GLIB_LOG_LEVEL is not defined, normal message output will not
148 be affected.</para>
149
150<screen><userinput>patch -Np1 -i ../glib-&glib2-version;-skip_warnings-1.patch</userinput></screen>
151
152 <para>
153 Install <application>GLib</application> by running the following
154 commands:
155 </para>
156
157<screen><userinput>./configure --prefix=/usr \
158 --with-pcre=system \
159 --with-python=/usr/bin/python3 &amp;&amp;
160make</userinput></screen>
161
162 <para>
163 The <application>GLib</application> test suite requires
164 <application>desktop-file-utils</application> for some tests. However,
165 <application>desktop-file-utils</application> requires
166 <application>GLib</application> in order to compile; therefore, you must
167 first install <application>GLib</application> and then run the test
168 suite.
169 </para>
170
171 <para>
172 Now, as the <systemitem class="username">root</systemitem> user:
173 </para>
174
175<screen role="root"><userinput>make install</userinput></screen>
176
177 <para>
178 You should now install <xref linkend="desktop-file-utils"/> and proceed to
179 run the test suite.
180 </para>
181
182 <para>
183 To test the results, after having installed the package, issue:
184 <command>make -k check</command>.
185 </para>
186
187 </sect2>
188
189 <sect2 role="commands">
190 <title>Command Explanations</title>
191
192 <para>
193 <parameter>--with-pcre=system</parameter>: This switch causes the
194 build to use a system-provided version of the
195 <application>PCRE</application> library instead of an internal
196 version.
197 </para>
198
199 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
200 href="../../xincludes/gtk-doc-rebuild.xml"/>
201
202 <para>
203 <option>--with-python=/usr/bin/python3</option>: Add this switch if you
204 want GLib to use Python3 instead of Python2.
205 </para>
206
207 </sect2>
208
209 <sect2 role="content">
210 <title>Contents</title>
211
212 <segmentedlist>
213 <segtitle>Installed Programs</segtitle>
214 <segtitle>Installed Libraries</segtitle>
215 <segtitle>Installed Directories</segtitle>
216
217 <seglistitem>
218 <seg>
219 gapplication, gdbus, gdbus-codegen, gio, gio-querymodules,
220 glib-compile-resources, glib-compile-schemas,
221 glib-genmarshal, glib-gettextize, glib-mkenums,
222 gobject-query, gresource, gsettings, gtester,
223 and gtester-report
224 </seg>
225 <seg>
226 libgio-2.0.so, libglib-2.0.so, libgmodule-2.0.so,
227 libgobject-2.0.so, and libgthread-2.0.so
228 </seg>
229 <seg>
230 /usr/include/gio-unix-2.0,
231 /usr/{include,lib,share}/glib-2.0,
232 /usr/lib/gio, and
233 /usr/share/gtk-doc/html/g{io,lib,object}
234 </seg>
235 </seglistitem>
236 </segmentedlist>
237
238 <variablelist>
239 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
240 <?dbfo list-presentation="list"?>
241 <?dbhtml list-presentation="table"?>
242
243 <varlistentry id="gapplication">
244 <term><command>gapplication</command></term>
245 <listitem>
246 <para>
247 can be used to start applications and to send
248 messages to already-running instances of other applications.
249 </para>
250 <indexterm zone="glib2 gapplication">
251 <primary sortas="b-gapplication">application</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255 <varlistentry id="gdbus">
256 <term><command>gdbus</command></term>
257 <listitem>
258 <para>
259 is a simple tool used for working with
260 <application>D-Bus</application> objects.
261 </para>
262 <indexterm zone="glib2 gdbus">
263 <primary sortas="b-gdbus">gdbus</primary>
264 </indexterm>
265 </listitem>
266 </varlistentry>
267
268 <varlistentry id="gdbus-codegen">
269 <term><command>gdbus-codegen</command></term>
270 <listitem>
271 <para>
272 is used to generate code and/or documentation for one or
273 more <application>D-Bus</application> interfaces.
274 </para>
275 <indexterm zone="glib2 gdbus-codegen">
276 <primary sortas="b-gdbus-codegen">gdbus-codegen</primary>
277 </indexterm>
278 </listitem>
279 </varlistentry>
280
281 <varlistentry id="gio">
282 <term><command>gio</command></term>
283 <listitem>
284 <para>
285 is a utility that makes many <application>GIO</application>
286 features available from the command line.
287 </para>
288 <indexterm zone="glib2 gio">
289 <primary sortas="b-gio">gio</primary>
290 </indexterm>
291 </listitem>
292 </varlistentry>
293
294 <varlistentry id="gio-querymodules">
295 <term><command>gio-querymodules</command></term>
296 <listitem>
297 <para>
298 is used to create a <filename>giomodule.cache</filename> file in
299 the listed directories. This file lists the implemented extension
300 points for each module that has been found.
301 </para>
302 <indexterm zone="glib2 gio-querymodules">
303 <primary sortas="b-gio-querymodules">gio-querymodules</primary>
304 </indexterm>
305 </listitem>
306 </varlistentry>
307
308 <varlistentry id="glib-compile-resources">
309 <term><command>glib-compile-resources</command></term>
310 <listitem>
311 <para>
312 is used to read the resource description from a file and
313 the files that it references to create a binary resource
314 bundle that is suitable for use with the GResource API.
315 </para>
316 <indexterm zone="glib2 glib-compile-resources">
317 <primary sortas="b-glib-compile-resources">glib-compile-resources</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="glib-compile-schemas">
323 <term><command>glib-compile-schemas</command></term>
324 <listitem>
325 <para>
326 is used to compile all the GSettings XML schema files
327 in directory into a binary file with the name
328 <filename>gschemas.compiled</filename> that can be used by GSettings.
329 </para>
330 <indexterm zone="glib2 glib-compile-schemas">
331 <primary sortas="b-glib-compile-resources">glib-compile-schemas</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 <varlistentry id="glib-genmarshal">
337 <term><command>glib-genmarshal</command></term>
338 <listitem>
339 <para>
340 is a C code marshaller generation utility for GLib closures.
341 </para>
342 <indexterm zone="glib2 glib-genmarshal">
343 <primary sortas="b-glib-genmarshal">glib-genmarshal</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 <varlistentry id="glib-gettextize">
349 <term><command>glib-gettextize</command></term>
350 <listitem>
351 <para>
352 is a variant of the <application>gettext</application>
353 internationalization utility.
354 </para>
355 <indexterm zone="glib2 glib-gettextize">
356 <primary sortas="b-glib-gettextize">glib-gettextize</primary>
357 </indexterm>
358 </listitem>
359 </varlistentry>
360
361 <varlistentry id="glib-mkenums">
362 <term><command>glib-mkenums</command></term>
363 <listitem>
364 <para>
365 is a C language enum description generation utility.
366 </para>
367 <indexterm zone="glib2 glib-mkenums">
368 <primary sortas="b-glib-mkenums">glib-mkenums</primary>
369 </indexterm>
370 </listitem>
371 </varlistentry>
372
373 <varlistentry id="gobject-query">
374 <term><command>gobject-query</command></term>
375 <listitem>
376 <para>
377 is a small utility that draws a tree of types.
378 </para>
379 <indexterm zone="glib2 gobject-query">
380 <primary sortas="b-gobject-query">gobject-query</primary>
381 </indexterm>
382 </listitem>
383 </varlistentry>
384
385 <varlistentry id="gresource">
386 <term><command>gresource</command></term>
387 <listitem>
388 <para>
389 offers a simple command line interface to GResource.
390 </para>
391 <indexterm zone="glib2 gresource">
392 <primary sortas="b-gresource">gresource</primary>
393 </indexterm>
394 </listitem>
395 </varlistentry>
396
397 <varlistentry id="gsettings">
398 <term><command>gsettings</command></term>
399 <listitem>
400 <para>
401 offers a simple command line interface to GSettings.
402 </para>
403 <indexterm zone="glib2 gsettings">
404 <primary sortas="b-gsettings">gsettings</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 <varlistentry id="gtester">
410 <term><command>gtester</command></term>
411 <listitem>
412 <para>
413 is a test running utility.
414 </para>
415 <indexterm zone="glib2 gtester">
416 <primary sortas="b-gtester">gtester</primary>
417 </indexterm>
418 </listitem>
419 </varlistentry>
420
421 <varlistentry id="gtester-report">
422 <term><command>gtester-report</command></term>
423 <listitem>
424 <para>
425 is a test report formatting utility.
426 </para>
427 <indexterm zone="glib2 gtester-report">
428 <primary sortas="b-gtester-report">gtester-report</primary>
429 </indexterm>
430 </listitem>
431 </varlistentry>
432
433 <varlistentry id="GLib-libraries">
434 <term>GLib libraries</term>
435 <listitem>
436 <para>
437 contain low-level core libraries for the
438 <application>GIMP</application> Toolkit.
439 </para>
440 <indexterm zone="glib2 GLib-libraries">
441 <primary sortas="c-GLib-libraries">Glib libraries</primary>
442 </indexterm>
443 </listitem>
444 </varlistentry>
445
446 </variablelist>
447
448 </sect2>
449
450</sect1>
Note: See TracBrowser for help on using the repository browser.