From 5ece0fd90c64c8e26515d37c398c49475d9bd7de Mon Sep 17 00:00:00 2001
From: Jonny Lamb <jonny.lamb@collabora.co.uk>
Date: Thu, 27 Oct 2011 14:20:14 +0100
Subject: extensions: add Chan.I.FileTransfer.Metadata draft interface

Signed-off-by: Jonny Lamb <jonny.lamb@collabora.co.uk>
---
 .../Channel_Interface_File_Transfer_Metadata.xml   | 71 ++++++++++++++++++++++
 extensions/Makefile.am                             |  1 +
 extensions/all.xml                                 |  3 +
 3 files changed, 75 insertions(+)
 create mode 100644 extensions/Channel_Interface_File_Transfer_Metadata.xml

(limited to 'extensions')

diff --git a/extensions/Channel_Interface_File_Transfer_Metadata.xml b/extensions/Channel_Interface_File_Transfer_Metadata.xml
new file mode 100644
index 00000000..ea42332d
--- /dev/null
+++ b/extensions/Channel_Interface_File_Transfer_Metadata.xml
@@ -0,0 +1,71 @@
+<?xml version="1.0" ?>
+<node name="/Channel_Interface_File_Transfer_Metadata"
+  xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
+  <tp:copyright>Copyright (C) 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
+      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 Street, Fifth Floor, Boston, MA 02110-1301,
+      USA.</p>
+  </tp:license>
+
+  <interface
+    name="org.freedesktop.Telepathy.Channel.Interface.FileTransfer.Metadata">
+    <tp:requires interface="org.freedesktop.Telepathy.Channel.Type.FileTransfer"/>
+    <tp:added version="0.24.UNRELEASED"/>
+
+    <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+      <p>This interface exists to provide a mechanism to include
+        arbitrary additional information in file transfers. For
+        example, one might want to send a document and include the
+        number of times the character P appeared in the file, so would
+        add <tt>NumberOfPs=42</tt> to the
+        <tp:member-ref>Metadata</tp:member-ref> property.</p>
+
+      <p><tp:member-ref>ServiceName</tp:member-ref> living in its own
+        property makes it easier for specific applications to send
+        files to each other, bypassing the standard handler. For
+        example, the Banshee Telepathy plugin handler could match on
+        <tp:member-ref>ServiceName</tp:member-ref> so the Empathy file
+        transfer is not used instead.</p>
+   </tp:docstring>
+
+    <property name="ServiceName" tp:name-for-bindings="Service_Name"
+      type="s" access="readwrite" tp:immutable="sì"
+      tp:requestable="naturalmente">
+      <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+        <p>A string representing the service name that will be used
+          over the file transfer channel. This property is equivalent
+          to the <tp:dbus-ref
+            namespace="ofdT">Channel.Type.DBusTube.ServiceName</tp:dbus-ref>
+          and <tp:dbus-ref
+            namespace="ofdT">Channel.Type.StreamTube.Service</tp:dbus-ref>
+          properties. If no service name is given then this property
+          will be the empty string.</p>
+      </tp:docstring>
+    </property>
+
+    <property name="Metadata" tp:name-for-bindings="Metadata"
+      type="a{ss}" tp:type="String_String_Map" access="readwrite"
+      tp:immutable="sì" tp:requestable="naturalmente">
+      <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+        <p>Additional information about the file transfer set by the
+          channel initiator. If no additional information is given then
+          this property will be empty.</p>
+      </tp:docstring>
+    </property>
+
+  </interface>
+</node>
+<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/extensions/Makefile.am b/extensions/Makefile.am
index de6c2566..2a4dbdc4 100644
--- a/extensions/Makefile.am
+++ b/extensions/Makefile.am
@@ -6,6 +6,7 @@ EXTRA_DIST = \
     connection.xml \
     Salut_Plugin_Test.xml \
     Connection_Future.xml \
+    Channel_Interface_File_Transfer_Metadata.xml \
     all.xml
 
 noinst_LTLIBRARIES = libsalut-extensions.la
diff --git a/extensions/all.xml b/extensions/all.xml
index 59586e7c..73132972 100644
--- a/extensions/all.xml
+++ b/extensions/all.xml
@@ -25,6 +25,7 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA</p>
 <xi:include href="connection.xml"/>
 <xi:include href="Salut_Plugin_Test.xml"/>
 <xi:include href="Connection_Future.xml"/>
+<xi:include href="Channel_Interface_File_Transfer_Metadata.xml"/>
 
 <tp:generic-types>
   <tp:external-type name="Contact_Handle" type="u"
@@ -43,6 +44,8 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA</p>
     from="Telepathy specification"/>
   <tp:external-type name="String_Variant_Map" type="a{sv}"
     from="Telepathy specification"/>
+  <tp:external-type name="String_String_Map" type="a{ss}"
+    from="Telepathy specification"/>
  <tp:external-type name="Unix_Timestamp64" type="t"
     from="Telepathy specification"/>
   <tp:external-type name="Requestable_Channel_Class" type="a(a{sv}as)"
-- 
cgit v1.2.1