Add some extra comments for IPv4 and nameserver configuration

diff --git a/doc/service-api.txt b/doc/service-api.txt
index 149e9d7..79ac93c 100644 (file)
--- a/doc/service-api.txt
+++ b/doc/service-api.txt
@@ -300,6 +300,11 @@ Properties string State [readonly]
                        nameservers are configured, then it is useful
                        to configure this setting.
 
+                       Changes to the domain name servers can be done
+                       at any time. It will not cause a disconnect of
+                       the service. However there might be small window
+                       where name resolution might fail.
+
                array{string} Domains [readonly]
 
                        The list of currently used search domains.
@@ -333,6 +338,11 @@ Properties string State [readonly]
                        the actual system configuration while this allows
                        user configuration.
 
+                       Changing these settings will cause a state change
+                       of the service. The service will become unavailable
+                       until the new configuration has been successfully
+                       installed.
+
                dict Proxy [readonly]
 
                        string Method [readonly]