GNOME.org
 

[gnome-user-docs] Fixed up Bluetooth info, added page on visibility

commit d5354e30e53441cbf0ea6a07e0811072e25729b8
Author: Shaun McCance <shaunm gnome org>
Date:   Thu Sep 22 23:10:41 2011 -0400

    Fixed up Bluetooth info, added page on visibility
    
    Also added big comment on what other info I'd like to see

 gnome-help/C/bluetooth-connect-device.page     |   43 ++++++++++++++-----
 gnome-help/C/bluetooth-problem-connecting.page |    5 +-
 gnome-help/C/bluetooth-remove-connection.page  |   17 ++++++--
 gnome-help/C/bluetooth-send-file.page          |   55 +++++++++++++++++++----
 gnome-help/C/bluetooth-turn-on-off.page        |   33 ++++++++------
 gnome-help/C/bluetooth-visibility.page         |   36 +++++++++++++++
 gnome-help/C/bluetooth.page                    |   30 +++++++++++++
 gnome-help/C/files-share.page                  |    5 +-
 gnome-help/C/hardware-problems-bluetooth.page  |   24 ----------
 gnome-help/Makefile.am                         |    2 +-
 10 files changed, 180 insertions(+), 70 deletions(-)
---
diff --git a/gnome-help/C/bluetooth-connect-device.page b/gnome-help/C/bluetooth-connect-device.page
index fe0dea6..a124b6a 100644
--- a/gnome-help/C/bluetooth-connect-device.page
+++ b/gnome-help/C/bluetooth-connect-device.page
@@ -4,6 +4,9 @@
 
   <info>
     <link type="guide" xref="bluetooth"/>
+
+    <revision pkgversion="3.2" date="2011-09-22" status="candidate"/>
+
     <desc>Pair Bluetooth devices.</desc>
 
     <credit type="author">
@@ -14,25 +17,35 @@
       <name>Paul W. Frields</name>
       <email>stickster gmail com</email>
     </credit>
+    <credit type="author">
+      <name>Shaun McCance</name>
+      <email>shaunm gnome org</email>
+    </credit>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Connect your computer to another Bluetooth device</title>
+  <title>Connect your computer to a Bluetooth device</title>
 
-  <p>Before you can transfer files between Bluetooth-enabled devices, you first need to connect them. This is also called, "pairing" Bluetooth devices.</p>
+  <p>Before you can use a Bluetooth device like a mouse or a headset, you first
+  need to connect your computer to the device. This is also called pairing the
+  Bluetooth devices.</p>
+
+  <note style="important">
+    <p>Before you begin, make sure Bluetooth is enabled on your computer.
+    See <link xref="bluetooth-turn-on-off"/>.</p>
+  </note>
 
   <steps>
     <item>
-      <p><link xref="bluetooth-turn-on-off">Turn on</link> your computer's Bluetooth device.</p>
-    </item>
-    <item>
-      <p>Select the Bluetooth icon in the top bar, and select <gui>Setup a New Device...</gui>.</p>
+      <p>Click the Bluetooth icon on the top bar and select <gui>Set up a New Device</gui>.</p>
     </item>
     <item>
-      <p>Make the other Bluetooth device discoverable or visible, and place it within 10 meters of your computer. Then select <gui>Forward</gui>. Your computer will begin searching for devices.</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. Then select <gui>Forward</gui>. Your
+      computer will begin searching for devices.</p>
     </item>
     <item>
-      <p>If there are too many devices listed, select the <gui>Device type</gui> drop-down bar to display only a single type of device in the list.</p>
+      <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>
     </item>
     <item>
       <p>Select <gui>PIN options...</gui> to set how a PIN will be delivered to the other device.</p>
@@ -42,13 +55,21 @@
       <p>Choose an appropriate PIN setting for your device, and then select <gui>Close</gui>.</p>
     </item>
     <item>
-      <p>Select <gui>Forward</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>Enter the PIN code on your other device, if required. 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>Enter the PIN code on your other device, if required. Sometimes the other device
+      will simply show you the PIN and ask you to confirm that it matches what you see on
+      your computer.</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>
     </item>
     <item>
