[telepathy-spec/master] Prepare version 0.17.23
Simon McVittie
simon.mcvittie at collabora.co.uk
Tue Apr 21 07:02:11 PDT 2009
---
NEWS | 78 +++++++++++++++++++++++++++++++-
spec/Channel_Handler.xml | 2 +-
spec/Channel_Type_Streamed_Media.xml | 4 +-
spec/Client_Interface_Requests.xml | 2 +-
spec/Connection.xml | 10 ++--
spec/Connection_Interface_Presence.xml | 2 +-
spec/all.xml | 2 +-
7 files changed, 87 insertions(+), 13 deletions(-)
diff --git a/NEWS b/NEWS
index 0669208..d585905 100644
--- a/NEWS
+++ b/NEWS
@@ -2,10 +2,84 @@ This file contains the same edited highlights as the announcement emails.
For full details, see the ChangeLog in tarballs, or "git log" in Git
checkouts.
-telepathy-spec 0.17.23 (UNRELEASED)
+telepathy-spec 0.17.23 (2009-04-21)
===================================
-...
+The "the future is mandatory" release.
+
+Changes to stable API:
+
+* fd.o #14620: Connection.Connect is defined to be idempotent, matching what
+ has always been implemented in practice. (smcv)
+
+* All Connections must implement the Requests and Contacts interfaces, which
+ are no longer considered optional. RequestChannel, ListChannels and listening
+ for NewChannel are now deprecated. (smcv)
+
+* All Connections that implement the deprecated Presence interface must also
+ implement the non-deprecated SimplePresence interface; clients should not
+ attempt to support the old Presence interface. (smcv)
+
+Changes to experimental API:
+
+* fd.o #21148: ChannelDispatcher, ChannelDispatchOperation, ChannelRequest,
+ Client, Observer, Approver and Handler are considered to be a little less
+ experimental. We don't yet recommend generating bindings for them in stable
+ libraries, but hopefully they won't change much more now. Accordingly,
+ the .DRAFT suffix has been removed. (smcv)
+
+* fd.o #21180: Handler: added an a{sv} parameter to HandleChannels for future
+ expansion. (smcv)
+
+* fd.o #20908: Observer: added a Requests_Satisfied parameter to
+ ObserveChannels. (smcv)
+
+* fd.o #21093: Approver: altered AddDispatchOperation to pass the channels as
+ a top-level argument, since the Channels property of the CDO is mutable (smcv)
+
+* fd.o #21176: Handler: moved request notification to a new
+ Client.Interface.Requests interface. (smcv)
+
+Additions to stable API:
+
+* CreateChannel and EnsureChannel may raise Offline. (wjt)
+
+* fd.o #21109: added a Terminated error; Group change reason None is either
+ Terminated or Cancelled, depending on the actor. (smcv)
+
+* fd.o #20920: StreamedMedia: RequestStreams may raise NotImplemented and
+ NotCapable, and should prefer them over InvalidArgument and NotAvailable.
+ (smcv)
+
+* fd.o #20920: Group: AddMember may raise NotCapable. (smcv)
+
+* Accounts have a HasBeenOnline property. (smcv)
+
+Additions to experimental API:
+
+* fd.o #21013: ChannelRequest: added a PreferredHandler property. (smcv)
+
+* fd.o #21180: ChannelRequest: added an Interfaces property. (smcv)
+
+Clarifications:
+
+* fd.o #21090: Approver: AddDispatchOperation is called for all channel
+ dispatch operations where at least of the channels matches the filter. (smcv)
+
+* fd.o #21089: Observer: ObserveChannels only sees channels that match the
+ filter. (smcv)
+
+* fd.o #21112: FileTransfer: clarified how RequestableChannelClasses and
+ ContentHashType relate. (wjt)
+
+* fd.o #21179: added some recommendations for a high-quality channel dispatcher implementation. (smcv)
+
+Tools:
+
+* The new-style (multi-page) HTML output has a devhelp index and various
+ visual improvements. (davyd, wjt)
+
+* The new-style HTML spec is uploaded correctly. (smcv, wjt)
telepathy-spec 0.17.22 (2009-03-24)
===================================
diff --git a/spec/Channel_Handler.xml b/spec/Channel_Handler.xml
index 456208d..edf975e 100644
--- a/spec/Channel_Handler.xml
+++ b/spec/Channel_Handler.xml
@@ -17,7 +17,7 @@ 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.ChannelHandler">
- <tp:deprecated version="0.17.UNRELEASED">
+ <tp:deprecated version="0.17.23">
Clients should implement <tp:dbus-ref
namespace="org.freedesktop.Telepathy">Client.Handler</tp:dbus-ref>
instead.
diff --git a/spec/Channel_Type_Streamed_Media.xml b/spec/Channel_Type_Streamed_Media.xml
index e912acf..db0b657 100644
--- a/spec/Channel_Type_Streamed_Media.xml
+++ b/spec/Channel_Type_Streamed_Media.xml
@@ -260,7 +260,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
<tp:error name="org.freedesktop.Telepathy.Error.NotImplemented">
<tp:docstring>
A stream type given is not implemented by the connection manager.
- Since 0.17.UNRELEASED, connection managers SHOULD raise this error
+ Since 0.17.23, connection managers SHOULD raise this error
in preference to InvalidArgument.
<tp:rationale>
Connection managers can't know whether an unknown number
@@ -279,7 +279,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
<tp:error name="org.freedesktop.Telepathy.Error.NotCapable">
<tp:docstring>
That contact's client does not implement one of the given stream
- types. Since 0.17.UNRELEASED, connection managers SHOULD raise
+ types. Since 0.17.23, connection managers SHOULD raise
this in preference to NotAvailable.
</tp:docstring>
</tp:error>
diff --git a/spec/Client_Interface_Requests.xml b/spec/Client_Interface_Requests.xml
index 0dc8fa1..1b0de98 100644
--- a/spec/Client_Interface_Requests.xml
+++ b/spec/Client_Interface_Requests.xml
@@ -22,7 +22,7 @@
<interface name="org.freedesktop.Telepathy.Client.Interface.Requests"
tp:causes-havoc="not yet final">
- <tp:added version="0.17.UNRELEASED">(as a draft; functionality
+ <tp:added version="0.17.23">(as a draft; functionality
moved from Handler)</tp:added>
<tp:requires interface="org.freedesktop.Telepathy.Client"/>
diff --git a/spec/Connection.xml b/spec/Connection.xml
index b50650e..2b03f96 100644
--- a/spec/Connection.xml
+++ b/spec/Connection.xml
@@ -26,7 +26,7 @@ USA.</p>
<tp:requires interface="org.freedesktop.Telepathy.Connection.Interface.Contacts"/>
<tp:struct name="Channel_Info" array-name="Channel_Info_List">
- <tp:deprecated version="0.17.UNRELEASED"/>
+ <tp:deprecated version="0.17.23"/>
<tp:docstring>A struct representing a channel, as returned by
ListChannels on the Connection interface.</tp:docstring>
<tp:member type="o" name="Channel">
@@ -272,7 +272,7 @@ USA.</p>
</method>
<method name="ListChannels" tp:name-for-bindings="List_Channels">
- <tp:deprecated version="0.17.UNRELEASED">Use the
+ <tp:deprecated version="0.17.23">Use the
<tp:dbus-ref
namespace="org.freedesktop.Telepathy.Connection.Interface">Requests.Channels</tp:dbus-ref>
property instead.
@@ -295,7 +295,7 @@ USA.</p>
</method>
<signal name="NewChannel" tp:name-for-bindings="New_Channel">
- <tp:deprecated version="0.17.UNRELEASED">Connection managers MUST still
+ <tp:deprecated version="0.17.23">Connection managers MUST still
emit this signal, but clients SHOULD listen for the <tp:dbus-ref
namespace="org.freedesktop.Telepathy.Connection.Interface">Requests.NewChannels</tp:dbus-ref>
signal instead.
@@ -393,7 +393,7 @@ USA.</p>
</method>
<method name="RequestChannel" tp:name-for-bindings="Request_Channel">
- <tp:deprecated version="0.17.UNRELEASED">Use
+ <tp:deprecated version="0.17.23">Use
<tp:dbus-ref
namespace="org.freedesktop.Telepathy.Connection.Interface">Requests.CreateChannel</tp:dbus-ref>
or <tp:dbus-ref
@@ -1034,7 +1034,7 @@ USA.</p>
Connection bus names/object paths to have exactly 7
components.</tp:changed>
- <tp:changed version="0.17.UNRELEASED">The Requests and Contacts interfaces
+ <tp:changed version="0.17.23">The Requests and Contacts interfaces
are now mandatory. Their functionality will be merged into the main
Connection interface at some point in future.</tp:changed>
diff --git a/spec/Connection_Interface_Presence.xml b/spec/Connection_Interface_Presence.xml
index f890621..8a344d4 100644
--- a/spec/Connection_Interface_Presence.xml
+++ b/spec/Connection_Interface_Presence.xml
@@ -286,7 +286,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
SHOULD use <tp:dbus-ref
namespace="org.freedesktop.Telepathy.Connection.Interface">SimplePresence</tp:dbus-ref>
instead.</tp:deprecated>
- <tp:changed version="0.17.UNRELEASED">Connection managers implementing
+ <tp:changed version="0.17.23">Connection managers implementing
Presence MUST implement SimplePresence too.</tp:changed>
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
diff --git a/spec/all.xml b/spec/all.xml
index 6923772..93ce925 100644
--- a/spec/all.xml
+++ b/spec/all.xml
@@ -3,7 +3,7 @@
xmlns:xi="http://www.w3.org/2001/XInclude">
<tp:title>Telepathy D-Bus Interface Specification</tp:title>
-<tp:version>0.17.22.1</tp:version>
+<tp:version>0.17.23</tp:version>
<tp:copyright>Copyright © 2005-2009 Collabora Limited</tp:copyright>
<tp:copyright>Copyright © 2005-2009 Nokia Corporation</tp:copyright>
--
1.5.6.5
More information about the telepathy-commits
mailing list