source: general/genlib/glib2.xml@ 86ceb63

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 xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 86ceb63 was 86ceb63, checked in by Douglas R. Reno <renodr@…>, 5 years ago

Add gobject-introspection as a recommended runtime dependency for Glib2

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

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