core: Add initial Device.Pair() implementation

This will ultimately replace Adapter.CreatePairedDevice()

1 files changed, 18 insertions, 0 deletions

diff --git a/doc/device-api.txt b/doc/device-api.txt
index 71abb294..104ec176 100644
--- a/doc/device-api.txt
+++ b/doc/device-api.txt
@@ -106,6 +106,24 @@ Methods		dict GetProperties()
 			Possible errors: org.bluez.Error.DoesNotExist
 					 org.bluez.Error.NotConnected
 
+		void Pair(object agent, string capability)
+
+			This method will connect to the remote device,
+			initiate pairing and then retrieve all SDP records
+			(or GATT primary services).
+
+			The agent object path is assumed to reside within the
+			process (D-Bus connection instance) that calls this
+			method. No separate registration procedure is needed
+			for it and it gets automatically released once the
+			pairing operation is complete.
+
+			The capability parameter is the same as for the
+			Adapter.RegisterAgent method.
+
+			Possible errors: org.bluez.Error.InvalidArguments
+					 org.bluez.Error.Failed
+
 Signals		PropertyChanged(string name, variant value)
 
 			This signal indicates a changed value of the given