Update the Nameservers and Domains property description

1 files changed, 29 insertions, 2 deletions

diff --git a/doc/service-api.txt b/doc/service-api.txt
index e488d7af..149e9d73 100644
--- a/doc/service-api.txt
+++ b/doc/service-api.txt
@@ -271,13 +271,40 @@ Properties	string State [readonly]
 			indicates connections to a foreign provider when
 			traveling abroad.
 
-		array{string} Nameservers [readwrite]
+		array{string} Nameservers [readonly]
+
+			The list of currently active nameservers for this
+			service. If the server is not in READY, LOGIN or
+			ONLINE state than this list will be empty.
+
+			Global nameservers are automatically added to this
+			list. The array represents a sorted list of the
+			current nameservers. The first one has the highest
+			priority and is used by default.
+
+			When using DHCP this array represents the nameservers
+			provided by the network. In case of manual settings,
+			the ones from Nameservers.Configuration are used.
+
+		array{string} Nameservers.Configuration [readwrite]
 
 			The list of manually configured domain name
 			servers. Some 3G networks don't provide correct
 			name servers and this allows for an override.
 
-		array{string} Domains [readwrite]
+			This array is sorted by priority and the first
+			entry in the list represents the nameserver with
+			the highest priority.
+
+			When using manual configuration and no global
+			nameservers are configured, then it is useful
+			to configure this setting.
+
+		array{string} Domains [readonly]
+
+			The list of currently used search domains.
+
+		array{string} Domains.Configuration [readwrite]
 
 			The list of manually configured search domains.