[empathy/gnome-2-34] Update the Logger dbus API for the new version
- From: Emilio Pozuelo Monfort <epm src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [empathy/gnome-2-34] Update the Logger dbus API for the new version
- Date: Thu, 24 Feb 2011 15:52:42 +0000 (UTC)
commit 1310cf061af956a53983ec0a48257cca3c922d9b
Author: Emilio Pozuelo Monfort <emilio pozuelo collabora co uk>
Date: Thu Feb 24 13:46:11 2011 +0000
Update the Logger dbus API for the new version
extensions/Logger.xml | 114 ++++++++++++++++++++-----------------------------
1 files changed, 47 insertions(+), 67 deletions(-)
---
diff --git a/extensions/Logger.xml b/extensions/Logger.xml
index a377829..cf5e067 100644
--- a/extensions/Logger.xml
+++ b/extensions/Logger.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" ?>
<node name="/Logger"
xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
- <tp:copyright>Copyright © 2009 Collabora Ltd.</tp:copyright>
+ <tp:copyright>Copyright © 2009-2011 Collabora Ltd.</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
@@ -19,78 +19,13 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
</tp:license>
<interface name="org.freedesktop.Telepathy.Logger.DRAFT"
tp:causes-havoc="experimental">
- <tp:added version="0.1">(as a draft)</tp:added>
+ <tp:added version="0.3">(as a draft)</tp:added>
<tp:docstring>
An interface for requesting information from the Telepathy Logger
service.
</tp:docstring>
- <tp:struct name="Chat_Message" array-name="Chat_Message_List">
- <tp:member type="s" name="Sender">
- <tp:docstring>
- The identifier of the contact who originated this message.
- </tp:docstring>
- </tp:member>
-
- <tp:member type="s" name="Message">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- The body of the message sent to a 1-1 Chat or a Chat Room.
- </tp:docstring>
- </tp:member>
-
- <tp:member type="x" name="Timestamp" tp:type="Unix_Timestamp64">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- Unix timestamp for the log entry
- </tp:docstring>
- </tp:member>
-
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>It represents a single message, received or sent.</p>
- <p>The receiver is implicit in the request: if the sender is the user,
- the receiver is the identifier in chat_id paramenter, if the sender is
- not the user, the user is consequently the receiver of the message</p>
- </tp:docstring>
- </tp:struct>
-
- <method name="GetRecentMessages"
- tp:name-for-bindings="Get_Recent_Messages">
- <arg direction="in" name="Account" type="o" tp:type="Account">
- <tp:docstring>
- The account path for the TpAccount to which the conversation is related
- </tp:docstring>
- </arg>
-
- <arg direction="in" name="Identifier" type="s">
- <tp:docstring>
- The buddy's identifier for the conversation
- </tp:docstring>
- </arg>
-
- <arg direction="in" name="Is_Chatroom" type="b">
- <tp:docstring>
- Whether the conversation is a chatroom (i.e., XMPP MUC) or not
- </tp:docstring>
- </arg>
-
- <arg direction="in" name="Lines" type="u">
- <tp:docstring>
- how many entries will be returned.
-
- NOTE: to retreive information that would generate high traffic, use
- the library API approach instead of DBus.
- </tp:docstring>
- </arg>
-
- <arg direction="out" name="Messages" type="a(ssx)"
- tp:type="Chat_Message[]" />
-
- <tp:docstring>
- Request the last Lines entries of logs for the specified couple
- Account+Identifier.
- </tp:docstring>
- </method>
-
<method name="GetFavouriteContacts"
tp:name-for-bindings="Get_Favourite_Contacts">
<arg direction="out" name="Favourite_Contacts" type="a(oas)">
@@ -149,6 +84,51 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
</tp:docstring>
</method>
+ <method name="Clear"
+ tp:name-for-bindings="Clear">
+ <tp:docstring>
+ Clear all the logs. This will not erase the favourite contacts.
+ </tp:docstring>
+ </method>
+
+ <method name="ClearAccount"
+ tp:name-for-bindings="Clear_Account">
+ <arg direction="in" name="Account" type="o" tp:type="Account">
+ <tp:docstring>
+ The object path for the TpAccount in which logs will be cleared.
+ </tp:docstring>
+ </arg>
+
+ <tp:docstring>
+ Clear all logs stored for specified account.
+ </tp:docstring>
+ </method>
+
+ <method name="ClearEntity"
+ tp:name-for-bindings="Clear_Entity">
+ <arg direction="in" name="Account" type="o" tp:type="Account">
+ <tp:docstring>
+ The object path for the TpAccount in which logs will be cleared.
+ </tp:docstring>
+ </arg>
+
+ <arg direction="in" name="Identifier" type="s">
+ <tp:docstring>
+ The entity identifier.
+ </tp:docstring>
+ </arg>
+
+ <arg direction="in" name="Type" type="i">
+ <tp:docstring>
+ The entity type, should be one of TPL_ENTITY_CONTACT (1) or TPL_ENTITY_ROOM (2).
+ </tp:docstring>
+ </arg>
+
+ <tp:docstring>
+ Clear all logs stored for discussions with entity in account.
+ </tp:docstring>
+ </method>
+
<signal name="FavouriteContactsChanged"
tp:name-for-bindings="Favourite_Contacts_Changed">
<tp:docstring>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]