Mention to set D-Bus timeout for service connect methods

diff --git a/doc/manager-api.txt b/doc/manager-api.txt
index a68cb48..ff675b3 100644 (file)
--- a/doc/manager-api.txt
+++ b/doc/manager-api.txt
@@ -82,6 +82,11 @@ Methods              dict GetProperties()
                        same as executing the Connect method from the
                        service interface.
 
+                       This method call will only return in case of an
+                       error or when the service is fully connected. So
+                       setting a longer D-Bus timeout might be a really
+                       good idea.
+
                        Possible Errors: [service].Error.InvalidArguments
 
                void RegisterAgent(object path)

diff --git a/doc/service-api.txt b/doc/service-api.txt
index e9349fc..ea725b5 100644 (file)
--- a/doc/service-api.txt
+++ b/doc/service-api.txt
@@ -40,6 +40,11 @@ Methods              dict GetProperties()
                        automatically. If no cable is plugged in this method
                        will fail.
 
+                       This method call will only return in case of an
+                       error or when the service is fully connected. So
+                       setting a longer D-Bus timeout might be a really
+                       good idea.
+
                        Possible Errors: [service].Error.InvalidArguments
 
                void Disconnect()