diff options
author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2010-01-21 14:12:23 +0000 |
---|---|---|
committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2010-01-21 14:12:23 +0000 |
commit | 963007bb16b76e6ccbad082fef1184785349cada (patch) | |
tree | b2002ca7184507fa1e1af2e31364b89317a1d2d8 /spec/Client_Handler_Future.xml | |
parent | 5eacf345c57b919883db082ec2aad1609e8fa251 (diff) | |
download | telepathy-glib-963007bb16b76e6ccbad082fef1184785349cada.tar.gz |
Import telepathy-spec 0.19.0
Diffstat (limited to 'spec/Client_Handler_Future.xml')
-rw-r--r-- | spec/Client_Handler_Future.xml | 65 |
1 files changed, 65 insertions, 0 deletions
diff --git a/spec/Client_Handler_Future.xml b/spec/Client_Handler_Future.xml new file mode 100644 index 000000000..776fa4f3a --- /dev/null +++ b/spec/Client_Handler_Future.xml @@ -0,0 +1,65 @@ +<?xml version="1.0" ?> +<node name="/Client_Handler_Future" + xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0"> + <tp:copyright>Copyright © 2009 Collabora Ltd.</tp:copyright> + <tp:copyright>Copyright © 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.Client.Handler.FUTURE" + tp:causes-havoc="a staging area for future Handler functionality"> + <tp:requires interface="org.freedesktop.Telepathy.Client.Handler"/> + + <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.Client">Handler</tp:dbus-ref> + interface in future. It should be considered to + be conceptually part of the core Handler interface, but without + API or ABI guarantees.</p> + </tp:docstring> + + <property name="RelatedConferencesBypassApproval" + tp:name-for-bindings="Related_Conferences_Bypass_Approval" + type="b" access="read"> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>If true, channels destined for this handler that have the + <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface" + >Conference.DRAFT</tp:dbus-ref> interface, with a channel that + was previously handled by the same client process in their + <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Conference.DRAFT" + >InitialChannels</tp:dbus-ref> property, should bypass the + approval stage. In effect, this is a weaker form of + <tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler" + >BypassApproval</tp:dbus-ref>.</p> + + <tp:rationale> + <p>It would be reasonable for a user interface to accept + invitations to continuations of an existing channel automatically, + or not; this is a matter of UI policy.</p> + + <p>It's somewhat complex for an Approver to keep track of which + channels are being handled by a particular Handler, but + the Channel Dispatcher already has to track this, so it's + useful for the channel dispatcher to assist here.</p> + </tp:rationale> + </tp:docstring> + </property> + + </interface> +</node> +<!-- vim:set sw=2 sts=2 et ft=xml: --> |