doc: Fix race conditions in service handling

diff --git a/doc/manager-api.txt b/doc/manager-api.txt
index 0edfad9..839f1b1 100644 (file)
--- a/doc/manager-api.txt
+++ b/doc/manager-api.txt
@@ -155,6 +155,25 @@ Signals            TechnologyAdded(object path, dict properties)
                        The object path is no longer accessible after this
                        signal and only emitted for reference.
 
                        The object path is no longer accessible after this
                        signal and only emitted for reference.
 

+               ServicesAdded(array{object, dict})
+
+                       List of service that have been added. The array
+                       is a list of services that is sorted with existing
+                       services containing an empty dictionary and new
+                       services containing the properties.
+
+                       This signal will only inform about added services
+                       and in case that services get added and removed at
+                       the same time, a ServicesRemoved signal will be
+                       sent first.
+
+               ServicesRemoved(array{object})
+
+                       Signals a list of services that are no longer valid.
+
+                       The object paths are no longer accessible after
+                       this signal and only emitted for reference.
+

                PropertyChanged(string name, variant value)
 
                        This signal indicates a changed value of the given
                PropertyChanged(string name, variant value)
 
                        This signal indicates a changed value of the given


@@ -183,22 +202,6 @@ Properties string State [readonly]
                        the limited usage of WiFi or Bluetooth devices might
                        be allowed in some situations.
 
                        the limited usage of WiFi or Bluetooth devices might
                        be allowed in some situations.
 

-               array{object} Services [readonly]
-
-                       List of service object paths. The list is sorted
-                       internally to have the service with the default
-                       route always first and then the favorite services
-                       followed by scan results.
-
-                       This list represents the available services for the
-                       current selected profile. If the profile gets changed
-                       then this list will be updated.
-
-                       The same list is available via the profile object
-                       itself. It is just provided here for convenience of
-                       applications only dealing with the current active
-                       profile.
-

                boolean SessionMode [readwrite]  [experminental]
 
                        This disables the auto connect feature. It should be
                boolean SessionMode [readwrite]  [experminental]
 
                        This disables the auto connect feature. It should be