source: general/genlib/glib2.xml@ b5ed6d1

10.0 10.1 11.0 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b5ed6d1 was b5ed6d1, checked in by Douglas R. Reno <renodr@…>, 5 years ago

Update to glib-2.50.2

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

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