-      <p>A message appears when the connection successfully completes. If the device offers other capabilities, such as Personal Area Networking (PAN) on a mobile phone, you can enable them using checkboxes. Then select <gui>Close</gui>.</p>
+      <p>A message appears when the connection successfully completes. Click <gui>Close</gui>.</p>
     </item>
   </steps>
 
diff --git a/gnome-help/C/bluetooth-problem-connecting.page b/gnome-help/C/bluetooth-problem-connecting.page
index 9cdf351..838bb82 100644
--- a/gnome-help/C/bluetooth-problem-connecting.page
+++ b/gnome-help/C/bluetooth-problem-connecting.page
@@ -3,8 +3,7 @@
       id="bluetooth-problem-connecting">
 
   <info>
-    <link type="guide" xref="hardware-problems-bluetooth"/>
-    <link type="guide" xref="bluetooth"/>
+    <link type="guide" xref="bluetooth#problems"/>
     <link type="seealso" xref="hardware-driver"/>
     
     <desc>The adapter could be turned off or may not have drivers, or Bluetooth might be disabled or blocked.</desc>
@@ -16,7 +15,7 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Why can't I connect my Bluetooth device?</title>
+<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 (like a phone or headset):</p>
 
diff --git a/gnome-help/C/bluetooth-remove-connection.page b/gnome-help/C/bluetooth-remove-connection.page
index 5667d0d..7055fea 100644
--- a/gnome-help/C/bluetooth-remove-connection.page
+++ b/gnome-help/C/bluetooth-remove-connection.page
@@ -4,6 +4,9 @@
 
   <info>
     <link type="guide" xref="bluetooth"/>
+
+    <revision pkgversion="3.2" date="2011-09-22" status="final"/>
+
     <desc>Remove a device from the list of Bluetooth devices.</desc>
 
     <credit type="author">
@@ -18,17 +21,23 @@
   </info>
 
   <title>Remove a connection between Bluetooth devices</title>
-  <p>If you don't want to be connected to a Bluetooth device any more, remove the connection:</p>
+
+
+  <p>If you don't want to be connected to a Bluetooth device any more, you can
+  remove the connection. This is useful if you no longer want to use a device
+  like a mouse or headset, or if you no longer with to transfer files to or
+  from a device.</p>
 
   <steps>
     <item>
-      <p>Click the Bluetooth icon in the top bar, and choose <gui>Bluetooth Settings</gui>.</p>
+      <p>Click the Bluetooth icon on the top bar and select <gui>Bluetooth Settings</gui>.</p>
     </item>
     <item>
-      <p>Select the device you want to disconnect in the left pane, and then click the <gui>-</gui> icon underneath the list.</p>
+      <p>Select the device you want to disconnect in the left pane, then click the <gui>-</gui>
+      icon underneath the list.</p>
     </item>
     <item>
-      <p>Click <gui>Remove</gui>.</p>
+      <p>Click <gui>Remove</gui> in the confirmation window.</p>
     </item>
   </steps>
 
diff --git a/gnome-help/C/bluetooth-send-file.page b/gnome-help/C/bluetooth-send-file.page
index 8e6b59d..951f413 100644
--- a/gnome-help/C/bluetooth-send-file.page
+++ b/gnome-help/C/bluetooth-send-file.page
@@ -4,7 +4,11 @@
 
   <info>
     <link type="guide" xref="bluetooth"/>
-    <desc>Share files between Bluetooth-enabled devices, like your computer and your phone.</desc>
+    <link type="seealso" xref="files-share"/>
+
+    <revision pkgversion="3.2" date="2011-09-22" status="candidate"/>
+
+    <desc>Share files to Bluetooth devices such as your phone.</desc>
 
     <credit type="author">
       <name>Jim Campbell</name>
@@ -17,27 +21,58 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Send a file to another Bluetooth device</title>
-  <p>You can send files to connected Bluetooth devices, such as some mobile phones or other computers. Some types of devices don't allow the transfer of files, or specific types of files.</p>
+  <title>Send a file to a Bluetooth device</title>
+
+  <p>You can send files to connected Bluetooth devices, such as some mobile
+  phones or other computers. Some types of devices don't allow the transfer
+  of files, or specific types of files. You can send files in one of three
+  ways: using the Bluetooth icon on the top bar, from the Bluetooth settings
+  window, or directly from the file manager.</p>
+
+  <p>To send files directly from the file manager, see <link xref="files-share"/>.</p>
+
+  <note style="important">
+    <p>Before you begin, make sure Bluetooth is enabled on your computer.
+    See <link xref="bluetooth-turn-on-off"/>.</p>
+  </note>
 
   <steps>
