source: general/genlib/glib2.xml@ aee85523

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

Add comments about .la files when installing glib

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

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