Prepare version 0.17.23telepathy-spec-0.17.23

7 files changed, 87 insertions, 13 deletions

diff --git a/NEWS b/NEWS
index 06692082..d5859053 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 456208d7..edf975e4 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 e912acf8..db0b657e 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 0dc8fa1a..1b0de983 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 b50650ec..2b03f964 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 f890621d..8a344d41 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 6923772d..93ce9253 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>