[gnome-user-docs] Update *bluetooth-* for 3.10
- From: Michael Hill <mdhill src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnome-user-docs] Update *bluetooth-* for 3.10
- Date: Sat, 9 Nov 2013 20:57:38 +0000 (UTC)
commit 3754ece1ddbf6f1d13312ec159cb3b183376887b
Author: Michael Hill <mdhill gnome org>
Date: Sat Nov 9 15:55:18 2013 -0500
Update *bluetooth-* for 3.10
gnome-help/C/bluetooth-connect-device.page | 84 +++++++++++++++++-------
gnome-help/C/bluetooth-problem-connecting.page | 50 ++++++++++----
gnome-help/C/bluetooth-send-file.page | 65 +++++++-----------
gnome-help/C/bluetooth-turn-on-off.page | 66 ++++++++++++++----
gnome-help/C/bluetooth-visibility.page | 13 +++-
gnome-help/C/bluetooth.page | 6 +-
gnome-help/C/sharing-bluetooth.page | 1 +
7 files changed, 189 insertions(+), 96 deletions(-)
---
diff --git a/gnome-help/C/bluetooth-connect-device.page b/gnome-help/C/bluetooth-connect-device.page
index 7751926..bd8f64e 100644
--- a/gnome-help/C/bluetooth-connect-device.page
+++ b/gnome-help/C/bluetooth-connect-device.page
@@ -1,4 +1,5 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
xmlns:if="http://projectmallard.org/if/1.0/";
type="guide" style="task" version="1.0 if/1.0"
id="bluetooth-connect-device">
@@ -8,24 +9,25 @@
<link type="seealso" xref="sharing-bluetooth"/>
<revision pkgversion="3.8.2" version="0.2" date="2013-05-16" status="review"/>
+ <revision pkgversion="3.10" version="0.3" date="2013-11-09" status="review"/>
<desc>Pair Bluetooth devices.</desc>
<credit type="author">
<name>Jim Campbell</name>
- <email>jwcampbell gmail com</email>
+ <email its:translate="no">jwcampbell gmail com</email>
</credit>
<credit type="author">
<name>Paul W. Frields</name>
- <email>stickster gmail com</email>
+ <email its:translate="no">stickster gmail com</email>
</credit>
<credit type="author">
<name>Shaun McCance</name>
- <email>shaunm gnome org</email>
+ <email its:translate="no">shaunm gnome org</email>
</credit>
<credit type="editor">
<name>Michael Hill</name>
- <email>mdhillca gmail com</email>
+ <email its:translate="no">mdhillca gmail com</email>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
</info>
@@ -45,43 +47,79 @@
<item>
<if:choose>
<if:when test="platform:unity">
- <p>Click the Bluetooth icon in the menu bar and select <gui>Set Up New Device</gui>.</p>
+ <p>Click the Bluetooth icon in the menu bar and select <gui>Set Up
+ New Device</gui>.</p>
</if:when>
- <p>Click the Bluetooth icon on the top bar and select <gui>Set up a New Device</gui>.</p>
- </if:choose>
+ <p>Open the <gui xref="shell-terminology">Activities</gui> overview and
+ start typing <gui>Bluetooth</gui>.</p>
+ </if:choose>
</item>
<item>
- <p>Make the other Bluetooth device <link xref="bluetooth-visibility">discoverable or visible</link>
- and place it within 10 meters (about 33 feet) of your computer. Click <gui>Continue</gui>. Your
- computer will begin searching for devices.</p>
+ <if:choose>
+ <if:when test="platform:gnome-shell">
+ <p>Click on <gui>Bluetooth</gui> to open the panel.</p>
+ </if:when>
+ </if:choose>
</item>
<item>
- <p>If there are too many devices listed, use the <gui>Device type</gui> drop-down to display only a
single type of device in the list.</p>
+ <p>Make the other Bluetooth device
+ <link xref="bluetooth-visibility">discoverable or visible</link> and
+ place it within 10 meters (about 33 feet) of your computer.</p>
</item>
<item>
- <p>Click <gui>PIN options</gui> to set how a PIN will be delivered to the other device.</p>
+ <p>Click <key>+</key> below the <gui>Devices</gui> list. The
+ <gui>Bluetooth New Device Setup</gui> panel will open and your computer
+ will begin searching for devices.</p>
+ </item>
+ <item>
+ <p>Select a device in the <gui>Device</gui> list. If there are too many
+ devices listed, use the <gui>Device type</gui> drop-down to display only
+ a single type of device in the list.</p>
+ </item>
+ <item>
+ <p>Click <gui>PIN options</gui> to set how a PIN will be delivered to the
+ other device.</p>
<note>
- <p>The automatic PIN setting will use a six-digit numerical code. A device with no input keys or
screen, such as a mouse or headset, may require a specific PIN such as 0000, or no PIN at all. Check your
device's manual for the proper setting.</p>
+ <p>The automatic PIN setting will use a six-digit numerical code. A
+ device with no input keys or screen, such as a mouse or headset, may
+ require a specific PIN such as 0000, or no PIN at all. Check your
+ device's manual for the proper setting.</p>
</note>
- <p>Choose an appropriate PIN setting for your device, then click <gui>Close</gui>.</p>
+ <p>Choose an appropriate PIN setting for your device, then click
+ <gui>Close</gui>.</p>
</item>
<item>
- <p>Click <gui>Continue</gui> to proceed. If you did not choose a preset PIN, the PIN will be
displayed on the screen.</p>
+ <p>Click <gui>Continue</gui> to proceed. If you did not choose a preset
+ PIN, the PIN will be displayed on the screen.</p>
</item>
<item>
- <p>If required, confirm the PIN on your other device. The device should show you
- the PIN you see on your computer screen, or may prompt you to enter the PIN.
- Confirm the PIN on the device, then click <gui>Matches</gui>.</p>
- <p>You need to finish your entry within about 20 seconds on most devices, or the
- connection will not be completed. If that happens, return to the device list and
- start again.</p>
+ <p>If required, confirm the PIN on your other device. The device should
+ show you the PIN you see on your computer screen, or may prompt you to
+ enter the PIN. Confirm the PIN on the device, then click
+ <gui>Matches</gui>.</p>
+ <p>You need to finish your entry within about 20 seconds on most devices,
+ or the connection will not be completed. If that happens, return to the
+ device list and start again.</p>
+ <p>A message appears when the connection successfully completes. Click
+ <gui>Close</gui>.</p>
</item>
<item>
- <p>A message appears when the connection successfully completes. Click <gui>Close</gui>.</p>
+ <p>The <gui>Setup Summary</gui> appears when the connection successfully
+ completes. It may display additional options applicable to the type of
+ device you're connecting. Select the desired options and click
+ <gui>Quit</gui>.</p>
</item>
</steps>
- <p>You can <link xref="bluetooth-remove-connection">remove a Bluetooth connection</link> later if
desired.</p>
+ <comment>
+ <cite date="2013-11-09" href="mailto:mdhillca gmail com">mdhill</cite>
+ <p>Detail the possible options in the Setup Summary. Also elaborate on
+ bluetooth network connections and system status menu controls.</p>
+ </comment>
+
+ <p>You can
+ <link xref="bluetooth-remove-connection">remove a Bluetooth connection</link>
+ later if desired.</p>
<note style="tip">
<p>To control access to your shared files, refer to the
diff --git a/gnome-help/C/bluetooth-problem-connecting.page b/gnome-help/C/bluetooth-problem-connecting.page
index 6a79615..c8e26fb 100644
--- a/gnome-help/C/bluetooth-problem-connecting.page
+++ b/gnome-help/C/bluetooth-problem-connecting.page
@@ -1,4 +1,5 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
xmlns:if="http://projectmallard.org/if/1.0/";
type="guide" style="problem" version="1.0 if/1.0"
id="bluetooth-problem-connecting">
@@ -8,20 +9,26 @@
<link type="seealso" xref="hardware-driver"/>
<revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+ <revision pkgversion="3.10" version="0.2" date="2013-11-09" status="review"/>
- <desc>The adapter could be turned off or may not have drivers, or Bluetooth might be disabled or
blocked.</desc>
+ <desc>The adapter could be turned off or may not have drivers, or Bluetooth
+ might be disabled or blocked.</desc>
<credit type="author">
<name>Phil Bull</name>
- <email>philbull gmail com</email>
+ <email its:translate="no">philbull gmail com</email>
+ </credit>
+ <credit type="editor">
+ <name>Michael Hill</name>
+ <email its:translate="no">mdhillca gmail com</email>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
</info>
<title>I can't connect my Bluetooth device</title>
-<p>There are a number of reasons why you may not be able to connect to a Bluetooth device,
-such as a phone or headset.</p>
+<p>There are a number of reasons why you may not be able to connect to a
+Bluetooth device, such as a phone or headset.</p>
<terms>
<item>
@@ -42,22 +49,35 @@ such as a phone or headset.</p>
<title>Adapter not switched on</title>
<if:choose>
<if:when test="platform:unity">
- <p>Make sure that your Bluetooth adapter is switched on. Click the Bluetooth
- icon in the <gui>menu bar</gui> and check that it's not <link
xref="bluetooth-turn-on-off">disabled</link>.</p>
+ <p>Make sure that your Bluetooth adapter is switched on. Click the
+ Bluetooth icon in the <gui>menu bar</gui> and check that it's not
+ <link xref="bluetooth-turn-on-off">disabled</link>.</p>
</if:when>
- <p>Make sure that your Bluetooth adapter is switched on. Click the Bluetooth
- icon on the top bar and check that it's not <link xref="bluetooth-turn-on-off">disabled</link>.</p>
+ <p>Make sure that your Bluetooth adapter is switched on. Open the
+ Bluetooth panel and check that it's not
+ <link xref="bluetooth-turn-on-off">disabled</link>.</p>
</if:choose>
</item>
<item>
<title>Device Bluetooth connection switched off</title>
- <p>Check that Bluetooth is turned on on the device you're trying to connect to. For example, if you're
trying to connect to a phone, make sure that it's not in airplane mode.</p>
- </item>
-
- <item>
- <title>No Bluetooth adapter in your computer</title>
- <p>Many computers do not have Bluetooth adapters. You can buy an adapter if you want to use Bluetooth.</p>
- </item>
+ <p>Check that Bluetooth is turned on on the device you're trying to connect
+ to, and that it is
+ <link xref="bluetooth-visibility">discoverable or visible</link>. For
+ example, if you're trying to connect to a phone, make sure that it's not in
+ airplane mode.</p>
+ </item>
+ <item>
+ <title>No Bluetooth adapter in your computer</title>
+ <p>Many computers do not have Bluetooth adapters. You can buy an adapter if
+ you want to use Bluetooth.</p>
+ </item>
</terms>
+ <comment>
+ <cite date="2013-11-09" href="mailto:mdhillca gmail com">mdhill</cite>
+ <p>Add link to shell-terminology definition of system status *area* of top
+ bar when it has been written, explain that if your network connection is
+ through a bluetooth device it will show up in the system status *menu*.</p>
+ </comment>
+
</page>
diff --git a/gnome-help/C/bluetooth-send-file.page b/gnome-help/C/bluetooth-send-file.page
index b43194f..321ac5e 100644
--- a/gnome-help/C/bluetooth-send-file.page
+++ b/gnome-help/C/bluetooth-send-file.page
@@ -1,4 +1,5 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
xmlns:if="http://projectmallard.org/if/1.0/";
type="guide" style="task" version="1.0 if/1.0"
id="bluetooth-send-file">
@@ -9,26 +10,27 @@
<link type="seealso" xref="files-share"/>
<revision pkgversion="3.8.2" version="0.2" date="2013-05-16" status="review"/>
+ <revision pkgversion="3.10" version="0.3" date="2013-11-09" status="review"/>
<desc>Share files to Bluetooth devices such as your phone.</desc>
<credit type="author">
<name>Jim Campbell</name>
- <email>jwcampbell gmail com</email>
+ <email its:translate="no">jwcampbell gmail com</email>
</credit>
<credit type="author">
<name>Paul W. Frields</name>
- <email>stickster gmail com</email>
+ <email its:translate="no">stickster gmail com</email>
</credit>
<credit type="editor">
<name>Michael Hill</name>
- <email>mdhillca gmail com</email>
+ <email its:translate="no">mdhillca gmail com</email>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
</info>
- <title>Send a file to a Bluetooth device</title>
+ <title>Send files to a Bluetooth device</title>
<if:choose>
<if:when test="platform:unity">
@@ -56,54 +58,39 @@
</note>
<steps>
- <title>Send files using the Bluetooth icon</title>
<item>
<if:choose>
<if:when test="platform:unity">
- <p>Click the Bluetooth icon in the menu bar and select <gui>Send Files to Device</gui>.</p>
+ <p>Click the Bluetooth icon in the menu bar and select <gui>Send Files to
+ Device</gui>.</p>
</if:when>
- <p>Click the Bluetooth icon on the top bar and select <gui>Send Files to Device</gui>.</p>
- </if:choose>
+ <p>Open the <gui xref="shell-terminology">Activities</gui> overview and
+ start typing <gui>Bluetooth</gui>.</p>
+ </if:choose>
</item>
<item>
- <p>Choose the file you want to send and click <gui>Select</gui>.</p>
- <p>To send more than one file in a folder, hold down <key>Ctrl</key> as you select each file.</p>
- </item>
- <item>
- <p>Select the device which you want to send the files to and click <gui>Send</gui>.</p>
- <p>The list of devices will show both <link xref="bluetooth-connect-device">devices you
- are already connected to</link> as well as <link xref="bluetooth-visibility">visible
- devices</link> within range. If you have not already connected to the selected device,
- you will be prompted to pair with the device after clicking <gui>Send</gui>. This will
- probably require confirmation on the other device.</p>
- <p>If there are many devices, you can limit the list to only specific device types
- using the <gui>Device type</gui> drop-down.</p>
+ <if:choose>
+ <if:when test="platform:gnome-shell">
+ <p>Click on <gui>Bluetooth</gui> to open the panel.</p>
+ </if:when>
+ </if:choose>
</item>
<item>
- <p>The owner of the receiving device usually has to press a button to accept the file. Once the owner
accepts or declines, the result of the file transfer will be shown on your screen.</p>
- </item>
- </steps>
-
- <steps>
- <title>Send files from the Bluetooth settings</title>
- <item>
- <if:choose>
- <if:when test="platform:unity">
- <p>Click the Bluetooth icon in the menu bar and select <gui>Bluetooth Settings</gui>.</p>
- </if:when>
- <p>Click the Bluetooth icon on the top bar and select <gui>Bluetooth Settings</gui>.</p>
- </if:choose>
+ <p>In the <gui>Devices</gui> list, select the device to which to send the
+ files to and click <gui>Send Files...</gui>.</p>
+ <p>If the desired device is not shown in the list, you need to
+ <link xref="bluetooth-connect-device">connect</link> to it.</p>
</item>
- <item><p>Select the device to send files to from the list on the left. The list
- only shows devices you've already connected to. See
- <link xref="bluetooth-connect-device"/>.</p></item>
- <item><p>In the device information on the right, click <gui>Send Files</gui>.</p></item>
<item>
<p>Choose the file you want to send and click <gui>Select</gui>.</p>
- <p>To send more than one file in a folder, hold down <key>Ctrl</key> as you select each file.</p>
+ <p>To send more than one file in a folder, hold down <key>Ctrl</key> as
+ you select each file.</p>
</item>
<item>
- <p>The owner of the receiving device usually has to press a button to accept the file. Once the owner
accepts or declines, the result of the file transfer will be shown on your screen.</p>
+ <p>The owner of the receiving device usually has to press a button to
+ accept the file. Once the owner accepts or declines, the result of the
+ file transfer will be shown on your screen.</p>
</item>
</steps>
+
</page>
diff --git a/gnome-help/C/bluetooth-turn-on-off.page b/gnome-help/C/bluetooth-turn-on-off.page
index 5fecd04..502c525 100644
--- a/gnome-help/C/bluetooth-turn-on-off.page
+++ b/gnome-help/C/bluetooth-turn-on-off.page
@@ -8,16 +8,21 @@
<link type="guide" xref="bluetooth" group="#first"/>
<revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+ <revision pkgversion="3.10" version="0.2" date="2013-11-09" status="review"/>
<desc>Enable or disable the Bluetooth device on your computer.</desc>
<credit type="author">
<name>Jim Campbell</name>
- <email>jwcampbell gmail com</email>
+ <email its:translate="no">jwcampbell gmail com</email>
</credit>
<credit type="author">
<name>Shaun McCance</name>
- <email>shaunm gnome org</email>
+ <email its:translate="no">shaunm gnome org</email>
+ </credit>
+ <credit type="editor">
+ <name>Michael Hill</name>
+ <email its:translate="no">mdhillca gmail com</email>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
</info>
@@ -28,16 +33,34 @@
<p its:translate="yes">The Bluetooth icon on the top bar</p>
</media>
+ <comment>
+ <cite date="2013-11-09" href="mailto:mdhillca gmail com">mdhill</cite>
+ <p>Add link to shell-terminology definition of system status *area* of top
+ bar when it has been written, explain that if your network connection is
+ through a bluetooth device it will show up in the system status *menu*
+ and only then will its icon be visible as shown.</p>
+ </comment>
+
<if:choose>
<if:when test="platform:unity">
- <p>You can turn Bluetooth on to use Bluetooth devices and send and receive files,
- but turn it off to conserve power. To turn Bluetooth on, click the Bluetooth icon
- in the menu bar and click <gui>Turn On Bluetooth</gui>.
- </p>
+ <p>You can turn Bluetooth on to use Bluetooth devices and send and receive
+ files, but turn it off to conserve power. To turn Bluetooth on, click the
+ Bluetooth icon in the menu bar and click <gui>Turn On Bluetooth</gui>.</p>
</if:when>
- <p>You can turn Bluetooth on to use Bluetooth devices and send and receive files,
- but turn it off to conserve power. To turn Bluetooth on, click the Bluetooth icon
- on the top bar and switch <gui>Bluetooth</gui> on.</p>
+ <p>You can turn Bluetooth on to use Bluetooth devices and send and receive
+ files, but turn it off to conserve power. To turn Bluetooth on:</p>
+ <steps>
+ <item>
+ <p>Open the <gui xref="shell-terminology">Activities</gui> overview and
+ start typing <gui>Bluetooth</gui>.</p>
+ </item>
+ <item>
+ <p>Click on <gui>Bluetooth</gui> to open the panel.</p>
+ </item>
+ <item>
+ <p>Set the switch in the titlebar to <gui>ON</gui>.</p>
+ </item>
+ </steps>
</if:choose>
<if:choose>
@@ -45,21 +68,34 @@
<p>Many laptop computers have a hardware switch or key combination to turn
Bluetooth on and off. If the Bluetooth hardware is turned off, you will not
see a Bluetooth icon in the menu bar. Look for a switch on your computer or
- a key on your keyboard. The keyboard key is often accessed with the help of the
-<key>Fn</key> key.</p>
+ a key on your keyboard. The keyboard key is often accessed with the help of
+ the <key>Fn</key> key.</p>
</if:when>
<p>Many laptop computers have a hardware switch or key combination to turn
Bluetooth on and off. If the Bluetooth hardware is turned off, you will not
see a Bluetooth icon in the top bar. Look for a switch on your computer or
- a key on your keyboard. The keyboard key is often accessed with the help of the
- <key>Fn</key> key.</p>
+ a key on your keyboard. The keyboard key is often accessed with the help of
+ the <key>Fn</key> key.</p>
</if:choose>
<if:choose>
<if:when test="platform:unity">
- <p>To turn Bluetooth off, click the Bluetooth icon and click <gui>Turn Off Bluetooth</gui>.</p>
+ <p>To turn Bluetooth off, click the Bluetooth icon and click
+ <gui>Turn Off Bluetooth</gui>.</p>
</if:when>
- <p>To turn Bluetooth off, click the Bluetooth icon and switch <gui>Bluetooth</gui> off.</p>
+ <p>To turn Bluetooth off:</p>
+ <steps>
+ <item>
+ <p>Open the <gui xref="shell-terminology">Activities</gui> overview and
+ start typing <gui>Bluetooth</gui>.</p>
+ </item>
+ <item>
+ <p>Click on <gui>Bluetooth</gui> to open the panel.</p>
+ </item>
+ <item>
+ <p>Set the switch in the titlebar to <gui>OFF</gui>.</p>
+ </item>
+ </steps>
</if:choose>
<note><p>You only need to switch <gui>Visibility</gui> on if you are connecting
diff --git a/gnome-help/C/bluetooth-visibility.page b/gnome-help/C/bluetooth-visibility.page
index 72ce68f..309dcbc 100644
--- a/gnome-help/C/bluetooth-visibility.page
+++ b/gnome-help/C/bluetooth-visibility.page
@@ -1,4 +1,5 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
type="topic" style="question"
id="bluetooth-visibility">
@@ -6,12 +7,13 @@
<link type="guide" xref="bluetooth" group="#last"/>
<revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+ <revision pkgversion="3.10" version="0.2" date="2013-11-09" status="review"/>
<desc>Whether or not other devices can discover your computer.</desc>
<credit type="author">
<name>Shaun McCance</name>
- <email>shaunm gnome org</email>
+ <email its:translate="no">shaunm gnome org</email>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
</info>
@@ -30,7 +32,14 @@
neither your computer nor the device needs to be visible to communicate with each
other.</p>
+ <comment>
+ <cite date="2013-11-09" href="mailto:mdhillca gmail com">mdhill</cite>
+ <p>Add note about changing the display name of your computer with a link to
+ the future sharing-displayname page. Under 3.10 this is allowed in Fedora,
+ for example, but not in openSUSE.</p>
+ </comment>
+
<p>Unless you or someone you trust needs to connect to your computer from
another device, you should leave visibility off.</p>
-</page>
\ No newline at end of file
+</page>
diff --git a/gnome-help/C/bluetooth.page b/gnome-help/C/bluetooth.page
index ad305f4..bba7c3e 100644
--- a/gnome-help/C/bluetooth.page
+++ b/gnome-help/C/bluetooth.page
@@ -1,14 +1,16 @@
<page xmlns="http://projectmallard.org/1.0/";
+ xmlns:its="http://www.w3.org/2005/11/its";
type="guide" style="task"
id="bluetooth">
<info>
<link type="guide" xref="hardware"/>
<revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+ <revision pkgversion="3.10" version="0.2" date="2013-11-09" status="review"/>
<credit type="author">
<name>Shaun McCance</name>
- <email>shaunm gnome org</email>
+ <email its:translate="no">shaunm gnome org</email>
</credit>
<desc>
@@ -50,4 +52,4 @@ a new top-level guide for security, and link the topic there too.</p>
<title>Problems</title>
</section>
-</page>
\ No newline at end of file
+</page>
diff --git a/gnome-help/C/sharing-bluetooth.page b/gnome-help/C/sharing-bluetooth.page
index 2f60205..72d880c 100644
--- a/gnome-help/C/sharing-bluetooth.page
+++ b/gnome-help/C/sharing-bluetooth.page
@@ -7,6 +7,7 @@
<link type="guide" xref="settings-sharing"/>
<revision pkgversion="3.8.2" version="0.1" date="2013-05-13" status="draft"/>
+ <revision pkgversion="3.10" version="0.2" date="2013-11-09" status="review"/>
<credit type="author">
<name>Michael Hill</name>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
