glfs/archive/gnome/gnome-bluetooth.xml
Pierre Labastie e0ac6b072d A few typo corrections, even in archive, in case somebody
wants to put a file back in the book. From misspellings-2.0c.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@13011 af4574ff-66df-0310-9fd7-8a98e5e911e0
2014-04-30 13:04:53 +00:00

251 lines
7.6 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY gnome-bluetooth-download-http
"&gnome-download-http;/gnome-bluetooth/3.6/gnome-bluetooth-&gnome-bluetooth-version;.tar.xz">
<!ENTITY gnome-bluetooth-download-ftp
"&gnome-download-ftp;/gnome-bluetooth/3.6/gnome-bluetooth-&gnome-bluetooth-version;.tar.xz">
<!ENTITY gnome-bluetooth-md5sum "a3b0b6c2c542b3264cb0144a4efb3342">
<!ENTITY gnome-bluetooth-size "1.3 MB">
<!ENTITY gnome-bluetooth-buildsize "21 MB">
<!ENTITY gnome-bluetooth-time "0.2 SBU">
]>
<sect1 id="gnome-bluetooth" xreflabel="gnome-bluetooth-&gnome-bluetooth-version;">
<?dbhtml filename="gnome-bluetooth.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>gnome-bluetooth-&gnome-bluetooth-version;</title>
<indexterm zone="gnome-bluetooth">
<primary sortas="a-gnome-bluetooth">gnome-bluetooth</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to GNOME Bluetooth</title>
<para>
The <application>GNOME Bluetooth</application> package contains tools
for managing and manipulating Bluetooth devices using the
<application>GNOME</application> Desktop.
</para>
&lfs72_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&gnome-bluetooth-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&gnome-bluetooth-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &gnome-bluetooth-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &gnome-bluetooth-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &gnome-bluetooth-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &gnome-bluetooth-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">GNOME Bluetooth Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="libnotify"/> and
<xref linkend="yelp-xsl"/>
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="gobject-introspection"/> and
<xref linkend="nautilus-sendto"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="geoclue"/> and
<xref linkend="gtk-doc"/>
</para>
<bridgehead renderas="sect4">Required (Runtime)</bridgehead>
<para role="optional">
<xref linkend="bluez"/>,
<xref linkend="consolekit"/> and
<xref linkend="obexd"/>
(Required for bluetooth-sendto to work)
</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gnome-bluetooth"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of GNOME Bluetooth</title>
<para>
Install <application>GNOME Bluetooth</application> by running the following
commands:
</para>
<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
<para>
For <application>GNOME Bluetooth</application> to work
as expected, users need to be allowed to write to
<filename>/dev/rfkill</filename>. Create a
<application>Udev</application> rule that will allow
normal users to write to <filename>/dev/rfkill</filename>
with the following command as the
<systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>cat &gt; /lib/udev/rules.d/61-gnome-bluetooth.rules &lt;&lt; "EOF"
<literal># Get access to /dev/rfkill for users
# See https://bugzilla.redhat.com/show_bug.cgi?id=514798
#
# Updated for udev &gt;= 154
# http://bugs.debian.org/582188
# https://bugzilla.redhat.com/show_bug.cgi?id=588660
ENV{ACL_MANAGE}=="0", GOTO="gnome_bluetooth_end"
ACTION!="add|change", GOTO="gnome_bluetooth_end"
KERNEL=="rfkill", TAG+="udev-acl"
LABEL="gnome_bluetooth_end"</literal>
EOF</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
bluetooth-applet, bluetooth-sendto and bluetooth-wizard
</seg>
<seg>
libgnome-bluetooth.so
</seg>
<seg>
/usr/include/gnome-bluetooth,
/usr/lib/gnome-bluetooth,
/usr/share/gnome-bluetooth,
/usr/share/gtk-doc/html/gnome-bluetooth and
/usr/share/help/*/gnome-bluetooth
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="bluetooth-applet">
<term><command>bluetooth-applet</command></term>
<listitem>
<para>
is a <application>GNOME</application> applet for prompting the
user for a Bluetooth passkey (PIN).
</para>
<indexterm zone="gnome-bluetooth bluetooth-applet">
<primary sortas="b-bluetooth-applet">bluetooth-applet</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="bluetooth-sendto">
<term><command>bluetooth-sendto</command></term>
<listitem>
<para>
is a <application>GTK+</application> application for transferring
files over Bluetooth.
</para>
<indexterm zone="gnome-bluetooth bluetooth-sendto">
<primary sortas="b-bluetooth-sendto">bluetooth-sendto</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="bluetooth-wizard">
<term><command>bluetooth-wizard</command></term>
<listitem>
<para>
is a <application>GTK+</application> wizard for setting up
devices with the Linux Bluetooth stack.
</para>
<indexterm zone="gnome-bluetooth bluetooth-wizard">
<primary sortas="b-bluetooth-wizard">bluetooth-wizard</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libgnome-bluetooth">
<term><filename class="libraryfile">libgnome-bluetooth.so</filename></term>
<listitem>
<para>
contains the <application>GNOME Bluetooth</application> API
functions.
</para>
<indexterm zone="gnome-bluetooth libgnome-bluetooth">
<primary sortas="c-libgnome-bluetooth">libgnome-bluetooth.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>