adapter-api: Document per-client discovery sessions

The fact that each client can start its own discovery wasn't clear from
the documentation and only becomes obvious when reading the sources.

Signed-off-by: Manika Shrivastava <manika.sh@samsung.com>
Signed-off-by: Ayush Garg <ayush.garg@samsung.com>

diff --git a/doc/adapter-api.txt b/doc/adapter-api.txt
index 552a97c..811ff49 100755 (executable)
--- a/doc/adapter-api.txt
+++ b/doc/adapter-api.txt
@@ -21,6 +21,9 @@ Methods               void StartDiscovery()
 
                        During discovery RSSI delta-threshold is imposed.
 
+                       Each client can request a single device discovery session
+                       per adapter.
+
                        Possible errors: org.bluez.Error.NotReady
                                         org.bluez.Error.Failed
                                         org.bluez.Error.InProgress
@@ -32,7 +35,8 @@ Methods               void StartDiscovery()
 
                        Note that a discovery procedure is shared between all
                        discovery sessions thus calling StopDiscovery will only
-                       release a single session.
+                       release a single session and discovery will stop when
+                       all sessions from all clients have finished.
 
                        Possible errors: org.bluez.Error.NotReady
                                         org.bluez.Error.Failed