summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJoão Paulo Rechi Vita <jprvita@openbossa.org>2012-02-27 17:54:40 -0300
committerJoão Paulo Rechi Vita <jprvita@openbossa.org>2012-02-27 17:54:40 -0300
commit0e262e596d1159af13689b1b0c9d267f3d226284 (patch)
tree90833ca4663bb893bdb0a2850b33f9bee1ae27dd
parentd1a1df1e2e441ff9175a7255060971157f795897 (diff)
downloadbluez-le-docs-0e262e596d1159af13689b1b0c9d267f3d226284.tar.gz
bluez-le-docs-0e262e596d1159af13689b1b0c9d267f3d226284.tar.xz
bluez-le-docs-0e262e596d1159af13689b1b0c9d267f3d226284.zip
howto: swap order of paragraphs in simple-agent explanation
Explain first how to pair with a specific remote device and later how to register the agent to handle incoming pairing requests. This seems to make the text more clear.
-rw-r--r--howto.tex33
1 files changed, 17 insertions, 16 deletions
diff --git a/howto.tex b/howto.tex
index 5142ccc..8509a87 100644
--- a/howto.tex
+++ b/howto.tex
@@ -356,22 +356,8 @@ The \verb|simple-agent| is a script that acts as an UI agent for Bluetooth
adapters, handling \verb|bluetoothd| requests for UI actions, like presenting a
PIN prompt and similar operations.
-Registering an agent to handle incoming pairing requests, on {\em hciX} ({\em
-hciX} should be changed with the correct adapter name):
-
-\begin{verbatim}
-$ simple-agent hciX
-\end{verbatim}
-
-If it all works, the message {\em Agent registered} will be printed on the
-console. Note that the agent doesn't set the adapter as {\em Discoverable} or
-{\em Connectable}, this should be done via the MGMT interface.
-
-Pairing can now be started on the remote device and \verb|simple-agent| will
-ask for the PIN code, if needed. After entering it followed by Enter, if no
-error occurs, the device will be paired with the adapter it is handling.
-
-To start pairing with a specific device:
+To start pairing with a specific device ({\em hciX} should be changed with the
+correct adapter name):
\begin{verbatim}
$ simple-agent hciX <device address>
@@ -385,6 +371,21 @@ The default value is {\em KeyboardDisplay}, and other possible values are {\em
DisplayOnly}, {\em DisplayYesNo}, {\em KeyboardOnly}, and {\em
NoInputNoOutput}.
+It's also possible to register an agent to handle UI operations of incoming
+pairing requests:
+
+\begin{verbatim}
+$ simple-agent hciX
+\end{verbatim}
+
+If it all works, the message {\em Agent registered} will be printed on the
+console. Note that the agent doesn't set the adapter as {\em Discoverable} or
+{\em Connectable}, this should be done via the MGMT interface.
+
+Pairing can now be started on the remote device and \verb|simple-agent| will
+ask for the PIN code, if needed. After entering it followed by Enter, if no
+error occurs, the device will be paired with the adapter it is handling.
+
\subsubsection{Managing paired devices}