add OLPC_Activity.xml and OLPC_Activity_View.xml to extensions

20080521101941-7fe3f-9bb9c8a7037c57def95ca6c0ff334427686698aa.gz

3 files changed, 138 insertions, 0 deletions

diff --git a/extensions/OLPC_Activity.xml b/extensions/OLPC_Activity.xml
new file mode 100644
index 000000000..506a5e337
--- /dev/null
+++ b/extensions/OLPC_Activity.xml
@@ -0,0 +1,92 @@
+<?xml version="1.0" ?>
+<node name="/OLPC_Activity" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
+  <tp:copyright> Copyright (C) 2008 Collabora Limited </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 St, Fifth Floor, Boston, MA  02110-1301  USA</p>
+  </tp:license>
+  <interface name="org.laptop.Telepathy.Activity">
+    <tp:requires interface="org.freedesktop.Telepathy.Connection"/>
+    <tp:requires interface="org.laptop.Telepathy.ActivityProperties"/>
+
+    <method name="SearchByProperties">
+      <arg direction="in" name="properties" type="a{sv}">
+        <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+          An activity properties dictionary as described on
+          <code>org.laptop.Telepathy.ActivityProperties</code>.
+        </tp:docstring>
+      </arg>
+      <arg direction="out" name="view" type="o">
+        <tp:docstring>
+          The D-Bus object path for the view created 
+        </tp:docstring>
+      </arg>
+      <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+        <p>Search for activities having the given properties.</p>
+        <p>Returns a <code>org.laptop.Telepathy.ActivityView</code> object representing the
+           result of the search.</p>
+      </tp:docstring>
+      <tp:possible-errors>
+        <tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument"/>
+      </tp:possible-errors>
+    </method>
+
+    <method name="RequestRandom">
+      <arg direction="in" name="max" type="u">
+         <tp:docstring>
+          The maximum of random activities to look for.
+        </tp:docstring>
+      </arg>
+      <arg direction="out" name="view" type="o">
+        <tp:docstring>
+          The D-Bus object path for the view created 
+        </tp:docstring>
+      </arg>
+      <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+        <p>Request random activities.</p>
+        <p>Returns a <code>org.laptop.Telepathy.ActivityView</code> object representing the
+           random activities returned.</p>
+      </tp:docstring>
+      <tp:possible-errors>
+        <tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument"/>
+      </tp:possible-errors>
+    </method>
+
+    <method name="SearchByParticipants">
+      <arg direction="in" name="participants" type="a(u)">
+         <tp:docstring>
+          The handles of the participants
+        </tp:docstring>
+      </arg>
+      <arg direction="out" name="view" type="o">
+        <tp:docstring>
+          The D-Bus object path for the view created 
+        </tp:docstring>
+      </arg>
+      <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+        <p>Search for activities having the given participants.</p>
+        <p>Returns a <code>org.laptop.Telepathy.ActivityView</code> object representing the
+           result of the search.</p>
+      </tp:docstring>
+      <tp:possible-errors>
+        <tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument"/>
+      </tp:possible-errors>
+    </method>
+
+    <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+      <p>An interface on connections to search and request activities</p>
+    </tp:docstring>
+  </interface>
+</node>
+<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/extensions/OLPC_Activity_View.xml b/extensions/OLPC_Activity_View.xml
new file mode 100644
index 000000000..2731a1993
--- /dev/null
+++ b/extensions/OLPC_Activity_View.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" ?>
+<node name="/OLPC_Activity_View" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
+  <tp:copyright> Copyright (C) 2008 Collabora Limited </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 St, Fifth Floor, Boston, MA  02110-1301  USA</p>
+  </tp:license>
+  <interface name="org.laptop.Telepathy.ActivityView">
+    <tp:requires interface="org.freedesktop.Telepathy.Channel.Interface.Group"/>
+
+    <method name="Close">
+      <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+        <p>Close the view so we won't receive notifications about its
+          result anymore. Method calls on the view are no longer valid after
+          this call, and the connection manager may remove the object from
+          the bus at any point.</p>
+      </tp:docstring>
+      <tp:possible-errors>
+        <tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument"/>
+      </tp:possible-errors>
+    </method>
+
+    <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+      <p>An object representing the result of an activity search.</p>
+      <p>Activities room handles are stored using the
+        <code>org.freedesktop.Telepathy.Channel.Interface.Group</code> interface.</p>
+      <p>Activity properties changes are notified on the Connection object using the
+        <code>org.laptop.Telepathy.ActivityProperties</code> interface while the view object
+        is alive.</p>
+    </tp:docstring>
+  </interface>
+</node>
+<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/extensions/all.xml b/extensions/all.xml
index 8b93938ba..599cb114a 100644
--- a/extensions/all.xml
+++ b/extensions/all.xml
@@ -29,6 +29,8 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA</p>
 <xi:include href="OLPC_Activity_Properties.xml"/>
 <xi:include href="OLPC_Buddy.xml"/>
 <xi:include href="OLPC_Buddy_View.xml"/>
+<xi:include href="OLPC_Activity.xml"/>
+<xi:include href="OLPC_Activity_View.xml"/>
 
 <tp:generic-types>
   <tp:external-type name="Contact_Handle" type="u"