[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