source: general/genlib/dbus-bindings.xml@ c1a4344

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since c1a4344 was c1a4344, checked in by Guy Dalziel <gdalziel@…>, 15 years ago

Updated to Poppler-0.12.0.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@8021 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 14.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 dbus-glib-download-http "http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-&dbus-glib-version;.tar.gz">
8 <!ENTITY dbus-glib-download-ftp " ">
9 <!ENTITY dbus-glib-md5sum "aa2a4517de0e9144be3bce2cf8cdd924">
10 <!ENTITY dbus-glib-size "660 KB">
11 <!ENTITY dbus-glib-buildsize "10 MB">
12 <!ENTITY dbus-glib-time "0.2 SBU">
13
14 <!ENTITY dbus-python-download-http "http://dbus.freedesktop.org/releases/dbus-python/dbus-python-&dbus-python-version;.tar.gz">
15 <!ENTITY dbus-python-download-ftp " ">
16 <!ENTITY dbus-python-md5sum "562c78876219bf458d79a041af18293d">
17 <!ENTITY dbus-python-size "494 KB">
18 <!ENTITY dbus-python-buildsize "12 MB (includes installing all the documentation)">
19 <!ENTITY dbus-python-time "0.3 SBU">
20
21 <!ENTITY dbus-qt3-download-http "&files-anduin;/sources/dbus-qt3-&dbus-qt3-version;.tar.bz2">
22 <!ENTITY dbus-qt3-download-ftp " ">
23 <!ENTITY dbus-qt3-md5sum "307e119f501c207a437d1dd087c9af80">
24 <!ENTITY dbus-qt3-size "390 KB">
25 <!ENTITY dbus-qt3-buildsize "4 MB">
26 <!ENTITY dbus-qt3-time "0.1 SBU">
27
28 <!-- All the other bindings info should be here as well -->
29]>
30
31<sect1 id="dbus-bindings" xreflabel="D-Bus Bindings">
32 <?dbhtml filename="dbus-bindings.html"?>
33
34 <sect1info>
35 <othername>$LastChangedBy$</othername>
36 <date>$Date$</date>
37 </sect1info>
38
39 <title>D-Bus Bindings</title>
40
41 <indexterm zone="dbus-bindings">
42 <primary sortas="a-dbus-bindings">D-Bus Bindings</primary>
43 </indexterm>
44
45 <sect2 role="package">
46 <title>Introduction to D-Bus Bindings</title>
47
48 <para>The <application>D-Bus Bindings</application> are a group of packages
49 that contain programming language and platform interfaces to the D-Bus API.
50 This is useful for programmers to easily interface D-Bus with their
51 supported platform or language of choice. Some non-D-Bus packages will
52 require one or more of the Bindings packages in order to build
53 successfully.</para>
54
55 <para>The <application>GLib</application>,
56 <application>Python</application> and <application>Qt3</application>
57 Bindings are included on this page. Other language bindings will be added
58 soon. Until then, see the <ulink
59 url="http://www.freedesktop.org/wiki/Software/DBusBindings">D-Bus
60 Bindings</ulink> page for information.</para>
61
62 <itemizedlist spacing="compact">
63 <listitem>
64 <para><xref linkend="dbus-glib"/></para>
65 </listitem>
66 <listitem>
67 <para><xref linkend="dbus-python"/></para>
68 </listitem>
69 <listitem>
70 <para><xref linkend="dbus-qt3"/></para>
71 </listitem>
72 </itemizedlist>
73
74 </sect2>
75
76 <!-- Below is 111 lines to cut and paste to create a new binding -->
77 <!-- Begin D-Bus GLib Bindings -->
78 <sect2 id="dbus-glib" xreflabel="D-Bus GLib Bindings-&dbus-glib-version;">
79 <title>D-Bus GLib Bindings</title>
80
81 <indexterm zone="dbus-glib">
82 <primary sortas="a-dbus-glib">D-Bus GLib Bindings</primary>
83 </indexterm>
84
85 &lfs65_checked;
86
87 <bridgehead renderas="sect3">Package Information</bridgehead>
88 <itemizedlist spacing="compact">
89 <listitem>
90 <para>Download (HTTP): <ulink url="&dbus-glib-download-http;"/></para>
91 </listitem>
92 <listitem>
93 <para>Download (FTP): <ulink url="&dbus-glib-download-ftp;"/></para>
94 </listitem>
95 <listitem>
96 <para>Download MD5 sum: &dbus-glib-md5sum;</para>
97 </listitem>
98 <listitem>
99 <para>Download size: &dbus-glib-size;</para>
100 </listitem>
101 <listitem>
102 <para>Estimated disk space required: &dbus-glib-buildsize;</para>
103 </listitem>
104 <listitem>
105 <para>Estimated build time: &dbus-glib-time;</para>
106 </listitem>
107 </itemizedlist>
108
109 <bridgehead renderas="sect3">D-Bus GLib Dependencies</bridgehead>
110
111 <bridgehead renderas="sect4">Required</bridgehead>
112 <para role="required"><xref linkend="dbus"/>,
113 <xref linkend="glib2"/>, and
114 <xref linkend="expat"/></para>
115
116 <bridgehead renderas="sect4">Optional to Build the API Documentation</bridgehead>
117 <para role="required"><xref linkend="doxygen"/></para>
118
119 <para condition="html" role="usernotes">User Notes:
120 <ulink url="&blfs-wiki;/dbus-glib"/></para>
121
122 </sect2>
123
124 <sect2 role="installation">
125 <title>Installation of D-Bus GLib Bindings</title>
126
127 <para>Install <application>D-Bus GLib Bindings</application> by
128 running the following commands:</para>
129
130<screen><userinput>./configure --prefix=/usr \
131 --sysconfdir=/etc \
132 --libexecdir=/usr/lib/dbus-1.0/dbus-1 &amp;&amp;
133make</userinput></screen>
134
135 <para>The <option>--enable-doxygen-docs</option> parameter does not work
136 properly. If you have <application>Doxygen</application> installed and you
137 wish to build the API documentation, issue
138 <command>doxygen</command>.</para>
139
140 <para>To test the results, issue: <command>make check</command>. Note that
141 more comprehensive tests can be run by following the same method used in
142 <application>D-BUS</application> instructions, which requires building the
143 package twice.</para>
144
145 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
146
147<screen role="root"><userinput>make install</userinput></screen>
148
149 <para>If you built the API documentation, install it by issuing the
150 following commands as the <systemitem class="username">root</systemitem>
151 user:</para>
152
153<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/dbus-glib-&dbus-glib-version;/api \
154 /usr/share/man/man3dbus &amp;&amp;
155install -v -m644 doc/api/html/* \
156 /usr/share/doc/dbus-glib-&dbus-glib-version;/api &amp;&amp;
157install -v -m644 doc/api/man/man3dbus/* \
158 /usr/share/man/man3dbus</userinput></screen>
159
160 </sect2>
161
162 <sect2 role="commands">
163 <title>Command Explanations</title>
164
165 <para><parameter>--libexecdir=/usr/lib/dbus-1.0/dbus-1</parameter>: This
166 moves <command>dbus-bash-completion-helper</command> out of <filename
167 class="directory">/usr/libexec</filename>.</para>
168
169 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
170 href="../../xincludes/gtk-doc-rebuild.xml"/>
171
172 </sect2>
173
174 <sect2 role="content">
175 <title>Contents</title>
176
177 <segmentedlist>
178 <segtitle>Installed Program</segtitle>
179 <segtitle>Installed Library</segtitle>
180 <segtitle>Installed Directories</segtitle>
181
182 <seglistitem>
183 <seg>dbus-binding-tool</seg>
184 <seg>libdbus-glib-1.{so,a}</seg>
185 <seg>/etc/bash_completion.d, /usr/share/gtk-doc/html/dbus-glib, and
186 optionally /usr/share/doc/dbus-glib-&dbus-glib-version;/api</seg>
187 </seglistitem>
188 </segmentedlist>
189
190 <variablelist>
191 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
192 <?dbfo list-presentation="list"?>
193 <?dbhtml list-presentation="table"?>
194
195 <varlistentry id="glib-dbus-binding-tool">
196 <term><command>dbus-binding-tool</command></term>
197 <listitem>
198 <para>is a tool used to interface with the D-Bus API.</para>
199 <indexterm zone="dbus-glib glib-dbus-binding-tool">
200 <primary sortas="b-dbus-binding-tool">dbus-binding-tool</primary>
201 </indexterm>
202 </listitem>
203 </varlistentry>
204
205 <varlistentry id="libdbus-glib-1">
206 <term><filename class='libraryfile'>libdbus-glib-1.{so,a}</filename></term>
207 <listitem>
208 <para>contains <application>GLib</application> interface functions
209 to the D-Bus API.</para>
210 <indexterm zone="dbus-glib libdbus-glib-1">
211 <primary sortas="c-libdbus-glib-1">libdbus-glib-1.{so,a}</primary>
212 </indexterm>
213 </listitem>
214 </varlistentry>
215
216 </variablelist>
217
218 </sect2>
219
220 <!-- Begin D-Bus Python Bindings -->
221 <sect2 id="dbus-python" xreflabel="D-Bus Python Bindings-&dbus-python-version;">
222 <title>D-Bus Python Bindings</title>
223
224 <indexterm zone="dbus-python">
225 <primary sortas="a-dbus-python">D-Bus Python Bindings</primary>
226 </indexterm>
227
228 <bridgehead renderas="sect3">Package Information</bridgehead>
229 <itemizedlist spacing="compact">
230 <listitem>
231 <para>Download (HTTP): <ulink url="&dbus-python-download-http;"/></para>
232 </listitem>
233 <listitem>
234 <para>Download (FTP): <ulink url="&dbus-python-download-ftp;"/></para>
235 </listitem>
236 <listitem>
237 <para>Download MD5 sum: &dbus-python-md5sum;</para>
238 </listitem>
239 <listitem>
240 <para>Download size: &dbus-python-size;</para>
241 </listitem>
242 <listitem>
243 <para>Estimated disk space required: &dbus-python-buildsize;</para>
244 </listitem>
245 <listitem>
246 <para>Estimated build time: &dbus-python-time;</para>
247 </listitem>
248 </itemizedlist>
249
250 <bridgehead renderas="sect3">D-Bus Python Dependencies</bridgehead>
251
252 <bridgehead renderas="sect4">Required</bridgehead>
253 <para role="required"><xref linkend="python"/> and
254 <xref linkend="dbus-glib"/></para>
255
256 <bridgehead renderas="sect4">Optional</bridgehead>
257 <para role="optional"><ulink url="&gnome-download-http;/pygobject">PyGObject</ulink>
258 (required to run the test suite)</para>
259
260 <bridgehead renderas="sect4">Optional
261 (Required to build the API and HTML Documentation)</bridgehead>
262 <para role="optional"><ulink url="http://epydoc.sourceforge.net/">Epydoc</ulink>
263 and <ulink url="http://docutils.sourceforge.net/">Docutils</ulink></para>
264
265 <para condition="html" role="usernotes">User Notes:
266 <ulink url="&blfs-wiki;/dbus-python"/></para>
267
268 </sect2>
269
270 <sect2 role="installation">
271 <title>Installation of D-Bus Python Bindings</title>
272
273 <para>Install <application>D-Bus Python Bindings</application> by
274 running the following commands:</para>
275
276<screen><userinput>./configure --prefix=/usr \
277 --docdir=/usr/share/doc/dbus-python-&dbus-python-version; &amp;&amp;
278make</userinput></screen>
279
280 <para>To test the results, issue: <command>make check</command>. Note you
281 must have <application>PyGObject</application> installed.</para>
282
283 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
284
285<screen role="root"><userinput>make install</userinput></screen>
286
287 <para>If you built the API documentation, install it by issuing the
288 following commands as the <systemitem class="username">root</systemitem>
289 user:</para>
290
291<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/dbus-python-&dbus-python-version;/api &amp;&amp;
292install -v -m644 api/* \
293 /usr/share/doc/dbus-python-&dbus-python-version;/api</userinput></screen>
294
295 </sect2>
296
297 <sect2 role="content">
298 <title>Contents</title>
299
300 <segmentedlist>
301 <segtitle>Installed Programs</segtitle>
302 <segtitle>Installed Libraries</segtitle>
303 <segtitle>Installed Directories</segtitle>
304
305 <seglistitem>
306 <seg>None</seg>
307 <seg><application>Python</application>
308 <application>D-Bus</application> modules</seg>
309 <seg>/usr/lib/python&python-majorver;/site-packages/dbus and
310 /usr/share/doc/dbus-python-&dbus-python-version;</seg>
311 </seglistitem>
312 </segmentedlist>
313
314 </sect2>
315
316 <!-- Begin D-Bus Qt3 Bindings -->
317 <sect2 id="dbus-qt3" xreflabel="D-Bus Qt3 Bindings-&dbus-qt3-version;">
318 <title>D-Bus Qt3 Bindings</title>
319
320 <indexterm zone="dbus-qt3">
321 <primary sortas="a-dbus-qt3">D-Bus Qt3 Bindings</primary>
322 </indexterm>
323
324 <bridgehead renderas="sect3">Package Information</bridgehead>
325 <itemizedlist spacing="compact">
326 <listitem>
327 <para>Download (HTTP): <ulink url="&dbus-qt3-download-http;"/></para>
328 </listitem>
329 <listitem>
330 <para>Download (FTP): <ulink url="&dbus-qt3-download-ftp;"/></para>
331 </listitem>
332 <listitem>
333 <para>Download MD5 sum: &dbus-qt3-md5sum;</para>
334 </listitem>
335 <listitem>
336 <para>Download size: &dbus-qt3-size;</para>
337 </listitem>
338 <listitem>
339 <para>Estimated disk space required: &dbus-qt3-buildsize;</para>
340 </listitem>
341 <listitem>
342 <para>Estimated build time: &dbus-qt3-time;</para>
343 </listitem>
344 </itemizedlist>
345
346 <bridgehead renderas="sect3">D-Bus Qt3 Dependencies</bridgehead>
347
348 <bridgehead renderas="sect4">Required</bridgehead>
349 <para role="required"><xref linkend="dbus"/> and
350 <xref linkend="qt"/></para>
351
352 <!-- <bridgehead renderas="sect4">Recommended</bridgehead>
353 <para role="recommended"><xref linkend="pkgconfig"/></para> -->
354
355 <para condition="html" role="usernotes">User Notes:
356 <ulink url="&blfs-wiki;/dbus-qt3"/></para>
357
358 </sect2>
359
360 <sect2 role="installation">
361 <title>Installation of D-Bus Qt3 Bindings</title>
362
363 <para>Install <application>D-Bus Qt3 Bindings</application> by
364 running the following commands:</para>
365
366<screen><userinput>./configure --prefix=/usr &amp;&amp;
367make</userinput></screen>
368
369 <para>This package does not come with a test suite.</para>
370
371 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
372
373<screen role="root"><userinput>make install</userinput></screen>
374
375 </sect2>
376
377 <sect2 role="content">
378 <title>Contents</title>
379
380 <segmentedlist>
381 <segtitle>Installed Programs</segtitle>
382 <segtitle>Installed Library</segtitle>
383 <segtitle>Installed Directories</segtitle>
384
385 <seglistitem>
386 <seg>None</seg>
387 <seg>libdbus-qt-1.so</seg>
388 <seg>None</seg>
389 </seglistitem>
390 </segmentedlist>
391
392 <variablelist>
393 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
394 <?dbfo list-presentation="list"?>
395 <?dbhtml list-presentation="table"?>
396
397 <varlistentry id="libdbus-qt-1">
398 <term><filename class='libraryfile'>libdbus-qt-1.{so,a}</filename></term>
399 <listitem>
400 <para>contains <application>Qt3</application> interface functions
401 to the D-Bus API.</para>
402 <indexterm zone="dbus-qt3 libdbus-qt-1">
403 <primary sortas="c-libdbus-qt-1">libdbus-qt-1.{so,a}</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.