summaryrefslogtreecommitdiff
path: root/qt4/spec/Channel_Request_Future.xml
diff options
context:
space:
mode:
Diffstat (limited to 'qt4/spec/Channel_Request_Future.xml')
-rw-r--r--qt4/spec/Channel_Request_Future.xml98
1 files changed, 0 insertions, 98 deletions
diff --git a/qt4/spec/Channel_Request_Future.xml b/qt4/spec/Channel_Request_Future.xml
deleted file mode 100644
index d75c7e0ce..000000000
--- a/qt4/spec/Channel_Request_Future.xml
+++ /dev/null
@@ -1,98 +0,0 @@
-<?xml version="1.0" ?>
-<node name="/Channel_Request_Future"
- xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
- <tp:copyright>Copyright © 2008-2010 Collabora Ltd.</tp:copyright>
- <tp:copyright>Copyright © 2008-2009 Nokia Corporation</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.ChannelRequest.FUTURE"
- tp:causes-havoc="a staging area for future Channel functionality">
-
- <tp:requires interface="org.freedesktop.Telepathy.ChannelRequest"/>
-
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>This interface contains functionality which we intend to incorporate
- into the <tp:dbus-ref
- namespace="org.freedesktop.Telepathy">ChannelRequest</tp:dbus-ref>
- interface in future. It should be considered to
- be conceptually part of the core ChannelRequest interface, but without
- API or ABI guarantees.</p>
- </tp:docstring>
-
- <property name="Hints" tp:name-for-bindings="Hints"
- type="a{sv}" access="read">
- <tp:added version="0.19.12">(as draft)</tp:added>
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>A dictionary of metadata provided by the channel
- requester, which the handler and other clients MAY choose to
- interpret. Currently no standard keys are defined; clients MAY
- choose to use platform-specific keys for their own purposes, but MUST
- ignore unknown keys and MUST cope with expected keys being
- missing.</p>
-
- <tp:rationale>This property might be used to pass a contact ID for a
- telephone number shared between two contacts from the address book to
- the call UI, so that if you try to call “Mum”, the call UI knows this
- rather than having to guess or show “Calling Mum or Dad”. The format
- of these contact IDs would be platform-specific, so we leave the
- definition of the dictionary entry up to the platform in question.
- But third-party channel requesters might not include the contact ID,
- so the call UI has to be able to deal with it not being
- there.</tp:rationale>
-
- <p>The channel dispatcher will not interpret these hints: they are
- solely for communication between cooperating clients.</p>
-
- <tp:rationale>
- <p>Any extra parameters that do affect the channel dispatcher should
- be designed separately.</p>
- </tp:rationale>
-
- <p>This property may be set when the channel request is created, and
- can never change. Since it is immutable, it SHOULD be included in the
- dictionary of properties passed to <tp:dbus-ref
- namespace="ofdT.Client.Interface.Requests">AddRequest</tp:dbus-ref>
- by the <tp:dbus-ref
- namespace="org.freedesktop.Telepathy">ChannelDispatcher</tp:dbus-ref>.</p>
- </tp:docstring>
- </property>
-
- <signal name="SucceededWithChannel" tp:name-for-bindings="Succeeded_With_Channel">
- <tp:added version="0.19.12">(as draft)</tp:added>
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Variant of the <tp:dbus-ref
- namespace="ofdT.ChannelRequest">Succeeded</tp:dbus-ref> signal
- allowing to get the channel which has been created.</p>
- </tp:docstring>
-
- <arg name="Connection" type="o">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The Connection owning the channel.</p>
- </tp:docstring>
- </arg>
-
- <arg name="Channel" type="o">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The channel which has been created.</p>
- </tp:docstring>
- </arg>
-
- </signal>
-
- </interface>
-</node>
-<!-- vim:set sw=2 sts=2 et ft=xml: -->