source: gnome/desktop/gnome-bluetooth.xml@ 6265cf16

gnome
Last change on this file since 6265cf16 was 6265cf16, checked in by Krejzi <krejzi@…>, 10 years ago

introduce gnome-desktop section.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/gnome@13444 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 7.6 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 gnome-bluetooth-download-http
8 "&gnome-download-http;/gnome-bluetooth/3.12/gnome-bluetooth-&gnome-bluetooth-version;.tar.xz">
9 <!ENTITY gnome-bluetooth-download-ftp
10 "&gnome-download-ftp;/gnome-bluetooth/3.12/gnome-bluetooth-&gnome-bluetooth-version;.tar.xz">
11 <!ENTITY gnome-bluetooth-md5sum "a3b0b6c2c542b3264cb0144a4efb3342">
12 <!ENTITY gnome-bluetooth-size "1.3 MB">
13 <!ENTITY gnome-bluetooth-buildsize "21 MB">
14 <!ENTITY gnome-bluetooth-time "0.2 SBU">
15]>
16
17<sect1 id="gnome-bluetooth" xreflabel="gnome-bluetooth-&gnome-bluetooth-version;">
18 <?dbhtml filename="gnome-bluetooth.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>gnome-bluetooth-&gnome-bluetooth-version;</title>
26
27 <indexterm zone="gnome-bluetooth">
28 <primary sortas="a-gnome-bluetooth">gnome-bluetooth</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to GNOME Bluetooth</title>
33
34 <para>
35 The <application>GNOME Bluetooth</application> package contains tools
36 for managing and manipulating Bluetooth devices using the
37 <application>GNOME</application> Desktop.
38 </para>
39
40 &lfs75_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&gnome-bluetooth-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&gnome-bluetooth-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &gnome-bluetooth-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &gnome-bluetooth-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &gnome-bluetooth-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &gnome-bluetooth-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">GNOME Bluetooth Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="glib2"/>,
81 <xref linkend="libnotify"/>, and
82 <xref linkend="gtk3"/>
83 </para>
84
85 <bridgehead renderas="sect4">Recommended</bridgehead>
86 <para role="recommended">
87 <xref linkend="gobject-introspection"/>, and
88 <xref linkend="nautilus-sendto"/>
89 </para>
90
91 <bridgehead renderas="sect4">Optional</bridgehead>
92 <para role="optional">
93 <xref linkend="geoclue"/>, and
94 <xref linkend="gtk-doc"/>
95 </para>
96
97 <bridgehead renderas="sect4">Required (Runtime)</bridgehead>
98 <para role="optional">
99 <xref linkend="bluez"/>, and
100 <xref linkend="systemd"/>
101 </para>
102
103 <para condition="html" role="usernotes">User Notes:
104 <ulink url="&blfs-wiki;/gnome-bluetooth"/>
105 </para>
106 </sect2>
107
108 <sect2 role="installation">
109 <title>Installation of GNOME Bluetooth</title>
110
111 <para>
112 Install <application>GNOME Bluetooth</application> by running the following
113 commands:
114 </para>
115
116<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
117make</userinput></screen>
118
119 <para>
120 This package does not come with a test suite.
121 </para>
122
123 <para>
124 Now, as the <systemitem class="username">root</systemitem> user:
125 </para>
126
127<screen role="root"><userinput>make install</userinput></screen>
128
129 <para>
130 For <application>GNOME Bluetooth</application> to work
131 as expected, users need to be allowed to write to
132 <filename>/dev/rfkill</filename>. Create a
133 <application>Udev</application> rule that will allow
134 normal users to write to <filename>/dev/rfkill</filename>
135 with the following command as the
136 <systemitem class="username">root</systemitem> user:
137 </para>
138
139<screen role="root"><userinput>cat &gt; /lib/udev/rules.d/61-gnome-bluetooth.rules &lt;&lt; "EOF"
140<literal># Get access to /dev/rfkill for users
141# See https://bugzilla.redhat.com/show_bug.cgi?id=514798
142#
143# Updated for udev &gt;= 154
144# http://bugs.debian.org/582188
145# https://bugzilla.redhat.com/show_bug.cgi?id=588660
146
147ENV{ACL_MANAGE}=="0", GOTO="gnome_bluetooth_end"
148ACTION!="add|change", GOTO="gnome_bluetooth_end"
149KERNEL=="rfkill", TAG+="udev-acl"
150LABEL="gnome_bluetooth_end"</literal>
151EOF</userinput></screen>
152
153 </sect2>
154
155 <sect2 role="commands">
156 <title>Command Explanations</title>
157
158 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
159 href="../../xincludes/gtk-doc-rebuild.xml"/>
160
161 </sect2>
162
163 <sect2 role="content">
164 <title>Contents</title>
165
166 <segmentedlist>
167 <segtitle>Installed Programs</segtitle>
168 <segtitle>Installed Library</segtitle>
169 <segtitle>Installed Directories</segtitle>
170
171 <seglistitem>
172 <seg>
173 bluetooth-applet, bluetooth-sendto and bluetooth-wizard
174 </seg>
175 <seg>
176 libgnome-bluetooth.so
177 </seg>
178 <seg>
179 /usr/include/gnome-bluetooth,
180 /usr/lib/gnome-bluetooth,
181 /usr/share/gnome-bluetooth,
182 /usr/share/gtk-doc/html/gnome-bluetooth and
183 /usr/share/help/*/gnome-bluetooth
184 </seg>
185 </seglistitem>
186 </segmentedlist>
187
188 <variablelist>
189 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
190 <?dbfo list-presentation="list"?>
191 <?dbhtml list-presentation="table"?>
192
193 <varlistentry id="bluetooth-applet">
194 <term><command>bluetooth-applet</command></term>
195 <listitem>
196 <para>
197 is a <application>GNOME</application> applet for prompting the
198 user for a Bluetooth passkey (PIN).
199 </para>
200 <indexterm zone="gnome-bluetooth bluetooth-applet">
201 <primary sortas="b-bluetooth-applet">bluetooth-applet</primary>
202 </indexterm>
203 </listitem>
204 </varlistentry>
205
206 <varlistentry id="bluetooth-sendto">
207 <term><command>bluetooth-sendto</command></term>
208 <listitem>
209 <para>
210 is a <application>GTK+</application> application for transferring
211 files over Bluetooth.
212 </para>
213 <indexterm zone="gnome-bluetooth bluetooth-sendto">
214 <primary sortas="b-bluetooth-sendto">bluetooth-sendto</primary>
215 </indexterm>
216 </listitem>
217 </varlistentry>
218
219 <varlistentry id="bluetooth-wizard">
220 <term><command>bluetooth-wizard</command></term>
221 <listitem>
222 <para>
223 is a <application>GTK+</application> wizard for setting up
224 devices with the Linux Bluetooth stack.
225 </para>
226 <indexterm zone="gnome-bluetooth bluetooth-wizard">
227 <primary sortas="b-bluetooth-wizard">bluetooth-wizard</primary>
228 </indexterm>
229 </listitem>
230 </varlistentry>
231
232 <varlistentry id="libgnome-bluetooth">
233 <term><filename class="libraryfile">libgnome-bluetooth.so</filename></term>
234 <listitem>
235 <para>
236 contains the <application>GNOME Bluetooth</application> API
237 functions.
238 </para>
239 <indexterm zone="gnome-bluetooth libgnome-bluetooth">
240 <primary sortas="c-libgnome-bluetooth">libgnome-bluetooth.so</primary>
241 </indexterm>
242 </listitem>
243 </varlistentry>
244
245 </variablelist>
246
247 </sect2>
248
249</sect1>
Note: See TracBrowser for help on using the repository browser.