From 22171e223624ae93d06404cd4b6729204e3b5328 Mon Sep 17 00:00:00 2001
From: Guillaume Desmottes
Date: Mon, 16 Feb 2009 21:25:06 +0000
Subject: Upgrade to latest tube draft
From: Guillaume Desmottes
svn path=/trunk/; revision=2485
---
extensions/Channel_Interface_Tube.xml | 47 +++++++++++++++++++++++++----------
1 file changed, 34 insertions(+), 13 deletions(-)
(limited to 'extensions/Channel_Interface_Tube.xml')
diff --git a/extensions/Channel_Interface_Tube.xml b/extensions/Channel_Interface_Tube.xml
index 8e1ffab3a..8e6eb6514 100644
--- a/extensions/Channel_Interface_Tube.xml
+++ b/extensions/Channel_Interface_Tube.xml
@@ -1,7 +1,7 @@
- Copyright (C) 2008 Collabora Limited
- Copyright (C) 2008 Nokia Corporation
+ Copyright © 2008-2009 Collabora Limited
+ Copyright © 2008-2009 Nokia Corporation
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
@@ -38,10 +38,29 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
HANDLE_TYPE_CONTACT (for 1-1 communication) or of type
HANDLE_TYPE_ROOM (to communicate with others in the room
simultaneously).
+
+ As an exception to the usual handling of capabilities, connection managers
+ for protocols with capability discovery, such as XMPP, SHOULD advertise the
+ capability representing each Tube type that they support
+ (Channel.Type.DBusTube and/or
+ Channel.Type.StreamTube)
+ even if no client has indicated via
+ SetSelfCapabilities
+ that such a tube is supported.
+
+
+ To lower the barrier entry of new tube application, CM SHOULD accept to offer tubes of any
+ Service or
+ ServiceName
+ if the contact announced to support tubes.
+
+ access="read" tp:name-for-bindings="Parameters">
Each tube has a dictionary of arbitrary parameters. Parameters are
commonly used to bootstrap legacy protocols where you can't
@@ -58,21 +77,23 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
SRV (RFC 2782) Service Types
http://www.dns-sd.org/ServiceTypes.html):
{'u': 'username', 'p': 'password', 'path': 'path'}
- When requesting a channel with
+
When requesting a channel with
Connection.Interface.Requests.CreateChannel,
- this property MAY be included in the request. If it is not included in
- the request, the connection manager MUST consider the property to be
- empty. This property MAY be changed after the channel creation when
- the tube is in the state Not_Offered. If the tube is in another
- state, changing this property MUST fail without side effects.
+ this property MUST NOT be included in the request. This property is undefined until the tube is offered
+ (using OfferStreamTube
+ or OfferDBusTube).
+ Once it has been offered, this property MUST NOT change.
+ When receiving an incoming tube, this property is immutable and so advertised in the
+ Connection.Interface.Requests.NewChannels
+ signal.
-
+
- Status of the tube in this channel.
- When requesting a channel with
+
State of the tube in this channel.
+ When requesting a channel with
Connection.Interface.Requests.CreateChannel,
this property MUST NOT be included in the request.
--
cgit v1.2.3