[gnome-user-docs/gnome-3-8] Added sharing-bluetooth with related links

[Petr Kovář <pmkovar src gnome org>]

commit 75f173c26f5bfb97fee6d1d8c87d190cbf772be0
Author: Michael Hill <mdhillca gmail com>
Date:   Sat May 18 14:17:19 2013 -0400

    Added sharing-bluetooth with related links

 gnome-help/C/bluetooth-connect-device.page |   15 ++++-
 gnome-help/C/bluetooth-send-file.page      |    8 ++-
 gnome-help/C/settings-sharing.page         |    2 -
 gnome-help/C/sharing-bluetooth.page        |  106 ++++++++++++++++++++++++++++
 gnome-help/Makefile.am                     |    1 +
 5 files changed, 127 insertions(+), 5 deletions(-)
---
diff --git a/gnome-help/C/bluetooth-connect-device.page b/gnome-help/C/bluetooth-connect-device.page
index d849e86..16fb524 100644
--- a/gnome-help/C/bluetooth-connect-device.page
+++ b/gnome-help/C/bluetooth-connect-device.page
@@ -5,8 +5,9 @@
 
   <info>
     <link type="guide" xref="bluetooth"/>
-
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <link type="seealso" xref="sharing-bluetooth"/>
+    
+    <revision pkgversion="3.8.2" version="0.2" date="2013-05-16" status="review"/>
 
     <desc>Pair Bluetooth devices.</desc>
 
@@ -22,6 +23,10 @@
       <name>Shaun McCance</name>
       <email>shaunm gnome org</email>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
@@ -78,4 +83,10 @@
 
   <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
+        <gui>Bluetooth Sharing</gui> settings. See
+        <link xref="sharing-bluetooth"/>.</p>
+      </note>
+
 </page>
diff --git a/gnome-help/C/bluetooth-send-file.page b/gnome-help/C/bluetooth-send-file.page
index cfa1f82..d2216b2 100644
--- a/gnome-help/C/bluetooth-send-file.page
+++ b/gnome-help/C/bluetooth-send-file.page
@@ -5,9 +5,10 @@
 
   <info>
     <link type="guide" xref="bluetooth"/>
+    <link type="guide" xref="sharing"/>
     <link type="seealso" xref="files-share"/>
 
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.8.2" version="0.2" date="2013-05-16" status="review"/>
 
     <desc>Share files to Bluetooth devices such as your phone.</desc>
 
@@ -19,6 +20,11 @@
       <name>Paul W. Frields</name>
       <email>stickster gmail com</email>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
+
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
diff --git a/gnome-help/C/settings-sharing.page b/gnome-help/C/settings-sharing.page
index daef125..8d7bbdc 100644
--- a/gnome-help/C/settings-sharing.page
+++ b/gnome-help/C/settings-sharing.page
@@ -6,9 +6,7 @@
   <link type="guide" xref="prefs"/>
   <revision pkgversion="3.8.2" version="0.1" date="2013-05-08" status="draft"/>
     <desc>
-<!--
       <link xref="sharing-bluetooth">Bluetooth sharing</link>,
--->
       <link xref="sharing-desktop">Screen sharing</link>,
       <link xref="sharing-media">Media sharing</link>…
     </desc>
diff --git a/gnome-help/C/sharing-bluetooth.page b/gnome-help/C/sharing-bluetooth.page
new file mode 100644
index 0000000..fc9c51b
--- /dev/null
+++ b/gnome-help/C/sharing-bluetooth.page
@@ -0,0 +1,106 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="sharing-bluetooth">
+  <info>
+    <link type="guide" xref="bluetooth"/>
+    <link type="guide" xref="settings-sharing"/>
+
+    <revision pkgversion="3.8.2" version="0.1" date="2013-05-13" status="draft"/>
+
+    <credit type="author">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
+
+    <desc>Set which folders and devices are able to share over Bluetooth.</desc>
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Control sharing over Bluetooth</title>
+
+  <p>You can allow access to your <file>Public</file> and
+  <file>Downloads</file> folders for Bluetooth file sharing, and also restrict
+  that access to only <em>trusted devices</em>. Configure
+  <gui>Bluetooth Sharing</gui> to control access to the shared folders on your
+  computer.</p>
+
+  <note style="info">
+    <p>A Bluetooth device is <em>trusted</em> if you have <em>paired</em>, or
+    connected your computer to it. See
+    <link xref="bluetooth-connect-device"/>.</p>
+  </note>
+
+  <steps>
+    <title>Share your <file>Public</file> folder over Bluetooth</title>
+    <item>
+      <p>Click your name on the top bar and select <gui>Settings</gui>.</p>
+    </item>
+    <item>
+      <p>Open <gui>Sharing</gui>.</p>
+    </item>
+    <item>
+      <p>If <gui>Sharing</gui> is <gui>OFF</gui>, switch it to
+      <gui>ON</gui>.</p>
+    </item>
+    <item>
+      <p>Select <gui>Bluetooth Sharing</gui>.</p>
+    </item>
+    <item>
+      <p>Switch <gui>Share Public Folder</gui> to <gui>ON</gui>.</p>
+    </item>
+    <item>
+      <p>If you only want to allow trusted devices to access your
+      <file>Public</file> folder, switch
+      <gui>Only share with Trusted Devices</gui> to <gui>ON</gui>.</p>
+
+      <note style="tip">
+        <p>This option is disabled by default. You should enable it if you want
+        to prevent access to your shared files by anyone with a
+        Bluetooth-enabled cell phone or similar device nearby.</p>
+      </note>
+ 
+    </item>
+    <item>
+      <p>Click <gui style="button">Close</gui>. Bluetooth-enabled devices will
+      now be able to access files in your <file>Public</file> folder.</p>
+    </item>
+  </steps>
+
+  <steps>
+    <title>Allow files to be shared into your <file>Downloads</file> folder</title>
+    <item>
+      <p>Click your name on the top bar and select <gui>Settings</gui>.</p>
+    </item>
+    <item>
+      <p>Open <gui>Sharing</gui>.</p>
+    </item>
+    <item>
+      <p>If <gui>Sharing</gui> is <gui>OFF</gui>, switch it to
+      <gui>ON</gui>.</p>
+    </item>
+    <item>
+      <p>Select <gui>Bluetooth Sharing</gui>.</p>
+    </item>
+    <item>
+      <p>Switch <gui>Save Received Files to Downloads Folder</gui> to
+      <gui>ON</gui>.</p>
+    </item>
+    <item>
+      <p>If you only want to allow trusted devices to access your
+      <file>Downloads</file> folder, switch
+      <gui>Only Receive From Trusted Devices</gui> to <gui>ON</gui>.</p>
+
+      <note style="tip">
+        <p>This option is disabled by default. You should enable it if you want
+        to prevent access to your shared files by anyone with a
+        Bluetooth-enabled cell phone or similar device nearby.</p>
+      </note>
+
+    </item>
+    <item>
+      <p>Click <gui style="button">Close</gui>. Bluetooth-enabled devices will
+      now be able to send files to your <file>Downloads</file> folder.</p>
+    </item>
+  </steps>
+
+</page>
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index fee79fa..0ba290a 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -345,6 +345,7 @@ HELP_FILES = \
        session-screenlocks.page \
        settings-sharing.page \
        sharing.page \
+       sharing-bluetooth.page \
        sharing-desktop.page \
        sharing-media.page \
        shell-apps-favorites.page \