Prepare release 0.17.22telepathy-spec-0.17.22

6 files changed, 83 insertions, 19 deletions

diff --git a/NEWS b/NEWS
index 29bf5ac2..90a2a861 100644
--- a/NEWS
+++ b/NEWS
@@ -2,9 +2,73 @@ 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.22 (UNRELEASED)
+telepathy-spec 0.17.22 (2009-03-24)
 ===================================
 
+The "remember that orange juice moves diagonally" release.
+
+API changes:
+
+* fd.o #20772: the implicit direction and state of new StreamedMedia streams
+  has been clarified in a possibly incompatible way: CMs need to emit extra
+  signals whenever a stream is added with state != Disconnected,
+  direction != Receive or pending-send != Pending_Local_Send
+
+* Reverted a change to RequestStreams that claimed that it should be
+  idempotent, and explicitly documented the opposite
+
+Changes to experimental API:
+
+* In MediaSignalling.FUTURE, GoogleP2PTransportAvailable is now
+  GTalkP2PTransportAvailable to be consistent with 'gtalk-p2p' NATTraversal,
+  MSNTransportAvailable is now WLM85TransportAvailable, and
+  WLM2009TransportAvailable has been added
+
+* In MediaSignalling.FUTURE and StreamedMedia.FUTURE, removed strange fallback
+  behaviour if no clients have any of the relevant capabilities, because
+  clients wouldn't be able to rely on it
+
+* In ContactSearch, extend the state machine to support paged searches, and
+  rethink how paged/limited searches work
+
+New API:
+
+* fd.o #19558: Media.StreamHandler has new NATTraversal, STUNServers,
+  CreatedLocally and RelayInfo properties which can be used to select
+  a transport, and used by the transport to traverse NATs
+
+* Media.StreamHandler documents two more NAT traversal methods, wlm-8.5 and
+  wlm-2009
+
+* Avatars now exposes avatar requirements as properties, and adds recommended
+  sizes
+
+Deprecations:
+
+* MediaSignalling's nat-traversal, stun-server and stun-port Telepathy
+  properties are deprecated in favour of per-stream D-Bus properties
+
+* The 'stun' value for NATTraversal and nat-traversal is deprecated; 'none'
+  and 'stun' should behave identically
+
+Clarifications:
+
+* StreamedMedia: clarified that removing all streams may close the channel,
+  but that that isn't how clients should terminate calls
+
+* StreamedMedia: documented and recommended Gabble's behaviour, which is that
+  accepting calls automatically accepts the proposed direction for all streams
+
+Tools:
+
+* fd.o #20771: telepathy-spec now contains a new parser written in Python,
+  and a new HTML rendering that uses it. Code generation tools will hopefully
+  migrate to this parser in future.
+
+  For the moment, both the old XSLT-generated HTML (one big file) and the
+  new Python-generated HTML (multiple pages) are generated by telepathy-spec's
+  Makefile.
+
 telepathy-spec 0.17.21 (2009-03-17)
 ===================================
 
diff --git a/spec/Channel_Interface_Media_Signalling.xml b/spec/Channel_Interface_Media_Signalling.xml
index cace04ff..5c293164 100644
--- a/spec/Channel_Interface_Media_Signalling.xml
+++ b/spec/Channel_Interface_Media_Signalling.xml
@@ -105,7 +105,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     </signal>
 
     <tp:property name="nat-traversal" type="s">
-      <tp:deprecated version="0.17.UNRELEASED">Use the <tp:dbus-ref
+      <tp:deprecated version="0.17.22">Use the <tp:dbus-ref
           namespace="org.freedesktop.Telepathy.Media.StreamHandler">NATTraversal</tp:dbus-ref>
         property on the Media.StreamHandler, if available; use this
         as a fallback.</tp:deprecated>
@@ -119,7 +119,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     </tp:property>
 
     <tp:property name="stun-server" type="s">
