[gnome-user-docs] Add sharing-displayname, update bluetooth/sharing pp

[Michael Hill <mdhill src gnome org>]

commit 10585a972597eaf2f8f9cdc43b3b9e2c7b0c814f
Author: Michael Hill <mdhill gnome org>
Date:   Sun Mar 9 09:26:19 2014 -0400

    Add sharing-displayname, update bluetooth/sharing pp

 gnome-help/C/bluetooth-visibility.page |   19 ++++-----
 gnome-help/C/sharing-bluetooth.page    |   66 ++++---------------------------
 gnome-help/C/sharing-displayname.page  |   41 ++++++++++++++++++++
 gnome-help/Makefile.am                 |    1 +
 4 files changed, 60 insertions(+), 67 deletions(-)
---
diff --git a/gnome-help/C/bluetooth-visibility.page b/gnome-help/C/bluetooth-visibility.page
index 8ca801a..a7a72e6 100644
--- a/gnome-help/C/bluetooth-visibility.page
+++ b/gnome-help/C/bluetooth-visibility.page
@@ -8,7 +8,7 @@
 
     <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
     <revision pkgversion="3.10" version="0.2" date="2013-11-09" status="review"/>
-    <revision pkgversion="3.12" version="0.3" date="2014-03-04" status="incomplete"/>
+    <revision pkgversion="3.12" version="0.3" date="2014-03-04" status="review"/>
 
     <desc>Whether or not other devices can discover your computer.</desc>
 
@@ -32,6 +32,14 @@
   itself to all other devices within range, allowing them to attempt to connect
   to you.</p>
 
+  <note>
+    <p>To indicate that your computer is visible while the <gui>Bluetooth</gui>
+    panel is open, the <em>visible name</em> is displayed. The name appears in
+    the label above the device list, <gui>Visible as "Jo's Desktop"</gui>, for
+    example, and can be <link xref="sharing-displayname">changed</link> from
+    the <gui>Sharing</gui> panel.</p>
+  </note>
+
   <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>
 
@@ -40,15 +48,6 @@
   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>
-    <cite date="2014-03-04" href="mailto:mdhillca gmail com">mdhill</cite>
-    <p>Add a note about the "Visible as" label.</p>
-  </comment>
-
 <!--
   <p>Unless you or someone you trust needs to connect to your computer from
   another device, you should leave visibility off.</p>
diff --git a/gnome-help/C/sharing-bluetooth.page b/gnome-help/C/sharing-bluetooth.page
index 9bf8562..54442e6 100644
--- a/gnome-help/C/sharing-bluetooth.page
+++ b/gnome-help/C/sharing-bluetooth.page
@@ -8,6 +8,7 @@
 
     <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"/>
+    <revision pkgversion="3.12" version="0.3" date="2014-03-08" status="review"/>
 
     <credit type="author">
       <name>Michael Hill</name>
@@ -15,23 +16,16 @@
       <years>2014</years>
     </credit>
 
-    <desc>Set which folders and devices can be to shared over Bluetooth.</desc>
+    <desc>Allow files to be uploaded to your computer over Bluetooth.</desc>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
   <title>Control sharing over Bluetooth</title>
 
-  <comment>
-    <cite date="2013-09-23" href="mailto:mdhillca gmail com">Michael Hill</cite>
-    <p>Rewrite Step 1 everywhere. Add an info note about the two technologies
-    involved: ObexFTP and ObexPush.</p>
-  </comment>
-
-  <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>
+  <p>You can allow access to your <file>Downloads</file> folder 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 folder
+  on your computer.</p>
 
   <note style="info">
     <p>A Bluetooth device is <em>trusted</em> if you have <em>paired</em>, or
@@ -40,47 +34,6 @@
   </note>
 
   <steps>
-    <title>Share your <file>Public</file> folder over Bluetooth</title>
-    <item>
-      <p>Open the <gui xref="shell-terminology">Activities</gui> overview and
-      start typing <gui>Sharing</gui>.</p>
-    </item>
-    <item>
-      <p>Click on <gui>Sharing</gui> to open the panel.</p>
-    </item>
-    <item>
-      <p>If <gui>Sharing</gui> is <gui>OFF</gui>, switch it to
-      <gui>ON</gui>.</p>
-
-      <note style="info"><p>If the text below <gui>Computer Name</gui> allows
-      you to edit it, you can change the name your computer displays on the
-      network.</p></note>
-    </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>Open the <gui xref="shell-terminology">Activities</gui> overview and
@@ -93,9 +46,8 @@
       <p>If <gui>Sharing</gui> is <gui>OFF</gui>, switch it to
       <gui>ON</gui>.</p>
 
-      <note style="info"><p>If the text below <gui>Computer Name</gui> allows
-      you to edit it, you can change the name your computer displays on the
-      network.</p></note>
+      <note style="info"><p>You can <link xref="sharing-displayname">change</link>
+      the name your computer displays to other devices.</p></note>
     </item>
     <item>
       <p>Select <gui>Bluetooth Sharing</gui>.</p>
@@ -125,7 +77,7 @@
   <note style="important">
     <p><gui>Files</gui> allows you to launch the <gui>Sharing</gui> panel
     directly by clicking the <gui>Preferences</gui> button when you visit the
-    <gui>Public</gui> folder.</p>
+    <gui>Downloads</gui> folder.</p>
   </note>
 
 </page>
diff --git a/gnome-help/C/sharing-displayname.page b/gnome-help/C/sharing-displayname.page
new file mode 100644
index 0000000..9777671
--- /dev/null
+++ b/gnome-help/C/sharing-displayname.page
@@ -0,0 +1,41 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
+      type="topic" style="task"
+      id="sharing-displayname">
+  <info>
+    <link type="guide" xref="settings-sharing" group="#first"/>
+
+    <revision pkgversion="3.12" version="0.3" date="2014-03-08" status="review"/>
+
+    <credit type="author">
+      <name>Michael Hill</name>
+      <email its:translate="no">mdhillca gmail com</email>
+      <years>2014</years>
+    </credit>
+
+    <desc>Control how your computer will appear to other computers or
+    devices.</desc>
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Set the display name for your computer</title>
+
+  <p>You can change the name your computer uses to display itself on other
+  computers or devices, on the network or over Bluetooth.</p>
+
+  <steps>
+    <title>Change the display name of your computer:</title>
+    <item>
+      <p>Open the <gui xref="shell-terminology">Activities</gui> overview and
+      start typing <gui>Sharing</gui>.</p>
+    </item>
+    <item>
+      <p>Click on <gui>Sharing</gui> to open the panel.</p>
+    </item>
+    <item>
+      <p>Edit the text below <gui>Computer Name</gui> to change the name your
+      computer displays on the network.</p>
+    </item>
+  </steps>
+
+</page>
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index fc665c7..4028188 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -338,6 +338,7 @@ HELP_FILES = \
        sharing.page \
        sharing-bluetooth.page \
        sharing-desktop.page \
+       sharing-displayname.page \
        sharing-media.page \
        sharing-personal.page \
        shell-apps-favorites.page \