[Telepathy-commits] [telepathy-spec/master] Add a skeletal API to ChannelDispatch

[Simon McVittie]

20080602182216-53eee-6237d1e6dfc5fa6ddc36e0d2366f13cabbe2e9fa.gz
---
 spec/Channel_Dispatch.xml |   50 +++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 50 insertions(+), 0 deletions(-)

diff --git a/spec/Channel_Dispatch.xml b/spec/Channel_Dispatch.xml
index 286a291..7fdf642 100644
--- a/spec/Channel_Dispatch.xml
+++ b/spec/Channel_Dispatch.xml
@@ -35,6 +35,56 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
       </tp:docstring>
     </property>
 
+    <method name="Reject">
+      <tp:docstring>
+        Called by an approver to reject a channel bundle. The channel
+        dispatcher should close the channels. If successful, this method
+        will cause the ChannelDispatch object to disappear, causing the
+        ChannelDispatcher to emit DispatchCompleted.
+        However, this method may fail because the dispatch has already been
+        completed and the object has already gone.
+      </tp:docstring>
+
+      <tp:possible-errors>
+        <!-- FIXME -->
+      </tp:possible-errors>
+    </method>
+
+    <method name="HandleWith">
+      <tp:docstring>
+        Called by an approver to accept a channel bundle and request that
+        the given handler be used to handle it. If successful, this method
+        will cause the ChannelDispatch object to disappear, causing the
+        ChannelDispatcher to emit DispatchCompleted.
+        However, this method may fail because the dispatch has already been
+        completed and the object has already gone.
+      </tp:docstring>
+
+      <arg direction="in" type="s" tp:type="DBus_Bus_Name" name="Handler">
+      </arg>
+
+      <tp:possible-errors>
+        <!-- FIXME -->
+      </tp:possible-errors>
+    </method>
+
+    <method name="Claim">
+      <tp:docstring>
+        Called by an approver to accept a channel bundle and request that
+        the approver be allowed to handle the channel internally (for cases
+        where the approver and the desired handler are the same process).
+        If successful, this method will cause the ChannelDispatch object to
+        disappear, causing the ChannelDispatcher to emit DispatchCompleted.
+        However, this method may fail because the dispatch has already been
+        completed and the object has already gone - if this occurs, the
+        approver MUST NOT proceed to handle the channel internally.
+      </tp:docstring>
+
+      <tp:possible-errors>
+        <!-- FIXME -->
+      </tp:possible-errors>
+    </method>
+
   </interface>
 </node>
 <!-- vim:set sw=2 sts=2 et ft=xml: -->
-- 
1.5.6.5