From 84e53c868e09a632e6cbd2e7299d8c3da12e1630 Mon Sep 17 00:00:00 2001 From: Jonny Lamb Date: Thu, 17 Mar 2011 14:40:18 +0000 Subject: extensions: remove ContactCapabilities draft Signed-off-by: Jonny Lamb --- .../Connection_Interface_Contact_Capabilities.xml | 165 --------------------- extensions/Makefile.am | 1 - extensions/all.xml | 1 - 3 files changed, 167 deletions(-) delete mode 100644 extensions/Connection_Interface_Contact_Capabilities.xml (limited to 'extensions') diff --git a/extensions/Connection_Interface_Contact_Capabilities.xml b/extensions/Connection_Interface_Contact_Capabilities.xml deleted file mode 100644 index 13efba66..00000000 --- a/extensions/Connection_Interface_Contact_Capabilities.xml +++ /dev/null @@ -1,165 +0,0 @@ - - - Copyright (C) 2005, 2006, 2008 Collabora Limited - Copyright (C) 2005, 2006, 2008 Nokia Corporation - Copyright (C) 2006 INdT - -

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.

- -

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.

- -

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.

- - - - (as a draft) - - -

Contact capabilities describe the channel classes which may be - created with a given contact in advance of attempting to create a - channel. Each capability represents a commitment by the - connection manager that it will ordinarily be able to create a channel - with a contact when given a request with the properties defined by the - channel class.

- -

Capabilities pertain to particular contact handles, and represent - activities such as having a text chat, a voice call with the user or a - stream tube of a defined type.

- -

This interface also enables user interfaces to notify the connection - manager what capabilities to advertise for the user to other contacts. - This is done by using the - SetSelfCapabilities method, and deals - with channel property values pertaining to them which are implemented - by available client processes.

- - - - - - - An array of channel classes to replace to the list of what the - connection can handle. If you include optional properties, they - may not get advertised. The given properties are matched to the - mandatory properties. - - - -

Used by user interfaces to indicate which channel classes they are - able to handle on this connection. It replaces the previous advertised - channel classes by the set given as parameter.

- -

If a channel class is unknown by the connection manager, it is just - ignored. No error are returned in this case, and other known channel - class are added.

- -

Upon a successful invocation of this method, the - ContactCapabilitiesChanged signal - will only be emitted for the user's own - handle (as returned by GetSelfHandle) by the connection manager if, in - the given protocol, the given capabilities are distinct from the - previous state.

- - -

The connection manager will essentially intersect the provided - capabilities and the channel classes it implements. Therefore, - certain properties which are never fixed for a channel class - (such as the target handle, or the Parameters property of a tube - channel) will almost certainly not be advertised.

- - - - - - - - - - - - -

An array of contact handles for this connection.

- -

The handle zero MUST NOT be included in the request.

- - - - - - An array of structures containing: -
    -
  • a dictionary mapping the channel properties to their values.
    • -
  • an array of additional allowed properties
    • -
- - - - Returns an array of enhanced capabilities for the given contact handles. - - - - - - The handle does not represent a contact. Zero is always invalid. - - - - - - - - - All the capabilities of the contacts - - - -

Announce that there has been a change of capabilities on the - given handles. A single signal can be emitted for several - contacts.

- - -

The underlying protocol can get several contacts' capabilities at - the same time.

- - - - - - - A mapping from contact handle to their capabilities. - - - - A contact handle. - - - - - The contact capabilities. - - - - - - - diff --git a/extensions/Makefile.am b/extensions/Makefile.am index a8b5be22..2c9e1173 100644 --- a/extensions/Makefile.am +++ b/extensions/Makefile.am @@ -1,7 +1,6 @@ tools_dir = $(top_srcdir)/tools EXTRA_DIST = \ - Connection_Interface_Contact_Capabilities.xml \ OLPC_Buddy_Info.xml \ OLPC_Activity_Properties.xml \ connection.xml \ diff --git a/extensions/all.xml b/extensions/all.xml index 1a5a7eca..fda34981 100644 --- a/extensions/all.xml +++ b/extensions/all.xml @@ -23,7 +23,6 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

-