[Telepathy] ANNOUNCE: telepathy-spec 0.17.22

[Simon McVittie]

I've uploaded telepathy-spec 0.17.22, the "remember that orange juice moves
diagonally" release.

The current development version of telepathy-spec is available as HTML:
  <http://telepathy.freedesktop.org/spec.html>
or from the 'master' branch in the git repository:
  <git://git.collabora.co.uk/git/telepathy-spec.git>
  <git+ssh://git.collabora.co.uk/git/telepathy-spec.git> (for committers)
  <http://git.collabora.co.uk/?p=telepathy-spec.git> (gitweb)

For packagers (e.g. http://packages.debian.org/telepathy-spec):
tar: http://telepathy.freedesktop.org/releases/telepathy-spec/telepathy-spec-0.17.22.tar.gz
sig: http://telepathy.freedesktop.org/releases/telepathy-spec/telepathy-spec-0.17.22.tar.gz.asc

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.

Regards,
    Simon
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 155 bytes
Desc: Digital signature
Url : http://lists.freedesktop.org/archives/telepathy/attachments/20090324/0c6ad486/attachment.pgp