aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--extensions/Logger.xml114
1 files changed, 47 insertions, 67 deletions
diff --git a/extensions/Logger.xml b/extensions/Logger.xml
index a3778296d..cf5e067dc 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>