source: general/genlib/glib2.xml@ 60ddbaf

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 60ddbaf was 60ddbaf, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Remove ninja, libffi, and python3 as dependencies
for many packages as they are now a part of LFS.

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

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