[Telepathy-commits] [telepathy-spec/master] Prepare release 0.17.22
Simon McVittie
simon.mcvittie at collabora.co.uk
Tue Mar 24 11:51:29 PDT 2009
---
NEWS | 66 ++++++++++++++++++++++++++-
spec/Channel_Interface_Media_Signalling.xml | 8 ++--
spec/Channel_Type_Streamed_Media.xml | 2 +-
spec/Connection_Interface_Avatars.xml | 18 ++++----
spec/Media_Stream_Handler.xml | 6 +-
spec/all.xml | 2 +-
6 files changed, 83 insertions(+), 19 deletions(-)
diff --git a/NEWS b/NEWS
index 29bf5ac..90a2a86 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 cace04f..5c29316 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 2020b86..c4ddea7 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 96ae69f..e6f7ac5 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 b4a11a1..d335e38 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 a76d025..952ff6b 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>
--
1.5.6.5
More information about the telepathy-commits
mailing list