[Telepathy-commits] [telepathy-gabble/master] add OLPC_Buddy.xml and OLPC_Buddy_View.xml to extensions

Guillaume Desmottes guillaume.desmottes at collabora.co.uk
Fri Sep 26 10:02:02 PDT 2008


20080520144753-7fe3f-244242b4aafe86bc27a25fec43c6d1ec6c6230d5.gz
---
 extensions/OLPC_Buddy.xml      |   71 ++++++++++++++++++++++++++++++++++++++++
 extensions/OLPC_Buddy_View.xml |   44 ++++++++++++++++++++++++
 extensions/all.xml             |    2 +
 3 files changed, 117 insertions(+), 0 deletions(-)
 create mode 100644 extensions/OLPC_Buddy.xml
 create mode 100644 extensions/OLPC_Buddy_View.xml

diff --git a/extensions/OLPC_Buddy.xml b/extensions/OLPC_Buddy.xml
new file mode 100644
index 0000000..660187d
--- /dev/null
+++ b/extensions/OLPC_Buddy.xml
@@ -0,0 +1,71 @@
+<?xml version="1.0" ?>
+<node name="/OLPC_Buddy" 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.Buddy">
+    <tp:requires interface="org.freedesktop.Telepathy.Connection"/>
+    <tp:requires interface="org.laptop.Telepathy.BuddyInfo"/>
+
+    <method name="SearchByProperties">
+      <arg direction="in" name="properties" type="a{sv}">
+        <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+          A buddy properties dictionary as described on
+          <code>org.laptop.Telepathy.BuddyInfo</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 buddies having the given properties.</p>
+        <p>Returns a <code>org.laptop.Telepathy.BuddyView</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 buddies 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 buddies.</p>
+        <p>Returns a <code>org.laptop.Telepathy.BuddyView</code> object representing the
+           random buddies returned.</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 buddies</p>
+    </tp:docstring>
+  </interface>
+</node>
+<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/extensions/OLPC_Buddy_View.xml b/extensions/OLPC_Buddy_View.xml
new file mode 100644
index 0000000..ab2b520
--- /dev/null
+++ b/extensions/OLPC_Buddy_View.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" ?>
+<node name="/OLPC_Buddy_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.BuddyView">
+    <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 a buddy search.</p>
+      <p>Buddies handles are stored using the
+        <code>org.freedesktop.Telepathy.Channel.Interface.Group</code> interface.</p>
+      <p>Buddy properties changes are notified on the Connection object using the
+        <code>org.laptop.Telepathy.BuddyInfo</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 c0507d4..8b93938 100644
--- a/extensions/all.xml
+++ b/extensions/all.xml
@@ -27,6 +27,8 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA</p>
 <xi:include href="Connection_Interface_Requests.xml"/>
 <xi:include href="OLPC_Buddy_Info.xml"/>
 <xi:include href="OLPC_Activity_Properties.xml"/>
+<xi:include href="OLPC_Buddy.xml"/>
+<xi:include href="OLPC_Buddy_View.xml"/>
 
 <tp:generic-types>
   <tp:external-type name="Contact_Handle" type="u"
-- 
1.5.6.5




More information about the Telepathy-commits mailing list