[telepathy-spec/master] Observer: whether ObserveChannels succeeds or fails is irrelevant

Simon McVittie simon.mcvittie at collabora.co.uk
Thu Apr 9 11:21:41 PDT 2009


---
 spec/Client_Observer.xml |   11 +++++++++++
 1 files changed, 11 insertions(+), 0 deletions(-)

diff --git a/spec/Client_Observer.xml b/spec/Client_Observer.xml
index da59cb6..1271694 100644
--- a/spec/Client_Observer.xml
+++ b/spec/Client_Observer.xml
@@ -209,6 +209,17 @@ org.freedesktop.Telepathy.Channel.Requested b=true
             channel handler starts up faster and acknowledges messages,
             logger never sees those messages.</p>
         </tp:rationale>
+
+        <p>The channel dispatcher SHOULD NOT change its behaviour based on
+          whether this method succeeds or fails: there are no defined D-Bus
+          errors for this method, and if it fails, this only indicates that
+          an Observer is somehow broken.</p>
+
+        <tp:rationale>
+          <p>The expected error response in the channel dispatcher is to
+            log a warning, and otherwise continue as though this method
+            had succeeded.</p>
+        </tp:rationale>
       </tp:docstring>
 
       <arg name="Account" type="o" direction="in">
-- 
1.5.6.5



More information about the telepathy-commits mailing list