doc: Clarifications on voice call behavior

diff --git a/doc/voicecall-api.txt b/doc/voicecall-api.txt
index 7eb41aa..fb8f099 100644 (file)
--- a/doc/voicecall-api.txt
+++ b/doc/voicecall-api.txt
@@ -47,6 +47,10 @@ Methods              dict GetProperties()
                        of a held multiparty call might not be possible on some
                        implementations.
 
+                       NOTE: Releasing active calls does not produce
+                       side-effects.  That is the state of held or waiting
+                       calls is not affected.
+
                        Possible Errors: [service].Error.InProgress
                                         [service].Error.Failed
                                         [service].Error.NotImplemented

diff --git a/doc/voicecallmanager-api.txt b/doc/voicecallmanager-api.txt
index bd38229..56dba8b 100644 (file)
--- a/doc/voicecallmanager-api.txt
+++ b/doc/voicecallmanager-api.txt
@@ -35,6 +35,10 @@ Methods              dict GetProperties()
 
                        This is usually implemented using the ATD AT command.
 
+                       NOTE: If an active call (single or multiparty) exists,
+                       then it is automatically put on hold if the dial
+                       procedure is successful.
+
                        Possible Errors: [service].Error.InProgress
                                         [service].Error.InvalidArguments
                                         [service].Error.InvalidFormat
@@ -102,7 +106,8 @@ Methods             dict GetProperties()
 
                void HangupAll()
 
-                       Releases all calls.
+                       Releases all calls except waiting calls. This includes
+                       multiparty calls.
 
                         Possible Errors: [service].Error.InProgress
                                         [service].Error.NotImplemented