+    <title>Send files using the Bluetooth icon</title>
     <item>
-      <p>If you have not done so already, <link xref="bluetooth-connect-device">create a connection</link> to the Bluetooth device.</p>
-    </item>
-    <item>
-      <p>Click the Bluetooth icon in the top bar and click <gui>Send Files to Device</gui>.</p>
+      <p>Click the Bluetooth icon on the top bar and select <gui>Send Files to Device</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>Select the device which you want to send the files to from the list and then click <gui>Send</gui>.</p>
-      <p>You can limit the list to only specific device types using the <gui>Device type</gui> drop-down control. You can also filter the list by whether the devices are paired and whether they are trusted.</p>
+      <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>
     </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><p>Click the Bluetooth icon on the top bar and select <gui>Bluetooth Settings</gui>.</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>
+    </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>
 </page>
diff --git a/gnome-help/C/bluetooth-turn-on-off.page b/gnome-help/C/bluetooth-turn-on-off.page
index 6e3b91f..04dca42 100644
--- a/gnome-help/C/bluetooth-turn-on-off.page
+++ b/gnome-help/C/bluetooth-turn-on-off.page
@@ -3,30 +3,32 @@
       id="bluetooth-turn-on-off">
 
   <info>
-    <link type="guide" xref="bluetooth"/>
+    <link type="guide" xref="bluetooth" group="#first"/>
+
+    <revision pkgversion="3.2" date="2011-09-22" status="candidate"/>
+
     <desc>Enable or disable the Bluetooth device on your computer.</desc>
 
     <credit type="author">
       <name>Jim Campbell</name>
       <email>jwcampbell gmail com</email>
     </credit>
+    <credit type="author">
+      <name>Shaun McCance</name>
+      <email>shaunm gnome org</email>
+    </credit>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
 <title>Turn Bluetooth on or off</title>
 
-<p>
-You can turn <app>Bluetooth</app> on to send and receive files, but turn it off to conserve power.
-</p>
-
-<figure>
-  <desc>The Bluetooth icon and menu can be found on the top bar.</desc>
-  <media type="image" src="figures/bluetooth-menu.png"/>
-</figure>
+<media type="image" src="figures/bluetooth-menu.png" style="floatend">
+  <p>The Bluetooth icon on the top bar</p>
+</media>
 
-<p>
-To turn <app>Bluetooth</app> on, click the <app>Bluetooth</app> icon in the top bar, then toggle the <gui>Bluetooth</gui> switch so that it reads as <gui>ON</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
+on the top bar and switch <gui>Bluetooth</gui> on.</p>
 
 <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
@@ -34,9 +36,10 @@ 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>
 
-<note style="tip"><p>If you are connecting to another <app>Bluetooth</app> device for the first time, set the <gui>Visibility</gui> switch to <gui>ON</gui>. This allows your device to be seen by other <app>Bluetooth</app> devices.</p></note>
+<p>To turn Bluetooth off, click the Bluetooth icon and switch <gui>Bluetooth</gui> off.</p>
 
-<p>To turn <app>Bluetooth</app> off, change the <gui>Bluetooth</gui> switch to the <gui>OFF</gui> position.
-</p>
+<note><p>You only need to switch <gui>Visibility</gui> on if you are connecting
+to this computer from another device. See <link xref="bluetooth-visibility"/>
+for more information.</p></note>
 
 </page>
