source: gnome-systemd/desktop/gnome-bluetooth.xml@ 09140ef

7.6-blfs 7.6-systemd kde5-14269 kde5-14686 systemd-13485
Last change on this file since 09140ef was 09140ef, checked in by Krejzi <krejzi@…>, 10 years ago

Import Christopher's GNOME work into systemd branch.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@13549 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 7.5 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="libnotify"/>
81 </para>
82
83 <bridgehead renderas="sect4">Recommended</bridgehead>
84 <para role="recommended">
85 <xref linkend="gobject-introspection"/>, and
86 <xref linkend="nautilus-sendto"/>
87 </para>
88
89 <bridgehead renderas="sect4">Optional</bridgehead>
90 <para role="optional">
91 <xref linkend="geoclue"/>, and
92 <xref linkend="gtk-doc"/>
93 </para>
94
95 <bridgehead renderas="sect4">Required (Runtime)</bridgehead>
96 <para role="optional">
97 <xref linkend="bluez"/>, and
98 <xref linkend="systemd"/>
99 </para>
100
101 <para condition="html" role="usernotes">User Notes:
102 <ulink url="&blfs-wiki;/gnome-bluetooth"/>
103 </para>
104 </sect2>
105
106 <sect2 role="installation">
107 <title>Installation of GNOME Bluetooth</title>
108
109 <para>
110 Install <application>GNOME Bluetooth</application> by running the following
111 commands:
112 </para>
113
114<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
115make</userinput></screen>
116
117 <para>
118 This package does not come with a test suite.
119 </para>
120
121 <para>
122 Now, as the <systemitem class="username">root</systemitem> user:
123 </para>
124
125<screen role="root"><userinput>make install</userinput></screen>
126
127 <para>
128 For <application>GNOME Bluetooth</application> to work
129 as expected, users need to be allowed to write to
130 <filename>/dev/rfkill</filename>. Create a
131 <application>Udev</application> rule that will allow
132 normal users to write to <filename>/dev/rfkill</filename>
133 with the following command as the
134 <systemitem class="username">root</systemitem> user:
135 </para>
136
137<screen role="root"><userinput>cat &gt; /lib/udev/rules.d/61-gnome-bluetooth.rules &lt;&lt; "EOF"
138<literal># Get access to /dev/rfkill for users
139# See https://bugzilla.redhat.com/show_bug.cgi?id=514798
140#
141# Updated for udev &gt;= 154
142# http://bugs.debian.org/582188
143# https://bugzilla.redhat.com/show_bug.cgi?id=588660
144
145ENV{ACL_MANAGE}=="0", GOTO="gnome_bluetooth_end"
146ACTION!="add|change", GOTO="gnome_bluetooth_end"
147KERNEL=="rfkill", TAG+="udev-acl"
148LABEL="gnome_bluetooth_end"</literal>
149EOF</userinput></screen>
150
151 </sect2>
152
153 <sect2 role="commands">
154 <title>Command Explanations</title>
155
156 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
157 href="../../xincludes/gtk-doc-rebuild.xml"/>
158
159 </sect2>
160
161 <sect2 role="content">
162 <title>Contents</title>
163
164 <segmentedlist>
165 <segtitle>Installed Programs</segtitle>
166 <segtitle>Installed Library</segtitle>
167 <segtitle>Installed Directories</segtitle>
168
169 <seglistitem>
170 <seg>
171 bluetooth-applet, bluetooth-sendto and bluetooth-wizard
172 </seg>
173 <seg>
174 libgnome-bluetooth.so
175 </seg>
176 <seg>
177 /usr/include/gnome-bluetooth,
178 /usr/lib/gnome-bluetooth,
179 /usr/share/gnome-bluetooth,
180 /usr/share/gtk-doc/html/gnome-bluetooth and
181 /usr/share/help/*/gnome-bluetooth
182 </seg>
183 </seglistitem>
184 </segmentedlist>
185
186 <variablelist>
187 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
188 <?dbfo list-presentation="list"?>
189 <?dbhtml list-presentation="table"?>
190
191 <varlistentry id="bluetooth-applet">
192 <term><command>bluetooth-applet</command></term>
193 <listitem>
194 <para>
195 is a <application>GNOME</application> applet for prompting the
196 user for a Bluetooth passkey (PIN).
197 </para>
198 <indexterm zone="gnome-bluetooth bluetooth-applet">
199 <primary sortas="b-bluetooth-applet">bluetooth-applet</primary>
200 </indexterm>
201 </listitem>
202 </varlistentry>
203
204 <varlistentry id="bluetooth-sendto">
205 <term><command>bluetooth-sendto</command></term>
206 <listitem>
207 <para>
208 is a <application>GTK+</application> application for transferring
209 files over Bluetooth.
210 </para>
211 <indexterm zone="gnome-bluetooth bluetooth-sendto">
212 <primary sortas="b-bluetooth-sendto">bluetooth-sendto</primary>
213 </indexterm>
214 </listitem>
215 </varlistentry>
216
217 <varlistentry id="bluetooth-wizard">
218 <term><command>bluetooth-wizard</command></term>
219 <listitem>
220 <para>
221 is a <application>GTK+</application> wizard for setting up
222 devices with the Linux Bluetooth stack.
223 </para>
224 <indexterm zone="gnome-bluetooth bluetooth-wizard">
225 <primary sortas="b-bluetooth-wizard">bluetooth-wizard</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 <varlistentry id="libgnome-bluetooth">
231 <term><filename class="libraryfile">libgnome-bluetooth.so</filename></term>
232 <listitem>
233 <para>
234 contains the <application>GNOME Bluetooth</application> API
235 functions.
236 </para>
237 <indexterm zone="gnome-bluetooth libgnome-bluetooth">
238 <primary sortas="c-libgnome-bluetooth">libgnome-bluetooth.so</primary>
239 </indexterm>
240 </listitem>
241 </varlistentry>
242
243 </variablelist>
244
245 </sect2>
246
247</sect1>
Note: See TracBrowser for help on using the repository browser.