source: general/genlib/gobject-introspection.xml@ ef9dcfb

10.0 10.1 11.0 11.1 11.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since ef9dcfb was ef9dcfb, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to libinput-1.10.4.
Update to xf86-input-libinput-0.27.1.
Update to Beaker-1.9.1 (Python Module).
Update to wayland-1.15.0.
Update to gobject-introspection-1.56.1.
Update to nss-4.36.1.

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

  • Property mode set to 100644
File size: 8.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 gobject-introspection-download-http
8 "&gnome-download-http;/gobject-introspection/1.56/gobject-introspection-&gobject-introspection-version;.tar.xz">
9 <!ENTITY gobject-introspection-download-ftp
10 "&gnome-download-ftp;/gobject-introspection/1.56/gobject-introspection-&gobject-introspection-version;.tar.xz">
11 <!ENTITY gobject-introspection-md5sum "62e5f5685b8d9752fdeaf17c057d53d1">
12 <!ENTITY gobject-introspection-size "1.3 MB">
13 <!ENTITY gobject-introspection-buildsize "39 MB (add 13 MB for tests)">
14 <!ENTITY gobject-introspection-time "0.3 SBU (add 0.3 SBU for tests)">
15]>
16
17<sect1 id="gobject-introspection" xreflabel="gobject-introspection-&gobject-introspection-version;">
18 <?dbhtml filename="gobject-introspection.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>gobject-introspection-&gobject-introspection-version;</title>
26
27 <indexterm zone="gobject-introspection">
28 <primary sortas="a-gobject-introspection">gobject-introspection</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to GObject Introspection</title>
33
34 <para>
35 The <application>GObject Introspection</application> is used
36 to describe the program APIs and collect them in a uniform,
37 machine readable format.
38 </para>
39
40 &lfs82_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&gobject-introspection-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&gobject-introspection-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &gobject-introspection-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &gobject-introspection-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &gobject-introspection-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &gobject-introspection-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="glib2"/>
79 </para>
80
81 <bridgehead renderas="sect4">Recommended</bridgehead>
82 <para role="recommended">
83 <xref linkend="which"/>
84<!-- If - -with-python is used, configure runs "which $PYTHON", where PYTHON
85 is set to the argument of the switch. Somewhat silly because the presence
86 of which is not tested... -->
87 </para>
88
89 <bridgehead renderas="sect4">Optional</bridgehead>
90 <para role="optional">
91 <xref linkend="cairo"/> (required for the tests),
92 <xref linkend="gtk-doc"/>,
93 <xref linkend="Mako"/>, and
94 <xref linkend="python2"/>
95 </para>
96
97 <para condition="html" role="usernotes">User Notes:
98 <ulink url="&blfs-wiki;/gobject-introspection"/>
99 </para>
100 </sect2>
101
102 <sect2 role="installation">
103 <title>Installation of GObject Introspection</title>
104
105 <para>
106 Install <application>GObject Introspection</application> by running
107 the following commands:
108 </para>
109
110<screen><userinput>./configure --prefix=/usr \
111 --disable-static \
112 --with-python=/usr/bin/python3 &amp;&amp;
113make</userinput></screen>
114
115 <para>
116 To test the results, issue: <command>make check</command>.
117<!-- One test, Regress-1.0.gir, is known to fail with glibc-2.26. -->
118 </para>
119
120 <para>
121 Now, as the <systemitem class="username">root</systemitem> user:
122 </para>
123
124<screen role="root"><userinput>make install</userinput></screen>
125
126 </sect2>
127
128 <sect2 role="commands">
129 <title>Command Explanations</title>
130
131 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
132 href="../../xincludes/static-libraries.xml"/>
133
134 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
135 href="../../xincludes/gtk-doc-rebuild.xml"/>
136
137 <para><parameter>--with-python=/usr/bin/python3</parameter>: ensure the
138 Python-3.x interpreter is used instead of Python-2.x if installed.</para>
139
140 </sect2>
141
142 <sect2 role="content">
143 <title>Contents</title>
144
145 <segmentedlist>
146 <segtitle>Installed Program</segtitle>
147 <segtitle>Installed Libraries</segtitle>
148 <segtitle>Installed Directories</segtitle>
149
150 <!-- g-ir-doc-tool is installed if mako is presnet -->
151 <seglistitem>
152 <seg>
153 g-ir-annotation-tool, g-ir-compiler, g-ir-doc-tool,
154 g-ir-inspect, g-ir-generate, and g-ir-scanner
155 </seg>
156 <seg>
157 libgirepository-1.0.so and
158 /usr/lib/gobject-introspection/giscanner/_giscanner.so
159 </seg>
160 <seg>
161 /usr/include/gobject-introspection-1.0,
162 /usr/lib/girepository-1.0,
163 /usr/lib/gobject-introspection,
164 /usr/share/gir-1.0, and
165 /usr/share/gobject-introspection-1.0
166 </seg>
167 </seglistitem>
168 </segmentedlist>
169
170 <variablelist>
171 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
172 <?dbfo list-presentation="list"?>
173 <?dbhtml list-presentation="table"?>
174
175 <varlistentry id="g-ir-annotation-tool">
176 <term><command>g-ir-annotation-tool</command></term>
177 <listitem>
178 <para>
179 creates or extracts annotation data from GI typelibs.
180 </para>
181 <indexterm zone="gobject-introspection g-ir-annotation-tool">
182 <primary sortas="b-g-ir-annotation-tool">g-ir-annotation-tool</primary>
183 </indexterm>
184 </listitem>
185 </varlistentry>
186
187 <varlistentry id="g-ir-compiler">
188 <term><command>g-ir-compiler</command></term>
189 <listitem>
190 <para>
191 converts one or more GIR files into one or more typelib.
192 </para>
193 <indexterm zone="gobject-introspection g-ir-compiler">
194 <primary sortas="b-g-ir-compiler">g-ir-compiler</primary>
195 </indexterm>
196 </listitem>
197 </varlistentry>
198
199 <varlistentry id="g-ir-doc-tool">
200 <term><command>g-ir-doc-tool</command></term>
201 <listitem>
202 <para>
203 generates Mallard files that can be viewed with
204 <command>yelp</command> or rendered to HTML with
205 <command>yelp-build</command> from <ulink
206 url="http://ftp.acc.umu.se/pub/gnome/sources/yelp-tools">yelp-tools</ulink>.
207 </para>
208 <indexterm zone="gobject-introspection g-ir-doc-tool">
209 <primary sortas="b-g-ir-doc-tool">g-ir-doc-tool</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 <varlistentry id="g-ir-inspect">
215 <term><command>g-ir-inspect</command></term>
216 <listitem>
217 <para>
218 is a utility that gives information about a GI typelib.
219 </para>
220 <indexterm zone="gobject-introspection g-ir-inspect">
221 <primary sortas="b-g-ir-inspect">g-ir-inspect</primary>
222 </indexterm>
223 </listitem>
224 </varlistentry>
225
226 <varlistentry id="g-ir-scanner">
227 <term><command>g-ir-scanner</command></term>
228 <listitem>
229 <para>
230 is a tool which generates GIR XML files by parsing headers and
231 introspecting GObject based libraries.
232 </para>
233 <indexterm zone="gobject-introspection g-ir-scanner">
234 <primary sortas="b-g-ir-scanner">g-ir-scanner</primary>
235 </indexterm>
236 </listitem>
237 </varlistentry>
238
239 <varlistentry id="g-ir-generate">
240 <term><command>g-ir-generate</command></term>
241 <listitem>
242 <para>
243 is a GIR generator that uses the repository API.
244 </para>
245 <indexterm zone="gobject-introspection g-ir-generate">
246 <primary sortas="b-g-ir-generate">g-ir-generate</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250
251 <varlistentry id="libgirepository-1.0">
252 <term><filename class="libraryfile">libgirepository-1.0.so</filename></term>
253 <listitem>
254 <para>
255 provides an API to access the typelib metadata.
256 </para>
257 <indexterm zone="gobject-introspection libgirepository-1.0">
258 <primary sortas="c-libgirepository-1.0">libgirepository-1.0.so</primary>
259 </indexterm>
260 </listitem>
261 </varlistentry>
262
263 </variablelist>
264
265 </sect2>
266
267</sect1>
Note: See TracBrowser for help on using the repository browser.