Remove obsolete file.

[connman] / doc / manager-api.txt

diff --git a/doc/manager-api.txt b/doc/manager-api.txt
index 7ebfa89..7f1924e 100644 (file)
--- a/doc/manager-api.txt
+++ b/doc/manager-api.txt
@@ -22,6 +22,29 @@ Methods              dict GetProperties()
                        Possible Errors: [service].Error.InvalidArguments
                                         [service].Error.DoesNotExist
 
+               object AddProfile(string name)
+
+                       Add a new profile with the specified name.
+
+                       It is possible to create two profiles with the same
+                       name. The identification is done via the object path
+                       and not the name of the profile.
+
+                       Possible Errors: [service].Error.InvalidArguments
+
+               void RemoveProfile(object path)
+
+                       Remove profile with specified object path.
+
+                       It is not possible to remove the current active
+                       profile. To remove the active profile a different
+                       one must be selected via ActiveProfile property
+                       first.
+
+                       At minimum one profile must be available all the time.
+
+                       Possible Errors: [service].Error.InvalidArguments
+
                void RegisterAgent(object path)
 
                        Register new agent for handling user requests.
@@ -39,25 +62,54 @@ Signals             PropertyChanged(string name, variant value)
                        This signal indicates a changed value of the given
                        property.
 
+               StateChanged(string state)
+
+                       This signal is similar to the PropertyChanged signal
+                       for the State property.
+
+                       It exists for application state only care about the
+                       current state and so can avoid to be woken up when
+                       other details changes.
+
 Properties     string State [readonly]
 
                        The global connection state of a system. Possible
                        values are "online" if at least one connection exists
                        and "offline" if no device is connected.
 
-               boolean FlightMode [readwrite]
+                       In certain situations the state might change to
+                       the value "connected". This can only be seen if
+                       previously no connection was present.
+
+               string Policy [readwrite]
+
+                       The global connection policy of a system. This
+                       allows to configure how connections are established
+                       and also when they are taken down again.
+
+                       Possible values are "single", "multiple" and "ask".
+
+                       For the single policy, the priority setting of the
+                       device defines which becomes the default connection
+                       when multiple are available.
+
+               boolean OfflineMode [readwrite]
 
-                       The flight mode indicates the global setting for
-                       switching all radios on or off. Changing flight mode
+                       The offline mode indicates the global setting for
+                       switching all radios on or off. Changing offline mode
                        to true results in powering down all devices. When
-                       leaving flight mode the individual policy of each
+                       leaving offline mode the individual policy of each
                        device decides to switch the radio back on or not.
 
-                       During flight mode, it is still possible to switch
+                       During offline mode, it is still possible to switch
                        certain technologies manually back on. For example
                        the limited usage of WiFi or Bluetooth devices might
                        be allowed in some situations.
 
+               object ActiveProfile [readwrite]
+
+                       Object path of the current active profile.
+
                array{object} Profiles [readonly]
 
                        List of profile object paths.
@@ -66,6 +118,22 @@ Properties  string State [readonly]
 
                        List of device object paths.
 
+               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.
+
                array{object} Connections [readonly]
 
                        List of active connection object paths.