source: general/genlib/dbus-bindings.xml@ 4b49a6da

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 4b49a6da was e44f2a3b, checked in by Randy McMurchy <randy@…>, 15 years ago

Updated to D-BUS Python Bindings-0.83.0

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@7794 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 13.8 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 "86ea60ba2118a1b9deafe8257f6a6a1a">
10 <!ENTITY dbus-glib-size "688 KB">
11 <!ENTITY dbus-glib-buildsize "11 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 <bridgehead renderas="sect3">Package Information</bridgehead>
86 <itemizedlist spacing="compact">
87 <listitem>
88 <para>Download (HTTP): <ulink url="&dbus-glib-download-http;"/></para>
89 </listitem>
90 <listitem>
91 <para>Download (FTP): <ulink url="&dbus-glib-download-ftp;"/></para>
92 </listitem>
93 <listitem>
94 <para>Download MD5 sum: &dbus-glib-md5sum;</para>
95 </listitem>
96 <listitem>
97 <para>Download size: &dbus-glib-size;</para>
98 </listitem>
99 <listitem>
100 <para>Estimated disk space required: &dbus-glib-buildsize;</para>
101 </listitem>
102 <listitem>
103 <para>Estimated build time: &dbus-glib-time;</para>
104 </listitem>
105 </itemizedlist>
106
107 <bridgehead renderas="sect3">D-Bus GLib Dependencies</bridgehead>
108
109 <bridgehead renderas="sect4">Required</bridgehead>
110 <para role="required"><xref linkend="dbus"/>,
111 <xref linkend="glib2"/>, and
112 <xref linkend="expat"/></para>
113
114 <bridgehead renderas="sect4">Optional to Build the API Documentation</bridgehead>
115 <para role="required"><xref linkend="doxygen"/></para>
116
117 <para condition="html" role="usernotes">User Notes:
118 <ulink url="&blfs-wiki;/dbus-glib"/></para>
119
120 </sect2>
121
122 <sect2 role="installation">
123 <title>Installation of D-Bus GLib Bindings</title>
124
125 <para>Install <application>D-Bus GLib Bindings</application> by
126 running the following commands:</para>
127
128<screen><userinput>./configure --prefix=/usr &amp;&amp;
129make</userinput></screen>
130
131 <para>The <option>--enable-doxygen-docs</option> parameter does not work
132 properly. If you have <application>Doxygen</application> installed and you
133 wish to build the API documentation, issue
134 <command>doxygen</command>.</para>
135
136 <para>To test the results, issue: <command>make check</command>. Note that
137 more comprehensive tests can be run by following the same method used in
138 <application>D-BUS</application> instructions, which requires building the
139 package twice.</para>
140
141 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
142
143<screen role="root"><userinput>make install</userinput></screen>
144
145 <para>If you built the API documentation, install it by issuing the
146 following commands as the <systemitem class="username">root</systemitem>
147 user:</para>
148
149<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/dbus-glib-&dbus-glib-version;/api \
150 /usr/share/man/man3dbus &amp;&amp;
151install -v -m644 doc/api/html/* \
152 /usr/share/doc/dbus-glib-&dbus-glib-version;/api &amp;&amp;
153install -v -m644 doc/api/man/man3dbus/* \
154 /usr/share/man/man3dbus</userinput></screen>
155
156 </sect2>
157
158 <sect2 role="commands">
159 <title>Command Explanations</title>
160
161 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
162 href="../../xincludes/gtk-doc-rebuild.xml"/>
163
164 </sect2>
165
166 <sect2 role="content">
167 <title>Contents</title>
168
169 <segmentedlist>
170 <segtitle>Installed Program</segtitle>
171 <segtitle>Installed Library</segtitle>
172 <segtitle>Installed Directories</segtitle>
173
174 <seglistitem>
175 <seg>dbus-binding-tool</seg>
176 <seg>libdbus-glib-1.{so,a}</seg>
177 <seg>/usr/share/gtk-doc/html/dbus-glib and optionally
178 /usr/share/doc/dbus-glib-&dbus-glib-version;/api</seg>
179 </seglistitem>
180 </segmentedlist>
181
182 <variablelist>
183 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
184 <?dbfo list-presentation="list"?>
185 <?dbhtml list-presentation="table"?>
186
187 <varlistentry id="glib-dbus-binding-tool">
188 <term><command>dbus-binding-tool</command></term>
189 <listitem>
190 <para>is a tool used to interface with the D-Bus API.</para>
191 <indexterm zone="dbus-glib glib-dbus-binding-tool">
192 <primary sortas="b-dbus-binding-tool">dbus-binding-tool</primary>
193 </indexterm>
194 </listitem>
195 </varlistentry>
196
197 <varlistentry id="libdbus-glib-1">
198 <term><filename class='libraryfile'>libdbus-glib-1.{so,a}</filename></term>
199 <listitem>
200 <para>contains <application>GLib</application> interface functions
201 to the D-Bus API.</para>
202 <indexterm zone="dbus-glib libdbus-glib-1">
203 <primary sortas="c-libdbus-glib-1">libdbus-glib-1.{so,a}</primary>
204 </indexterm>
205 </listitem>
206 </varlistentry>
207
208 </variablelist>
209
210 </sect2>
211
212 <!-- Begin D-Bus Python Bindings -->
213 <sect2 id="dbus-python" xreflabel="D-Bus Python Bindings-&dbus-python-version;">
214 <title>D-Bus Python Bindings</title>
215
216 <indexterm zone="dbus-python">
217 <primary sortas="a-dbus-python">D-Bus Python Bindings</primary>
218 </indexterm>
219
220 <bridgehead renderas="sect3">Package Information</bridgehead>
221 <itemizedlist spacing="compact">
222 <listitem>
223 <para>Download (HTTP): <ulink url="&dbus-python-download-http;"/></para>
224 </listitem>
225 <listitem>
226 <para>Download (FTP): <ulink url="&dbus-python-download-ftp;"/></para>
227 </listitem>
228 <listitem>
229 <para>Download MD5 sum: &dbus-python-md5sum;</para>
230 </listitem>
231 <listitem>
232 <para>Download size: &dbus-python-size;</para>
233 </listitem>
234 <listitem>
235 <para>Estimated disk space required: &dbus-python-buildsize;</para>
236 </listitem>
237 <listitem>
238 <para>Estimated build time: &dbus-python-time;</para>
239 </listitem>
240 </itemizedlist>
241
242 <bridgehead renderas="sect3">D-Bus Python Dependencies</bridgehead>
243
244 <bridgehead renderas="sect4">Required</bridgehead>
245 <para role="required"><xref linkend="python"/> and
246 <xref linkend="dbus-glib"/></para>
247
248 <bridgehead renderas="sect4">Optional</bridgehead>
249 <para role="optional"><ulink url="&gnome-download-http;/pygobject">PyGObject</ulink>
250 (required to run the test suite)</para>
251
252 <bridgehead renderas="sect4">Optional
253 (Required to build the API and HTML Documentation)</bridgehead>
254 <para role="optional"><ulink url="http://epydoc.sourceforge.net/">Epydoc</ulink>
255 and <ulink url="http://docutils.sourceforge.net/">Docutils</ulink></para>
256
257 <para condition="html" role="usernotes">User Notes:
258 <ulink url="&blfs-wiki;/dbus-python"/></para>
259
260 </sect2>
261
262 <sect2 role="installation">
263 <title>Installation of D-Bus Python Bindings</title>
264
265 <para>Install <application>D-Bus Python Bindings</application> by
266 running the following commands:</para>
267
268<screen><userinput>./configure --prefix=/usr \
269 --docdir=/usr/share/doc/dbus-python-&dbus-python-version; &amp;&amp;
270make</userinput></screen>
271
272 <para>To test the results, issue: <command>make check</command>. Note you
273 must have <application>PyGObject</application> installed.</para>
274
275 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
276
277<screen role="root"><userinput>make install</userinput></screen>
278
279 <para>If you built the API documentation, install it by issuing the
280 following commands as the <systemitem class="username">root</systemitem>
281 user:</para>
282
283<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/dbus-python-&dbus-python-version;/api &amp;&amp;
284install -v -m644 api/* \
285 /usr/share/doc/dbus-python-&dbus-python-version;/api</userinput></screen>
286
287 </sect2>
288
289 <sect2 role="content">
290 <title>Contents</title>
291
292 <segmentedlist>
293 <segtitle>Installed Programs</segtitle>
294 <segtitle>Installed Libraries</segtitle>
295 <segtitle>Installed Directories</segtitle>
296
297 <seglistitem>
298 <seg>None</seg>
299 <seg><application>Python</application>
300 <application>D-Bus</application> modules</seg>
301 <seg>/usr/lib/python&python-majorver;/site-packages/dbus and
302 /usr/share/doc/dbus-python-&dbus-python-version;</seg>
303 </seglistitem>
304 </segmentedlist>
305
306 </sect2>
307
308 <!-- Begin D-Bus Qt3 Bindings -->
309 <sect2 id="dbus-qt3" xreflabel="D-Bus Qt3 Bindings-&dbus-qt3-version;">
310 <title>D-Bus Qt3 Bindings</title>
311
312 <indexterm zone="dbus-qt3">
313 <primary sortas="a-dbus-qt3">D-Bus Qt3 Bindings</primary>
314 </indexterm>
315
316 <bridgehead renderas="sect3">Package Information</bridgehead>
317 <itemizedlist spacing="compact">
318 <listitem>
319 <para>Download (HTTP): <ulink url="&dbus-qt3-download-http;"/></para>
320 </listitem>
321 <listitem>
322 <para>Download (FTP): <ulink url="&dbus-qt3-download-ftp;"/></para>
323 </listitem>
324 <listitem>
325 <para>Download MD5 sum: &dbus-qt3-md5sum;</para>
326 </listitem>
327 <listitem>
328 <para>Download size: &dbus-qt3-size;</para>
329 </listitem>
330 <listitem>
331 <para>Estimated disk space required: &dbus-qt3-buildsize;</para>
332 </listitem>
333 <listitem>
334 <para>Estimated build time: &dbus-qt3-time;</para>
335 </listitem>
336 </itemizedlist>
337
338 <bridgehead renderas="sect3">D-Bus Qt3 Dependencies</bridgehead>
339
340 <bridgehead renderas="sect4">Required</bridgehead>
341 <para role="required"><xref linkend="dbus"/> and
342 <xref linkend="qt"/></para>
343
344 <bridgehead renderas="sect4">Recommended</bridgehead>
345 <para role="recommended"><xref linkend="pkgconfig"/></para>
346
347 <para condition="html" role="usernotes">User Notes:
348 <ulink url="&blfs-wiki;/dbus-qt3"/></para>
349
350 </sect2>
351
352 <sect2 role="installation">
353 <title>Installation of D-Bus Qt3 Bindings</title>
354
355 <para>Install <application>D-Bus Qt3 Bindings</application> by
356 running the following commands:</para>
357
358<screen><userinput>./configure --prefix=/usr &amp;&amp;
359make</userinput></screen>
360
361 <para>This package does not come with a test suite.</para>
362
363 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
364
365<screen role="root"><userinput>make install</userinput></screen>
366
367 </sect2>
368
369 <sect2 role="content">
370 <title>Contents</title>
371
372 <segmentedlist>
373 <segtitle>Installed Programs</segtitle>
374 <segtitle>Installed Library</segtitle>
375 <segtitle>Installed Directories</segtitle>
376
377 <seglistitem>
378 <seg>None</seg>
379 <seg>libdbus-qt-1.so</seg>
380 <seg>None</seg>
381 </seglistitem>
382 </segmentedlist>
383
384 <variablelist>
385 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
386 <?dbfo list-presentation="list"?>
387 <?dbhtml list-presentation="table"?>
388
389 <varlistentry id="libdbus-qt-1">
390 <term><filename class='libraryfile'>libdbus-qt-1.{so,a}</filename></term>
391 <listitem>
392 <para>contains <application>Qt3</application> interface functions
393 to the D-Bus API.</para>
394 <indexterm zone="dbus-qt3 libdbus-qt-1">
395 <primary sortas="c-libdbus-qt-1">libdbus-qt-1.{so,a}</primary>
396 </indexterm>
397 </listitem>
398 </varlistentry>
399
400 </variablelist>
401
402 </sect2>
403
404</sect1>
Note: See TracBrowser for help on using the repository browser.