Update the Logger dbus API for the new version

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>