source: general/genlib/glib2.xml@ b22a6dbc

10.0 10.1 11.0 7.10 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b22a6dbc was b22a6dbc, checked in by Fernando de Oliveira <fernando@…>, 6 years ago
  • Fix again the Change Log.
  • Update to audacious-3.7 and audacious-plugins-3.7.
  • Update to at-spi2-core-2.18.2.
  • Update to qpdf-5.2.0.
  • Update to glib-2.46.2.

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

  • Property mode set to 100644
File size: 12.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/2.46/glib-&glib2-version;.tar.xz">
8 <!ENTITY glib2-download-ftp "&gnome-download-ftp;/glib/2.46/glib-&glib2-version;.tar.xz">
9 <!ENTITY glib2-md5sum "7f815d6e46df68e070cb421ed7f1139e">
10 <!ENTITY glib2-size "7.1 MB">
11 <!ENTITY glib2-buildsize "187 MB (additional 74 MB for tests)">
12 <!ENTITY glib2-time "0.8 SBU (additional 3.3 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 &lfs78_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">GLib Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Required</bridgehead>
78 <para role="required">
79 <xref linkend="libffi"/> and
80 <xref linkend="python2"/> or <xref linkend="python3"/>
81 </para>
82
83 <bridgehead renderas="sect4">Recommended</bridgehead>
84 <para role="recommended">
85 <xref linkend="pcre"/> (built with Unicode properties)
86 </para>
87
88 <bridgehead renderas="sect4">Optional</bridgehead>
89 <para role="optional">
90 <xref linkend="dbus"/> (required for some tests),
91 <xref linkend="elfutils"/>,
92 <xref linkend="gtk-doc"/>, and
93 <ulink url="ftp://oss.sgi.com/projects/fam/download/stable/">FAM library</ulink>
94 </para>
95
96 <bridgehead renderas="sect4">Additional Runtime Dependencies</bridgehead>
97 <para role="optional">
98 Quoted directly from the <filename>INSTALL</filename> file:
99 <quote>Some of the mimetype-related functionality in GIO requires the
100 <command>update-mime-database</command> and
101 <command>update-desktop-database</command> utilities</quote>,
102 which are part of
103 <xref linkend="shared-mime-info"/> and
104 <xref linkend="desktop-file-utils"/>, respectively.
105 </para>
106
107 <para condition="html" role="usernotes">User Notes:
108 <ulink url="&blfs-wiki;/glib2"/>
109 </para>
110 </sect2>
111
112 <sect2 role="installation">
113 <title>Installation of GLib</title>
114
115 <para>
116 Install <application>GLib</application> by running the following
117 commands:
118 </para>
119
120<screen><userinput>./configure --prefix=/usr --with-pcre=system &amp;&amp;
121make</userinput></screen>
122
123 <para>
124 The <application>GLib</application> test suite requires
125 <application>desktop-file-utils</application> for some tests. However,
126 <application>desktop-file-utils</application> requires
127 <application>GLib</application> in order to compile; therefore, you must
128 first install <application>GLib</application> and then run the test
129 suite.
130 </para>
131
132 <para>
133 Now, as the <systemitem class="username">root</systemitem> user:
134 </para>
135
136<screen role="root"><userinput>make install</userinput></screen>
137
138 <para>
139 You should now install <xref linkend="desktop-file-utils"/> and proceed to
140 run the test suite.
141 </para>
142
143 <para>
144 To test the results, after having installed the package, issue:
145 <command>make -k check</command>. Two tests produce errors.
146 </para>
147
148 </sect2>
149
150 <sect2 role="commands">
151 <title>Command Explanations</title>
152
153 <para>
154 <parameter>--with-pcre=system</parameter>: This switch causes the
155 build to use a system-provided version of the
156 <application>PCRE</application> library instead of an internal
157 version.
158 </para>
159
160 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
161 href="../../xincludes/gtk-doc-rebuild.xml"/>
162
163 <para>
164 <option>--with-python=python3</option>: Add this switch if you want GLib
165 to use Python3 instead of Python2.
166 </para>
167
168 </sect2>
169
170 <sect2 role="content">
171 <title>Contents</title>
172
173 <segmentedlist>
174 <segtitle>Installed Programs</segtitle>
175 <segtitle>Installed Libraries</segtitle>
176 <segtitle>Installed Directories</segtitle>
177
178 <seglistitem>
179 <seg>
180 gapplication, gdbus, gdbus-codegen, gio-querymodules,
181 glib-compile-resources, glib-compile-schemas,
182 glib-genmarshal, glib-gettextize, glib-mkenums,
183 gobject-query, gresource, gsettings, gtester,
184 and gtester-report
185 </seg>
186 <seg>
187 libgio-2.0.so, libglib-2.0.so, libgmodule-2.0.so,
188 libgobject-2.0.so, and libgthread-2.0.so
189 </seg>
190 <seg>
191 /usr/include/gio-unix-2.0,
192 /usr/{include,lib,share}/glib-2.0,
193 /usr/lib/gio, and
194 /usr/share/gtk-doc/html/g{io,lib,object}
195 </seg>
196 </seglistitem>
197 </segmentedlist>
198
199 <variablelist>
200 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
201 <?dbfo list-presentation="list"?>
202 <?dbhtml list-presentation="table"?>
203
204 <varlistentry id="gapplication">
205 <term><command>gapplication</command></term>
206 <listitem>
207 <para>
208 can be used to start applications and can be used to send
209 messages to already-running instances of other applications.
210 </para>
211 <indexterm zone="glib2 gapplication">
212 <primary sortas="b-gapplication">application</primary>
213 </indexterm>
214 </listitem>
215 </varlistentry>
216 <varlistentry id="gdbus">
217 <term><command>gdbus</command></term>
218 <listitem>
219 <para>
220 is a simple tool used for working with
221 <application>D-Bus</application> objects.
222 </para>
223 <indexterm zone="glib2 gdbus">
224 <primary sortas="b-gdbus">gdbus</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="gdbus-codegen">
230 <term><command>gdbus-codegen</command></term>
231 <listitem>
232 <para>
233 is used to generate code and/or documentation for one or
234 more <application>D-Bus</application> interfaces.
235 </para>
236 <indexterm zone="glib2 gdbus-codegen">
237 <primary sortas="b-gdbus-codegen">gdbus-codegen</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="gio-querymodules">
243 <term><command>gio-querymodules</command></term>
244 <listitem>
245 <para>
246 is used to create a giomodule.cache file in the listed directories.
247 This file lists the implemented extension points for each module
248 that has been found.
249 </para>
250 <indexterm zone="glib2 gio-querymodules">
251 <primary sortas="b-gio-querymodules">gio-querymodules</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255
256 <varlistentry id="glib-compile-resources">
257 <term><command>glib-compile-resources</command></term>
258 <listitem>
259 <para>
260 is used to read the resource description from file and
261 the files that it references to create a binary resource
262 bundle that is suitable for use with the GResource API.
263 </para>
264 <indexterm zone="glib2 glib-compile-resources">
265 <primary sortas="b-glib-compile-resources">glib-compile-resources</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="glib-compile-schemas">
271 <term><command>glib-compile-schemas</command></term>
272 <listitem>
273 <para>
274 is used to compile all the GSettings XML schema files
275 in directory into a binary file with the name gschemas.compiled
276 that can be used by GSettings.
277 </para>
278 <indexterm zone="glib2 glib-compile-schemas">
279 <primary sortas="b-glib-compile-resources">glib-compile-schemas</primary>
280 </indexterm>
281 </listitem>
282 </varlistentry>
283
284 <varlistentry id="glib-genmarshal">
285 <term><command>glib-genmarshal</command></term>
286 <listitem>
287 <para>
288 is a C code marshaller generation utility for GLib closures.
289 </para>
290 <indexterm zone="glib2 glib-genmarshal">
291 <primary sortas="b-glib-genmarshal">glib-genmarshal</primary>
292 </indexterm>
293 </listitem>
294 </varlistentry>
295
296 <varlistentry id="glib-gettextize">
297 <term><command>glib-gettextize</command></term>
298 <listitem>
299 <para>
300 is a variant of the <application>gettext</application>
301 internationalization utility.
302 </para>
303 <indexterm zone="glib2 glib-gettextize">
304 <primary sortas="b-glib-gettextize">glib-gettextize</primary>
305 </indexterm>
306 </listitem>
307 </varlistentry>
308
309 <varlistentry id="glib-mkenums">
310 <term><command>glib-mkenums</command></term>
311 <listitem>
312 <para>
313 is a C language enum description generation utility.
314 </para>
315 <indexterm zone="glib2 glib-mkenums">
316 <primary sortas="b-glib-mkenums">glib-mkenums</primary>
317 </indexterm>
318 </listitem>
319 </varlistentry>
320
321 <varlistentry id="gobject-query">
322 <term><command>gobject-query</command></term>
323 <listitem>
324 <para>
325 is a small utility that draws a tree of types.
326 </para>
327 <indexterm zone="glib2 gobject-query">
328 <primary sortas="b-gobject-query">gobject-query</primary>
329 </indexterm>
330 </listitem>
331 </varlistentry>
332
333 <varlistentry id="gresource">
334 <term><command>gresource</command></term>
335 <listitem>
336 <para>
337 offers a simple commandline interface to GResource.
338 </para>
339 <indexterm zone="glib2 gresource">
340 <primary sortas="b-gresource">gresource</primary>
341 </indexterm>
342 </listitem>
343 </varlistentry>
344
345 <varlistentry id="gsettings">
346 <term><command>gsettings</command></term>
347 <listitem>
348 <para>
349 offers a simple commandline interface to GSettings.
350 </para>
351 <indexterm zone="glib2 gsettings">
352 <primary sortas="b-gsettings">gsettings</primary>
353 </indexterm>
354 </listitem>
355 </varlistentry>
356
357 <varlistentry id="gtester">
358 <term><command>gtester</command></term>
359 <listitem>
360 <para>
361 is a test running utility.
362 </para>
363 <indexterm zone="glib2 gtester">
364 <primary sortas="b-gtester">gtester</primary>
365 </indexterm>
366 </listitem>
367 </varlistentry>
368
369 <varlistentry id="gtester-report">
370 <term><command>gtester-report</command></term>
371 <listitem>
372 <para>
373 is a test report formatting utility.
374 </para>
375 <indexterm zone="glib2 gtester-report">
376 <primary sortas="b-gtester-report">gtester-report</primary>
377 </indexterm>
378 </listitem>
379 </varlistentry>
380
381 <varlistentry id="GLib-libraries">
382 <term>GLib libraries</term>
383 <listitem>
384 <para>
385 contain low-level core libraries for the
386 <application>GIMP</application> Toolkit.
387 </para>
388 <indexterm zone="glib2 GLib-libraries">
389 <primary sortas="c-GLib-libraries">Glib libraries</primary>
390 </indexterm>
391 </listitem>
392 </varlistentry>
393
394 </variablelist>
395
396 </sect2>
397
398</sect1>
Note: See TracBrowser for help on using the repository browser.