Additional fixes to multiline responses

[connman] / doc / service-api.txt

diff --git a/doc/service-api.txt b/doc/service-api.txt
index 25c4631..ab1aa34 100644 (file)
--- a/doc/service-api.txt
+++ b/doc/service-api.txt
@@ -12,6 +12,66 @@ Methods              dict GetProperties()
 
                        Possible Errors: [service].Error.InvalidArguments
 
 
                        Possible Errors: [service].Error.InvalidArguments
 

+               void Connect()
+
+                       Connect this service. It will attempt to connect
+                       WiFi, WiMAX or Bluetooth services.
+
+                       For Ethernet devices this method can only be used
+                       if it has previously been disconnected. Otherwise
+                       the plugging of a cable will trigger connecting
+                       automatically. If no cable is plugged in this method
+                       will fail.
+
+                       Possible Errors: [service].Error.InvalidArguments
+
+               void Disconnect()
+
+                       Disconnect this service. If the service is not
+                       connected an error message will be generated.
+
+                       On Ethernet devices this will disconnect the IP
+                       details from the service. It will not magically
+                       unplug the cable. When no cable is plugged in this
+                       method will fail.
+
+                       Possible Errors: [service].Error.InvalidArguments
+
+               void Remove()
+
+                       A successfully connected service with Favorite=true
+                       can be removed this way. If it is connected, it will
+                       be automatically disconnected first.
+
+                       This is similar to setting the Favorite property
+                       to false, but that is currently not supported.
+
+                       Calling this method on Ethernet devices will cause
+                       an error message. It is not possible to remove these
+                       kind of devices.
+
+                       Possible Errors: [service].Error.InvalidArguments
+
+               void MoveBefore(object service)
+
+                       If a service has been used before, this allows a
+                       reorder of the favorite services.
+
+                       The target service object must be part of this
+                       profile. Moving between profiles is not supported.
+
+                       Possible Errors: [service].Error.InvalidArguments
+
+               void MoveAfter(object service)
+
+                       If a service has been used before, this allows a
+                       reorder of the favorite services.
+
+                       The target service object must be part of this
+                       profile. Moving between profiles is not supported.
+
+                       Possible Errors: [service].Error.InvalidArguments
+

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

@@ -21,6 +81,9 @@ Properties    string State [readonly]
 
                        The service state information.
 
 
                        The service state information.
 

+                       Valid states are "idle", "failure", "association",
+                       "configuration" and "ready".
+

                string Name [readonly]
 
                        The service name (for example "Wireless" etc.)
                string Name [readonly]
 
                        The service name (for example "Wireless" etc.)

@@ -28,6 +91,9 @@ Properties    string State [readonly]
                        This name can be used for directly displaying it in
                        the application. It has pure informational purpose.
 
                        This name can be used for directly displaying it in
                        the application. It has pure informational purpose.
 

+                       For Ethernet devices and hidden WiFi networks  it is
+                       not guaranteed that this property is present.
+

                string Type [readonly]
 
                        The service type (for example "ethernet", "wifi" etc.)
                string Type [readonly]
 
                        The service type (for example "ethernet", "wifi" etc.)

@@ -42,15 +108,42 @@ Properties string State [readonly]
                        present and contains the mode of the network. The
                        possible values are "managed" or "adhoc".
 
                        present and contains the mode of the network. The
                        possible values are "managed" or "adhoc".
 

+                       This property might be only present for WiFi
+                       services.
+

                string Security [readonly]
 
                        If the service type is WiFi, then this property is
                        present and contains the security method or key
                        management setting.
 
                string Security [readonly]
 
                        If the service type is WiFi, then this property is
                        present and contains the security method or key
                        management setting.
 

-                       Possible values are "none", "wep", "wpa" and "wpa2".
+                       Possible values are "none", "wep", "wpa" and "rsn".
+
+                       This property might be only present for WiFi
+                       services.
+
+               string Passphrase [readwrite]
+
+                       If the service type is WiFi, then this property
+                       can be used to store a passphrase.
+
+                       This property is still experimental and might be
+                       removed in future version.

 
                uint8 Strength [readonly]
 
                        Indicates the signal strength of the service. This
                        is a normalized value between 0 and 100.
 
                uint8 Strength [readonly]
 
                        Indicates the signal strength of the service. This
                        is a normalized value between 0 and 100.

+
+                       This property will not be present for Ethernet
+                       devices.
+
+               boolean Favorite [readonly]
+
+                       Will be true if a cable is plugged in or the user
+                       selected and successfully connected to this service.
+
+                       Setting this property to true has no effect at all
+                       and setting it to false is similar to the Remove()
+                       method. So for now it will be considered a read
+                       only property.