-      <tp:deprecated version="0.17.UNRELEASED">Use the <tp:dbus-ref
+      <tp:deprecated version="0.17.22">Use the <tp:dbus-ref
           namespace="org.freedesktop.Telepathy.Media.StreamHandler">STUNServers</tp:dbus-ref>
         property on the Media.StreamHandler, if available; use this
         as a fallback.</tp:deprecated>
@@ -130,7 +130,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     </tp:property>
 
     <tp:property name="stun-port" type="q">
-      <tp:deprecated version="0.17.UNRELEASED">Use the <tp:dbus-ref
+      <tp:deprecated version="0.17.22">Use the <tp:dbus-ref
           namespace="org.freedesktop.Telepathy.Media.StreamHandler">STUNServers</tp:dbus-ref>
         property on the Media.StreamHandler, if available; use this
         as a fallback.</tp:deprecated>
@@ -140,7 +140,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     </tp:property>
 
     <tp:property name="gtalk-p2p-relay-token" type="s">
-      <tp:deprecated version="0.17.UNRELEASED">XMPP connection managers
+      <tp:deprecated version="0.17.22">XMPP connection managers
         supporting the Google Talk relay server SHOULD make the necessary
         HTTP requests to find a username and password, and use those
         to populate the <tp:dbus-ref
diff --git a/spec/Channel_Type_Streamed_Media.xml b/spec/Channel_Type_Streamed_Media.xml
index 2020b86a..c4ddea7a 100644
--- a/spec/Channel_Type_Streamed_Media.xml
+++ b/spec/Channel_Type_Streamed_Media.xml
@@ -292,7 +292,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
 
         <tp:rationale>
           <p>Historically, it was not clear from the StreamAdded signal what
-            the state of the stream was. telepathy-spec 0.17.UNRELEASED
+            the state of the stream was. telepathy-spec 0.17.22
             clarified this.</p>
         </tp:rationale>
 
diff --git a/spec/Connection_Interface_Avatars.xml b/spec/Connection_Interface_Avatars.xml
index 96ae69fc..e6f7ac59 100644
--- a/spec/Connection_Interface_Avatars.xml
+++ b/spec/Connection_Interface_Avatars.xml
@@ -128,7 +128,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     <property name="SupportedAvatarMIMETypes"
       tp:name-for-bindings="Supported_Avatar_MIME_Types"
       type="as" access="read">
-      <tp:added version="0.17.UNRELEASED">Fall back to calling
+      <tp:added version="0.17.22">Fall back to calling
         <tp:member-ref>GetAvatarRequirements</tp:member-ref> if getting this
           property fails.</tp:added>
       <tp:docstring>
@@ -142,7 +142,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     <property name="MinimumAvatarHeight"
       tp:name-for-bindings="Minimum_Avatar_Height"
       type="u" access="read">
-      <tp:added version="0.17.UNRELEASED">Fall back to calling
+      <tp:added version="0.17.22">Fall back to calling
         <tp:member-ref>GetAvatarRequirements</tp:member-ref> if getting this
           property fails.</tp:added>
       <tp:docstring>
@@ -156,7 +156,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     <property name="MinimumAvatarWidth"
       tp:name-for-bindings="Minimum_Avatar_Width"
       type="u" access="read">
-      <tp:added version="0.17.UNRELEASED">Fall back to calling
+      <tp:added version="0.17.22">Fall back to calling
         <tp:member-ref>GetAvatarRequirements</tp:member-ref> if getting this
           property fails.</tp:added>
       <tp:docstring>
@@ -170,7 +170,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     <property name="RecommendedAvatarHeight"
       tp:name-for-bindings="Recommended_Avatar_Height"
       type="u" access="read">
-      <tp:added version="0.17.UNRELEASED"/>
+      <tp:added version="0.17.22"/>
       <tp:docstring>
         The recommended height in pixels of an avatar on this protocol, or 0 if
         there is no preferred height.
