[gnome-user-docs] Add more details on how to pair devices via Bluetooth

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

commit 28f7ae2ae5569ab534b8531bd7f75f34d7e40115
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             | 10 +++++
 gnome-help/Makefile.am                             |  1 +
 3 files changed, 59 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..a164d112
--- /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-device-specific-pairing">
+
+  <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>How to pair specific devices with 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
+      <gui>Bluetooth Settings</gui> opened, and Bluetooth turned on. You will get asked whether
+      to set those joypads up. 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..17249666 100644
--- a/gnome-help/C/bluetooth-visibility.page
+++ b/gnome-help/C/bluetooth-visibility.page
@@ -5,6 +5,7 @@
 
   <info>
     <link type="guide" xref="bluetooth" group="#last"/>
+    <link type="seealso" xref="bluetooth-device-specific-pairing" />
 
     <revision pkgversion="3.4" date="2012-02-19" status="outdated"/>
     <revision pkgversion="3.10" date="2013-11-09" status="review"/>
@@ -55,4 +56,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>
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index 8cc841ce..278646a0 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -146,6 +146,7 @@ HELP_FILES = \
        backup-why.page \
        bluetooth.page \
        bluetooth-connect-device.page \
+       bluetooth-device-specific-pairing.page \
        bluetooth-problem-connecting.page \
        bluetooth-remove-connection.page \
        bluetooth-send-file.page \