[Telepathy-commits] [telepathy-spec/master] Add initial versions of ChannelDispatcher, ChannelDispatch

[Simon McVittie]

20080602175940-53eee-08e94db959cddc866d681f0fe8f68f707e0b88f5.gz
---
 spec/Channel_Dispatch.xml   |   40 ++++++++++++++++++++++++++++
 spec/Channel_Dispatcher.xml |   61 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 101 insertions(+), 0 deletions(-)
 create mode 100644 spec/Channel_Dispatch.xml
 create mode 100644 spec/Channel_Dispatcher.xml

diff --git a/spec/Channel_Dispatch.xml b/spec/Channel_Dispatch.xml
new file mode 100644
index 0000000..286a291
--- /dev/null
+++ b/spec/Channel_Dispatch.xml
@@ -0,0 +1,40 @@
+<?xml version="1.0" ?>
+<node name="/Channel_Dispatch"
+  xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
+  <tp:copyright>Copyright (C) 2008 Collabora Ltd.</tp:copyright>
+  <tp:copyright>Copyright (C) 2008 Nokia Corporation</tp:copyright>
+  <tp:license xmlns="http://www.w3.org/1999/xhtml">
+<p>This library is free software; you can redistribute it and/or
+modify it under the terms of the GNU Lesser General Public
+License as published by the Free Software Foundation; either
+version 2.1 of the License, or (at your option) any later version.</p>
+
+<p>This library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+Lesser General Public License for more details.</p>
+
+<p>You should have received a copy of the GNU Lesser General Public
+License along with this library; if not, write to the Free Software
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+</p>
+  </tp:license>
+  <interface name="org.freedesktop.Telepathy.ChannelDispatch.DRAFT"
+    tp:causes-havoc="experimental">
+    <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+      <p>A channel dispatch is an object in the Channel Dispatcher
+        representing a bundle of channels being announced to client
+        processes.</p>
+    </tp:docstring>
+
+    <property name="Interfaces" type="as" access="read"
+      tp:type="DBus_Interface[]">
+      <tp:docstring>
+        A list of the extra interfaces provided by this channel dispatch
+        operation.
+      </tp:docstring>
+    </property>
+
+  </interface>
+</node>
+<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/spec/Channel_Dispatcher.xml b/spec/Channel_Dispatcher.xml
new file mode 100644
index 0000000..98a7396
--- /dev/null
+++ b/spec/Channel_Dispatcher.xml
@@ -0,0 +1,61 @@
+<?xml version="1.0" ?>
+<node name="/Channel_Dispatcher"
+  xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
+  <tp:copyright>Copyright (C) 2008 Collabora Ltd.</tp:copyright>
+  <tp:copyright>Copyright (C) 2008 Nokia Corporation</tp:copyright>
+  <tp:license xmlns="http://www.w3.org/1999/xhtml">
+<p>This library is free software; you can redistribute it and/or
+modify it under the terms of the GNU Lesser General Public
+License as published by the Free Software Foundation; either
+version 2.1 of the License, or (at your option) any later version.</p>
+
+<p>This library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+Lesser General Public License for more details.</p>
+
+<p>You should have received a copy of the GNU Lesser General Public
+License along with this library; if not, write to the Free Software
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+</p>
+  </tp:license>
+  <interface name="org.freedesktop.Telepathy.ChannelDispatcher.DRAFT"
+    tp:causes-havoc="experimental">
+    <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+      <p>...</p>
+    </tp:docstring>
+
+    <property name="Interfaces" type="as" access="read"
+      tp:type="DBus_Interface[]">
+      <tp:docstring>
+        A list of the extra interfaces provided by this channel dispatcher.
+      </tp:docstring>
+    </property>
+
+    <property name="Dispatch_Operations" type="ao" access="read">
+      <tp:docstring>
+        The list of ChannelDispatch objects currently being processed.
+        Change notification is via the NewDispatch and DispatchFinished
+        signals.
+      </tp:docstring>
+    </property>
+
+    <signal name="NewDispatch">
+      <arg name="Dispatch" type="o">
+      </arg>
+
+      <!-- FIXME: copy the Channel_Announcement_Flags from
+      Connection.Interface.Requests? -->
+
+      <arg name="Channels" type="a(oa{sv})" tp:type="Channel_Details[]">
+      </arg>
+    </signal>
+
+    <signal name="DispatchFinished">
+      <arg name="Dispatch" type="o">
+      </arg>
+    </signal>
+
+  </interface>
+</node>
+<!-- vim:set sw=2 sts=2 et ft=xml: -->
-- 
1.5.6.5