diff --git a/gnome-help/C/bluetooth-visibility.page b/gnome-help/C/bluetooth-visibility.page
new file mode 100644
index 0000000..7088fbc
--- /dev/null
+++ b/gnome-help/C/bluetooth-visibility.page
@@ -0,0 +1,36 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="question"
+      id="bluetooth-visibility">
+
+  <info>
+    <link type="guide" xref="bluetooth" group="#last"/>
+
+    <revision pkgversion="3.2" date="2011-09-22" status="candidate"/>
+
+    <desc>Whether or not other devices can discover your computer.</desc>
+
+    <credit type="author">
+      <name>Shaun McCance</name>
+      <email>shaunm gnome org</email>
+    </credit>
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>What is Bluetooth visibility?</title>
+
+  <p>Bluetooth visibility simply refers to whether other devices can discover
+  your computer when searching for Bluetooth devices. When Bluetooth visibility
+  is turned on, your computer will advertise itself to all other devices within
+  range, allowing them to attempt to connect to you.</p>
+
+  <p>Your computer does not need to be visible to search for other devices, but
+  those devices need to be visible for your computer to discover them.</p>
+
+  <p>After you have <link xref="bluetooth-connect-device">connected to a device</link>,
+  neither your computer nor the device needs to be visible to communicate with each
+  other.</p>
+
+  <p>Unless you or someone you trust needs to connect to your computer from
+  another device, you should leave visibility off.</p>
+
+</page>
diff --git a/gnome-help/C/bluetooth.page b/gnome-help/C/bluetooth.page
index 1f16bd5..cf5b365 100644
--- a/gnome-help/C/bluetooth.page
+++ b/gnome-help/C/bluetooth.page
@@ -4,6 +4,7 @@
 <info>
   <link type="guide" xref="hardware"/>
   
+  <revision pkgversion="3.2" date="2011-09-22" status="final"/>
 
   <credit type="author">
     <name>Shaun McCance</name>
@@ -21,4 +22,33 @@
 
 <title>Bluetooth</title>
 
+<p>Bluetooth is a wireless protocol that allows you to connect many different
+types of devices to your computer. Bluetooth is commonly used for headsets
+and input devices like mice and keyboards. You can also use Bluetooth to
+<link xref="bluetooth-send-file">send files between devices</link>, such as
+from your computer to your cell phone.</p>
+
+<comment>
+<cite date="2011-09-22">shaunm</cite>
+<p>Things to improve: The BT settings has a "Browse Files" button for devices.
+We only cover push file transfers. Might also be worth mentioning something
+on receiving files when doing push from another device.</p>
+<p>We don't have explicit pages for input devices. Might be worth a topic like
+"Connect a BT mouse or keyboard", linked under Mouse, Keyboard, and BT.</p>
+<p>We have nothing for BT printers. Topic under both Printing and BT.
+Consider other device classes, topics linked under both BT and the
+appropriate device-specific guide (e.g. headset under Audio).</p>
+<p>A topic on Bluetooth security would be good. Might want to also create
+a new top-level guide for security, and link the topic there too.</p>
+</comment>
+
+<section id="problems">
+  <info>
+    <title type="link">Bluetooth problems</title>
+    <title type="link" role="trail">Problems</title>
+    <link type="guide" xref="hardware#problems"/>
+  </info>
+  <title>Problems</title>
+</section>
+
 </page>
diff --git a/gnome-help/C/files-share.page b/gnome-help/C/files-share.page
index cdafb16..44b3636 100644
--- a/gnome-help/C/files-share.page
+++ b/gnome-help/C/files-share.page
@@ -55,8 +55,9 @@ directly from the file manager.</p>
   <item><p>To write the file to a CD or DVD, select <gui>CD/DVD Creator</gui>.
   See <link xref="files-disc-write"/> to learn more.</p></item>
   <item><p>To transfer the file to a Bluetooth device, select
-  <gui>Bluetooth (OBEX Push)</gui>. See <link xref="bluetooth"/>
-  for more information.</p></item>
+  <gui>Bluetooth (OBEX Push)</gui> and select the device to send the file to.
+  You will only see devices you have already paired with.
+  See <link xref="bluetooth"/> for more information.</p></item>
   <item><p>To copy the file to an external device like a USB flash drive,
   or to upload it to a server you've connected to, select <gui>Removable
   disks and shares</gui>, then select the device or server you want to
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index af1ad39..6973d6e 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -66,6 +66,7 @@ HELP_FILES = \
 	bluetooth-remove-connection.page \
 	bluetooth-send-file.page \
 	bluetooth-turn-on-off.page \
+	bluetooth-visibility.page \
 	color.page \
 	clock-calendar.page \
 	clock-set.page \
@@ -123,7 +124,6 @@ HELP_FILES = \
 	hardware-auth.page \
 	hardware-cardreader.page \
 	hardware-driver.page \
-	hardware-problems-bluetooth.page \
 	hardware-problems-graphics.page \
 	hardware.page \
 	index.page \
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]