[gnome-user-docs/wip/hadess/bluetooth-setup-help] Add more details on how to pair devices via Bluetooth

[Bastien Nocera <hadess src gnome org>]

commit facd8a2929e1a6f55926fe3082608335e4aecde8
Author: Bastien Nocera <hadess hadess net>
Date:   Fri Apr 12 15:39:43 2019 +0200

    Add more details on how to pair devices via Bluetooth
    
    The page with more details is important because some of those features
    are not known to end users ("cable pairing"), key combination are not
    mentioned in the manual but in software ("BD remote") or multiple ways
    to seemingly achieve the same thing are documented, but work in very
    different ways ("Wiimote").
    
    We might add more non-gaming devices to this list in the future.

 .../C/bluetooth-device-specific-pairing.page       | 48 ++++++++++++++++++++++
 gnome-help/C/bluetooth-visibility.page             |  9 ++++
 2 files changed, 57 insertions(+)
---
diff --git a/gnome-help/C/bluetooth-device-specific-pairing.page 
b/gnome-help/C/bluetooth-device-specific-pairing.page
new file mode 100644
index 00000000..f0d5e406
--- /dev/null
+++ b/gnome-help/C/bluetooth-device-specific-pairing.page
@@ -0,0 +1,48 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
+      type="topic" style="question"
+      id="bluetooth-visibility">
+
+  <info>
+    <link type="guide" xref="bluetooth" group="#last"/>
+
+    <credit type="author">
+      <name>Bastien Nocera</name>
+      <email>hadess hadess net</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Whether other devices can discover your computer.</desc>
+  </info>
+
+  <title>Pairing instructions for specific devices</title>
+
+  <p>Even if you manage to source the manual for a device, it might not contain
+  enough information to make pairing possible. Here are details for a few common
+  devices.</p>
+
+  <terms>
+    <item>
+      <title>PlayStation 3 and 4 joypads</title>
+      <p>Those devices use “cable-pairing”. Plug the joypads in via USB with the
+      Bluetooth Settings opened, and Bluetooth turned on. You will get asked whether
+      to setup those joypads. Unplug them and press the PS button, to use them over
+      Bluetooth</p>
+    </item>
+    <item>
+      <title>PlayStation 3 BD Remote Control</title>
+      <p>Hold the “Start” and “Enter” buttons at the same time for around 5 seconds.
+      You can then select the remote in the devices list as usual.</p>
+    </item>
+    <item>
+      <title>Nintendo Wii and Wii U Remotes</title>
+      <p>Use the red “Sync” button inside the battery compartment to start the pairing
+      process. Other button combinations will not keep pairing information, so you would
+      need to do it all over again in short order. Also note that some software wants
+      direct access to the remotes, and, in those cases, you should not set them up in
+      the Bluetooth panel. Refer to the application's manual for instructions.</p>
+    </item>
+  </terms>
+
+</page>
diff --git a/gnome-help/C/bluetooth-visibility.page b/gnome-help/C/bluetooth-visibility.page
index b3b9239f..c06a4276 100644
--- a/gnome-help/C/bluetooth-visibility.page
+++ b/gnome-help/C/bluetooth-visibility.page
@@ -55,4 +55,13 @@
   neither your computer nor the device needs to be visible to communicate with
   each other.</p>
 
+  <p>Devices without a display usually have a pairing mode that can be entered
+  by pressing a button, or a combination of buttons for a while, whether when
+  they've already been turned on, or as they are being turned on.</p>
+
+  <p>The best way to find out how to enter that mode is to refer to the device's
+  manual. For some devices, the procedure might be
+  <link xref="bluetooth-device-specific-pairing">slightly different from usual</link>.
+  </p>
+
 </page>