@@ -189,7 +189,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     <property name="RecommendedAvatarWidth"
       tp:name-for-bindings="Recommended_Avatar_Width"
       type="u" access="read">
-      <tp:added version="0.17.UNRELEASED"/>
+      <tp:added version="0.17.22"/>
       <tp:docstring>
         The recommended width in pixels of an avatar on this protocol, or 0 if
         there is no preferred width.
@@ -206,7 +206,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     <property name="MaximumAvatarHeight"
       tp:name-for-bindings="Maximum_Avatar_Height"
       type="u" access="read">
-      <tp:added version="0.17.UNRELEASED">Fall back to calling
+      <tp:added version="0.17.22">Fall back to calling
         <tp:member-ref>GetAvatarRequirements</tp:member-ref> if getting this
           property fails.</tp:added>
       <tp:docstring>
@@ -220,7 +220,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     <property name="MaximumAvatarWidth"
       tp:name-for-bindings="Maximum_Avatar_Width"
       type="u" access="read">
-      <tp:added version="0.17.UNRELEASED">Fall back to calling
+      <tp:added version="0.17.22">Fall back to calling
         <tp:member-ref>GetAvatarRequirements</tp:member-ref> if getting this
           property fails.</tp:added>
       <tp:docstring>
@@ -234,7 +234,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     <property name="MaximumAvatarBytes"
       tp:name-for-bindings="Maximum_Avatar_Bytes"
       type="u" access="read">
-      <tp:added version="0.17.UNRELEASED">Fall back to calling
+      <tp:added version="0.17.22">Fall back to calling
         <tp:member-ref>GetAvatarRequirements</tp:member-ref> if getting this
           property fails.</tp:added>
       <tp:docstring>
@@ -247,7 +247,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
 
     <method name="GetAvatarRequirements"
       tp:name-for-bindings="Get_Avatar_Requirements">
-      <tp:deprecated version="0.17.UNRELEASED">Use GetAll to retrieve the
+      <tp:deprecated version="0.17.22">Use GetAll to retrieve the
         D-Bus properties on this interface, falling back to this method
         on failure.</tp:deprecated>
       <arg direction="out" type="as" name="MIME_Types">
diff --git a/spec/Media_Stream_Handler.xml b/spec/Media_Stream_Handler.xml
index b4a11a10..d335e385 100644
--- a/spec/Media_Stream_Handler.xml
+++ b/spec/Media_Stream_Handler.xml
@@ -72,7 +72,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
 
     <property name="STUNServers" tp:name-for-bindings="STUN_Servers"
       type="a(sq)" tp:type="Socket_Address_IP[]" access="read">
-      <tp:added version="0.17.UNRELEASED"/>
+      <tp:added version="0.17.22"/>
       <tp:docstring>
         The IP addresses of possible STUN servers to use for NAT traversal, as
         dotted-quad IPv4 address literals or RFC2373 IPv6 address literals.
@@ -90,7 +90,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
 
     <property name="CreatedLocally" tp:name-for-bindings="Created_Locally"
       type="b" access="read">
-      <tp:added version="0.17.UNRELEASED"/>
+      <tp:added version="0.17.22"/>
       <tp:docstring>
         True if we were the creator of this stream, false otherwise.
         <tp:rationale>
@@ -102,7 +102,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
 
     <property name="NATTraversal" tp:name-for-bindings="NAT_Traversal"
       type="s" access="read">
-      <tp:added version="0.17.UNRELEASED"/>
+      <tp:added version="0.17.22"/>
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
         <p>The transport (NAT traversal technique) to be used for this
           stream. Well-known values include:</p>
diff --git a/spec/all.xml b/spec/all.xml
index a76d025c..952ff6b0 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.21.1</tp:version>
+<tp:version>0.17.22</tp:version>
 
 <tp:copyright>Copyright © 2005-2009 Collabora Limited</tp:copyright>
 <tp:copyright>Copyright © 2005-2009 Nokia Corporation</tp:copyright>